Livestreamer命令行工具使用指南

Livestreamer命令行工具使用指南

什么是Livestreamer？

Livestreamer是一款功能强大的命令行流媒体播放工具，它能够从各种在线直播平台提取视频流，并通过本地视频播放器进行播放。与直接通过浏览器观看直播相比，Livestreamer提供了更稳定、更高效的观看体验，特别适合网络条件不佳或需要长时间观看直播的用户。

基础使用方法

准备工作

在使用Livestreamer之前，您需要：

1. 安装Livestreamer程序
2. 安装一个兼容的视频播放器（推荐VLC或mpv）
3. 熟悉基本的命令行操作（Windows用户可使用命令提示符或PowerShell，Mac/Linux用户使用终端）

基本命令结构

Livestreamer的基本命令格式如下：

livestreamer [选项] [URL] [流质量]

查看可用流

要查看某个直播地址可用的流质量选项，只需输入URL：

livestreamer twitch.tv/day9tv

执行后会显示类似如下的输出：

[cli][info] Found matching plugin twitch for URL twitch.tv/day9tv
Available streams: audio, high, low, medium, mobile (worst), source (best)

选择并播放流

选择您想要的流质量（如source）作为第二个参数：

livestreamer twitch.tv/day9tv source

Livestreamer会自动启动您配置的视频播放器并开始播放。

快捷选择

• best：自动选择最高质量
• worst：自动选择最低质量

livestreamer twitch.tv/day9tv best

配置文件使用

为了避免每次输入冗长的命令行参数，Livestreamer支持通过配置文件保存常用设置。

配置文件位置

不同操作系统的配置文件位置：

• Linux/Mac：
  • ~/.config/livestreamer/config
  • ~/.livestreamerrc
• Windows：
  • %APPDATA%\livestreamer\livestreamerrc

配置文件语法

配置文件采用简单的键值对格式，每行一个选项：

option=value

或没有值的选项：

option

配置示例

# 播放器设置
player=mpv --cache 2048
player-no-close

# Twitch认证
twitch-oauth-token=mytoken

平台特定功能

Twitch认证

要观看Twitch的订阅内容，需要进行OAuth认证：

livestreamer --twitch-oauth-authenticate

执行后会打开浏览器完成认证流程。

Crunchyroll认证

Crunchyroll需要高级账户才能观看部分内容：

livestreamer --crunchyroll-username=xxxx --crunchyroll-password=xxx http://crunchyroll.com/...

注意：出于安全考虑，建议将密码保存在配置文件中而非命令行中。

高级功能

直接播放流协议

Livestreamer支持直接播放多种流协议：

# RTMP协议示例
livestreamer "rtmp://server.net/playpath live=1 swfVfy=http://server.net/player.swf"

# HDS协议示例
livestreamer hds://server.net/playpath/manifest.f4m

支持的流协议

| 协议名称 | 前缀 | |---------|------| | Adobe HDS | hds:// | | Akamai HD | akamaihd:// | | Apple HLS | hls:// hlsvariant:// | | RTMP系列 | rtmp:// rtmpe:// rtmps:// rtmpt:// rtmpte:// | | HTTP流 | httpstream:// |

常见问题解决

1. 缓冲问题：尝试增加播放器缓存大小

   player=mpv --cache 2048
   

2. 区域限制：对于Crunchyroll等内容，可尝试使用代理并清除旧凭证

   livestreamer --http-proxy=proxy:port --https-proxy=proxy:port --crunchyroll-purge-credentials ...
   

3. 播放器问题：确保使用兼容的播放器，并检查播放器路径是否正确

通过本指南，您应该已经掌握了Livestreamer的基本和进阶使用方法。这款工具虽然基于命令行，但一旦配置得当，将为您提供稳定高效的直播观看体验。