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

Overview

Written in Rust, the YouTube TUI is a lightweight and user friendly TUI for browsing YouTube content from the terminal.

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

Customisable

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:

invidious_instance: https://vid.puffyan.us
max_watch_history: 50
allow_unicode: false
images: Sixels
refresh_after_modifying_search_filters: true
provider: YouTube
env:
  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.

Dependency-free

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.

Powerful

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

View popular/trending videos
View information about channels, playlists and videos
Use search filters to sort and filter search results
Save browsing history

What it doesn't have

Vim-like commands (first priority)
Command line args (first priority)
Bootleg Vimscript? (will implement)
Channel search (will implement)
Channel videos sorting (will implement)
Subscriptions (will implement)
Recommendations/comments (probably will not implement)

How to contribute

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

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