Skip to content

Play YouTube audio right in your terminal πŸ”ˆπŸŽΆ

License

Notifications You must be signed in to change notification settings

Mqlvin/termtube

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

TermTube

An application for listening to YouTube audio in the terminal, utilising yt-dlp and ffplay.


Building πŸ› οΈ

Install cargo from your favourite package manager.

Clone the repo with git clone git@github.com:Mqlvin/termtube.git
Move into the cloned directory cd termtube
Build with cargo cargo build --release

A static binary will be produced at ./target/release/termtube
You can move this binary on to your system PATH to use it anywhere :)


Usage and Running 🎢

Prerequisite: Ensure you have yt-dlp and ffplay installed and available on your system PATH.

To get started, type termtube --help

Basic Usage

To play audio, type termtube --source <source> --source <source> --source <source>...
A source can be a YouTube video link, a YouTube playlist link, or a source file.
As demonstrated, the --source flag (aka -s) can be used many times.

Using files as a source

You can create a list of YouTube video/playlist links in a file to be supplied to TermTube.
Ensure each link is placed on a new line, or the program will not read the file correctly.
Note: Adding lots of playlists can significantly increase startup time of TermTube. This is due to extra requests being made to YouTube.

Other useful options

For looping, add the --loop argument.
For shuffling, add the --shuffle argument.


Licensing πŸ“„

The project is licensed under the MIT license, which can be found here.

About

Play YouTube audio right in your terminal πŸ”ˆπŸŽΆ

Resources

License

Stars

Watchers

Forks

Languages