twitch-hls-client 1.7.0

Minimal CLI client for watching/recording Twitch streams
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

Usage: twitch-hls-client [OPTIONS] [-p <PATH> -r <PATH> -t <HOST:PORT>] <CHANNEL> <QUALITY>

Arguments:
  <CHANNEL>
          Twitch channel
  <QUALITY>
          Stream to play (best, 1080p, 720p, 360p, 160p, audio_only, etc.)

General options:
  -h, --help
          Print help (this message) and exit
  -V, --version
          Print version and exit
  -d, --debug
          Enable debug logging
  -c <PATH>
          Path to config file
      --no-config
          Ignore config file

Output options:
    Player options:
      -p <PATH>
              Path to player
      -a <ARGUMENTS>
              Arguments to pass to the player. [default: -]
              The keyword '[channel]' will be substituted with the channel argument at runtime.
      -q, --quiet
              Silence player output
          --no-kill
              Don't kill the player on exit

    Recording options:
      -r <PATH>
              Record to the specified file path
          --overwrite
              Allow overwriting file when recording

    TCP server options:
      -t <HOST:PORT>
              Listen on <HOST:PORT> and output stream to connected TCP clients.
              Clients may connect or disconnect at any time.
              If there are no clients connected and it is the only output, then
              segment fetching will be paused until a client connects.
          --tcp-client-timeout <SECONDS>
              TCP client write timeout in seconds [default: 30]

HLS options:
  -s <URL1,URL2>
          Ad blocking playlist proxy server to fetch the master playlist from.
          If not specified will fetch the master playlist directly from Twitch.

          Can be multiple comma separated servers, will try each in order until successful.
          The keyword '[channel]' will be substituted with the channel argument at runtime.
          Note: This does not support standard HTTP proxies (ie. proxies using the CONNECT request)
      --print-streams
          Print available streams and exit
      --no-low-latency
          Disable low latency streaming
      --passthrough <MODE>
          Passthrough playlist URL to the player and do nothing else.

          Valid modes:
          'variant': passthrough the variant playlist URL
          'multivariant': passthrough the multivariant playlist URL
          'disabled': disable passthrough
      --client-id <ID>
          Value to be used in the Client-Id header.
          If not specified will use the default client ID.
      --auth-token <TOKEN>
          Value to be used in the Authorization header.
          If --client-id is not specified will retrieve client ID from Twitch.
      --codecs <CODEC1,CODEC2>
          Comma separated list of supported codecs [default: av1,h265,h264]
      --never-proxy <CHANNEL1,CHANNEL2>
          Prevent specified channels from using a playlist proxy.
          Can be multiple comma separated channels.
      --playlist-cache-dir <PATH>
          Cache the variant playlist URL to a file in the specified directory.
          If the playlist is still available it will be used instead of fetching a new one.
      --use-cache-only
          Exit if the variant playlist URL is not already cached.
          Requires --playlist-cache-dir. Cannot be used with --write-cache-only.
      --write-cache-only
          Write to the playlist cache and exit.
          Requires --playlist-cache-dir. Cannot be used with --use-cache-only.
      --force-playlist-url <URL>
          Skip fetching/parsing the variant playlist URL and use the specified URL instead

HTTP options:
      --force-https
          Abort request if protocol is not HTTPS
      --force-ipv4
          Only use IPv4 addresses when resolving host names
      --user-agent <USERAGENT>
          User agent used in HTTP requests [default: {default_user_agent}]
      --http-retries <COUNT>
          Retry HTTP requests <COUNT> times before giving up [default: 3]
      --http-timeout <SECONDS>
          HTTP request timeout in seconds [default: 10]
      --socks5 <HOST:PORT>
          Proxy requests through a SOCKS5 proxy server.
          Username/password auth is currently unsupported.
      --socks5-restrict <HOST1,HOST2>
          Proxy only the specified host(s).
          If not specified all requests will be proxied.