Warning
This project is no longer maintained. If you are interested, it's free software under the GPL-3.0 license.
A CLI tool for watching Twitch live streams and videos with the help of mpv and yt-dlp.
- Watch one or more video with the ID.
- Play a live stream with the channel's ID.
- List a channel's videos and choose one or more to watch in a playlist form.
- Check for the status of a channels list from a file and show who is online and who is offline, then choose some live streams to play.
- Select a media format (e.g. 1080p60, 480p, Audio_Only) for every live stream or video you want to watch.
paru -Sa cwitch
yay -Sa cwitch
pip install https://github.com/zefr0x/cwitch/archive/refs/tags/v0.3.0.zip
You might need to use
pip3
orpython3 -m pip
instead of justpip
Use the --help
or -h
option to see the help menu.
cwitch -h
There are three subcommands c
, s
and v
. Choose a subcommand and then you can use the -h
option to see the help menu for the subcommand.
Create a file in you home directory with the path: .config/cwitch/channels.ini
if there wasn't . Then add your channels list as following:
[Display Name]
id=channel_id
[Display Name]
id=channel_id
Create a file on you home directory with the path: .config/cwitch/config.ini
if there wasn't. Then overwrite an existing option, like this:
[playlist_fetching]
# The default number of fetched videos when listing a channel's videos.
max_videos_count=5
There are no option other than this for now.
For both config and channels list there is an example file in the repo.
- Display videos comments as subtitles.
- Contact with yt-dlp if possible to improve the progress bar.
- Support bash and zsh tap completions
- Integrate some mpv userscript to easily controle the video quality on the fly, like mpv-youtube-quality.
- Add some configurations for mpv caching and the streaming process.