get_iplayer 技术文档

1. 安装指南

系统要求

• 操作系统: Linux/BSD (Ubuntu, Fedora, OpenBSD 等), macOS (10.10+), Windows (7/8/10)
• Perl 版本: 5.16 及以上
• 依赖模块: LWP, LWP::Protocol::https, XML::LibXML, Mojolicious, CGI
• 其他工具: ffmpeg (用于转换为 MP4), AtomicParsley (用于元数据标签)

安装步骤

1. 安装 Perl 和依赖模块:

   • 在 Linux/BSD 系统上，使用包管理器安装 Perl 和相关模块。例如，在 Ubuntu 上：

     sudo apt-get install perl libwww-perl libxml-libxml-perl libmojolicious-perl
     

   • 在 macOS 上，使用 Homebrew 安装 Perl 和相关模块：

     brew install perl
     cpan LWP LWP::Protocol::https XML::LibXML Mojolicious CGI
     

   • 在 Windows 上，使用 Strawberry Perl 安装 Perl 和相关模块：

     cpan LWP LWP::Protocol::https XML::LibXML Mojolicious CGI
     

2. 安装 ffmpeg 和 AtomicParsley:

   • 在 Linux/BSD 系统上，使用包管理器安装：

     sudo apt-get install ffmpeg atomicparsley
     

   • 在 macOS 上，使用 Homebrew 安装：

     brew install ffmpeg atomicparsley
     

   • 在 Windows 上，从官方网站下载并安装 ffmpeg 和 AtomicParsley。

3. 下载并安装 get_iplayer:

   • 从 GitHub 仓库下载最新版本的 get_iplayer：

     git clone https://github.com/get-iplayer/get_iplayer.git
     cd get_iplayer
     perl get_iplayer --install
     

2. 项目使用说明

基本命令

• 查看帮助信息:

  get_iplayer --help
  get_iplayer --basic-help
  get_iplayer --long-help
  

示例

• 列出所有电视节目:

  get_iplayer ".*"
  

• 列出所有电视节目并显示详细描述:

  get_iplayer --long ".*"
  

• 列出所有广播节目:

  get_iplayer --type=radio ".*"
  

• 列出名称中包含 "doctor who" 的电视节目:

  get_iplayer "doctor who"
  

• 列出名称中包含 "doctor who" 的电视和广播节目:

  get_iplayer --type tv,radio "doctor who"
  

• 列出 BBC One 的所有节目:

  get_iplayer --channel="BBC One" ".*"
  

• 录制电视节目:

  get_iplayer --get 208
  

• 录制广播节目:

  get_iplayer --pid=b07gcv34
  

3. 项目 API 使用文档

搜索节目

• 命令: get_iplayer <搜索关键词>
• 参数:
  • --type: 指定节目类型（tv 或 radio）
  • --channel: 指定频道
  • --long: 显示详细描述

录制节目

• 命令: get_iplayer --get <节目编号>
• 参数:
  • --tv-quality: 指定电视节目质量（hd, sd, web, mobile）
  • --radio-quality: 指定广播节目质量（high, std, med, low）
  • --subtitles: 下载字幕

直接下载

• 命令: get_iplayer <节目 URL 或 PID>
• 示例:

  get_iplayer https://www.bbc.co.uk/iplayer/episode/b01sc0wf/Doctors_Series_15_Perfect/
  get_iplayer --pid=b01sc0wf
  

4. 项目安装方式

从源码安装

1. 克隆仓库:

   git clone https://github.com/get-iplayer/get_iplayer.git
   

2. 进入目录并安装:

   cd get_iplayer
   perl get_iplayer --install
   

使用包管理器安装

• Ubuntu/Debian:

  sudo apt-get install get_iplayer
  

• macOS:

  brew install get_iplayer
  

通过以上步骤，您可以顺利安装并使用 get_iplayer 工具来下载 BBC iPlayer 和 BBC Sounds 的节目。