TubiTui

⚠️ Due to ongoing issues with Invidious, no public instances are running. Most features of TubiTui will not work, and development has been discontinued for the time being. Please feel free to fork :)

A simple, lightweight, TUI-based Invidious/YouTube client

It uses...

• the Invidious API to get data
• MPV to stream video
• Cursive to render the TUI

Features

• Search for YouTube videos and view information about them
• Play videos in mpv
• Download videos and their thumbnails
• View channels, playlists, and comments
• Save videos to local playlists
• Choose between Invidious instances to use

Installation

Dependencies

• mpv - Installation

  • Required to playback video
  • On Linux and Mac, install via your system package manager.

• yt-dlp (Optional) - Installation

  • 1080p video support
  • Package manager versions are often outdated, so install binaries from the yt-dlp GitHub.
    • On all platforms place binary in folder containing mpv.exe
    • Alternatively on Linux place in /bin

Windows

On Windows it is necessary to add the mpv executable to the path manually. Either do this using the GUI interface or using the command:

setx PATH "%PATH%;<path-to-mpv-folder>"

It is a good idea to make a backup of your PATH variable before doing this.

Releases

Download the latest release for your operating system from the releases page. Currently .deb packages, and portable binaries for Windows and Linux are available.

Build from source

Before starting, install Rust and Cargo.

Firstly, clone the repository:

$ git clone https://codeberg.org/777/TubiTui
$ cd TubiTui/

And compile with cargo:

$ cargo build --release

Then run the resulting executable:

$ cd target/release/
$ ./tubitui

Options

If you want to use ncurses as a TUI backend instead of crossterm, the default:

$ cargo build --release --features=ncurses-backend

This requires ncurses to be installed on your system. (not available on Windows)

Usage Notes

• Config files and downloads are stored in ~/.tubitui (Linux, Mac), or C:\Users\<USER>\AppData\Roaming\tubitui (Windows).
• If you cannot install yt-dlp, you can stop it showing as a playback option in settings.