23 unstable releases (7 breaking)

0.8.0 Aug 27, 2023
0.7.4 Jul 16, 2023
0.7.2 May 28, 2023
0.7.0 Feb 26, 2023
0.4.4 Jul 14, 2022

#724 in Command-line interface

Download history 18/week @ 2023-12-15 5/week @ 2023-12-22 10/week @ 2024-01-19 11/week @ 2024-01-26 8/week @ 2024-02-02 18/week @ 2024-02-09 21/week @ 2024-02-16 15/week @ 2024-02-23 29/week @ 2024-03-01 31/week @ 2024-03-08 54/week @ 2024-03-15 13/week @ 2024-03-22 225/week @ 2024-03-29

326 downloads per month

GPL-3.0-or-later and AGPL-3.0

10K SLoC

Read more in the user manual (including installation guide and documentation).


Written in Rust, the YouTube TUI is a lightweight and user friendly TUI for browsing YouTube content from the terminal. Works out of the box and easily to configurable.

It is like an app launcher, it launches other programs to do the heavy lifting (for example, mpv for playing videos).

It also have an embedded mpv music player, but that can be disabled in compile time.

Consider regenerating config files on updates to allow new features.


The YouTube TUI can be customised through config files, they are located in ~/.config/youtube-tui and are in the YAML format.

Here's an example of the config file:

mouse_support: true
invidious_instance: https://vid.puffyan.us
max_watch_history: 50
allow_unicode: false
images: Sixels
refresh_after_modifying_search_filters: true
provider: YouTube
  browser: firefox
  video-player: mpv
  youtube-downloader: yt-dlp
  terminal-emulator: konsole -e

Anything from layouts to colours and keybindings can be customised, more on that later.


See installation#features for more info on dependencies.

The YouTube TUI does not work on its own, it is instead like a TUI frontend for programs like mpv or yt-dlp/youtube-dl.

However, the programs to launch can be changed, and therefore the YouTube TUI does not rely on any specific dependencies to run.


The YouTube TUI allows you to browse YouTube with (almost) all of it's features, functions including:

  • View information about channels, playlists and videos
  • Use search filters to sort and filter search results
  • Save browsing history
  • Embedded audio/music player

It also includes features like:

  • Vim-like commands
  • Mouse support
  • Extensible keybindings system
  • Offline library
  • Subscriptions

What it doesn't have

  • [URGENT] Replace the no-longer-going-to-compile typemap dependency with either a self implementation of it or a useable crate.
  • Strip down some libraries to reduce compile speed.
  • Add command section for channel main page (first priority)
  • Git like command line to improve on yt-dlp - make changes to existing downloaded playlists instead of redownloading the entire thing.

How to contribute

You will need a general knowledge of the Rust programming language, and the ability to understand my spaghetti.

  1. Open an issue to make sure nobody else is working on the same feature
  2. Write code
  3. Open a pull request
  4. Get merged?

Or just fix that typo in README -_-


~263K SLoC