FreeTube项目中的播放列表导出功能技术解析

在开源视频播放器FreeTube中，用户经常需要将播放列表导出以便在其他工具中使用。本文将深入分析这一功能的技术实现方案，并探讨几种实用的导出方法。

播放列表数据存储结构

FreeTube将用户创建的播放列表以JSON格式存储在特定位置：

• Windows系统：%APPDATA%\FreeTube\playlists.db
• 其他系统：~/.config/FreeTube/playlists.db

该文件采用每行一个JSON对象的形式存储多个播放列表，每个对象包含以下关键字段：

• playlistName：播放列表名称
• videos：视频数组
• lastUpdatedAt：最后更新时间戳

每个视频对象包含：

• videoId：YouTube视频ID
• title：视频标题
• author：作者名称
• lengthSeconds：视频时长(秒)
• timeAdded：添加到列表的时间戳

Python脚本导出方案

一个实用的Python脚本可以实现两种导出格式：

1. URL列表格式：简单的每行一个YouTube视频链接
2. CSV格式：包含视频ID、标题、作者、时长和添加时间的详细表格

脚本核心功能包括：

• 自动检测系统平台确定数据库路径
• 支持播放列表名称模糊匹配
• 可选的标题清理功能(去除"Official Video"等后缀)
• 时间戳转换为易读格式

使用示例：

# 列出所有播放列表
./export-playlist.py

# 导出特定播放列表的URL
./export-playlist.py --list 电子技术

# 导出为CSV格式
./export-playlist.py --list 电子技术 --csv

使用jq工具处理JSON数据

对于熟悉命令行的用户，jq工具提供了更灵活的JSON数据处理能力：

1. 列出所有播放列表名称：

jq '.playlistName' playlists.db

2. 导出特定播放列表URL：

jq --raw-output 'select(.playlistName == "音乐").videos[] | "https://youtu.be/" + .videoId' playlists.db

3. 导出为CSV格式：

jq --raw-output 'select(.playlistName == "音乐").videos[] | [.videoId, .title, .author, .lengthSeconds, (.timeAdded / 1000 | todate)] | @csv' playlists.db

4. 交互式选择播放列表(需安装fzf)：

jq '.playlistName' playlists.db | fzf | xargs -I '@' jq --raw-output 'select(.playlistName == "@").videos[] | "https://youtu.be/" + .videoId' playlists.db

技术选型建议

对于不同用户场景，推荐以下方案：

1. 普通用户：使用Python脚本，提供友好的命令行界面和预设输出格式
2. 高级用户：使用jq工具，灵活处理各种自定义输出需求
3. 开发者：可以考虑扩展FreeTube原生功能，添加右键菜单直接复制播放列表URL

值得注意的是，虽然FreeTube官方认为这是一个小众需求，但通过外部工具的组合使用，用户仍然能够方便地实现播放列表导出功能，满足各种使用场景的需求。