YouTube TUI
An aesthetically pleasing pleasing YouTube TUI written in Rust.
Overview
YouTube TUI is a text user interface that provides a clean UI for browsing YouTube content. It can perform searches and view channels in the terminal, play videos and playlists with external programs like MPV. Rust is used in writing this program for its better performance and ease of maintaining.
This program is being actively developed and there will be new features coming up every commit.
What's new in this commit
- More code cleanup
- Commands to be ran in Item Info page can be changed, items can be add/removed (in
page_commands.yml
)- Keybindings can be created (VIM keybindings are included in default config)
- Config soft update (tries to add new options to the config, and if parsing config failed the config will be backed up and a new one will be generated)
Installation
Install from crates.io
Clone from GitHub and build
&& &&
The binary is located at ./target/release/youtube-tui
, go move it to other locations so that you can launch the program with youtube-tui
command.
Dependencies
This program does not requires any dependencies, but it is suggested these three things on your system that can be launched via command:
- A video player (Default to
mpv
)- A terminal emulator (Defaults to
konsole
)- A YouTube downloader (Defaults to
yt-dlp
, strongly suggest NOT to useyoutube-dl
because it is now very slow)None of these dependencies are required as you can change them in config (in
commands.yml
)
Usage
To launch
Movement
Key | What does it do |
---|---|
Arrow/Vim keys | Move in corresponding direction |
Right arrow | Move cursor right |
Enter | Select/Launch |
Q | Quit the program |
Note
These keys only work when nothing is selected. When something is selected, your key presses are passed directly to the "object" you've selected. Press escape (Esc) if you want to deselect.
Config
All config files are loacted at ~/.config/youtube-tui/
, will write documentations for that later
Todo (First piority on top)
- Put hard coded options into config files
- User manual + documentations
- Channel search and channel video sort
- Recommended videos
Help needed
Guys please I need help I'm kinda bad at coding tbh, these are stuff that I need help with
- Publishing to the AUR
- Printing full resolution images to the terminal with Sixels
Credits
- ytfzf by pystardust - The TUI I used to watch YouTube, gave me an idea how this program is going to work
- Terminal Typeracer by Darrien Glasser - A very clean looking TUI for typing speed test, gave me idea on how this program should look like
- Invidious - For having a nice API for doing YouTube searches and stuff. (I made a wrapper for the API you can check it here out if you want to)
... and of course, credits to myself for not having the ability to read the docs for ytfzf and decided to make my own instead.
Anything Missing?
If there is a bug or you got a nice idea on what can be added to this program, feel free to open a GitHub issue. Thx :D