Awesome
Ytui-music
Listen to music from youtube inside terminal with sleek tui
See more screenshots
Installation
-
Download latest binary from release page. If binary is not available for your platform, head on to build from source
-
Give it executable permission and from downloaded directory, in shell:
ytui_music run
- You may need to jump to Usage Guide
Dependencies
Ytui-music depends on mpv and youtube-dl. You may refer to the official websites of mpv and youtube-dl.
If you have choco
for windows or brew
in mac or one of popular package manager in Linux you may run:
- Windows (In powershell or cmd)
choco install mpv youtube-dl
- Mac
brew install mpv youtube-dl
- Debian/Ubuntu Derivatives
sudo apt update -y
sudo apt install -y youtube-dl libmpv1 libmpv-dev
For other distributions, install youtube-dl and mpv packages in your preferred methods
Before running ytui-music
Before you start with ytui-music, make sure that the following directory exists and that you have write permission to ytui-music in order to save configuration file.
Windows
C:\Users\<username>\AppData\Roaming
or anv var {FOLDERID_RoamingAppData}
Mac
/Users/<username>/Library/Application Support
or $HOME/Library/Application Support
Linux
$HOME/.config/
or /home/<username>/.config
or env var $XDG_CONFIG_HOME
Building from Source
Ytui-music is written entirely in Rust and building it from source is dead simple. All you have to do is download source, install rust and build with cargo.
- Installing rust. Head to Rust installation. It is basically doing
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
- Get the source code. You can download from the archives or use git clone:
git clone git@github.com:sudipghimire533/ytui-music
cd
into source root and do:
cargo build --all --release
- The compiled binary is located in
target/release/
directory. Copy theytui_music
binary and place it somewhere where it is easy to run. Preferrably under$PATH
.
sudo update-alternatives --install /usr/local/bin/ytui_music ytui_music $PWD/target/release/ytui_music 1
- Ytui-music is now ready to fire. Head over to usage
Usage
ytui-music is single binary so it shouldn't be difficult to run. Just make sure you have installed the required dependencies.
Run ytui-music
ytui_music run
Show help message
ytui_music help
Show current configured shortcuts
ytui_music info shortcuts
Show version information
ytui_music infor version
Searching
- Press
/
to go to search box - Type
music:Bartika Eam Rai
to search only for music result for query "Bartika Eam Rai"playlist:Soft pop hits
to search only for playlist for query "Soft pop hits"artist:Bibash Jk
to search only for artist for query "Bibash Jk"Coding music
to search all of playlist, music and artist at once for query "Coding music"
- Press
Enter
key
Navigating
- Use
Left arrow
orBackspace
for backward andRight arrow
orTab
key for forward to move between Sidebar, Musicbar, Playlistbar and Artistbar - Use
Up arrow
orDown arrow
to move up or down in the list which will highlight the list item - Press
Enter
key to select an item
Playback control
- Press
Space
key to pause/unpause the playback - Press
s
key to toggle suffle/unsuffle - Press
r
key to repeat single or all item in playlist - Press
>
for forward and<
for backward playback seek - Press
CTRL+n
for next andCTRL+p
to change track
Downloading
- Highlight the item you want to download. Currently downloading of music and playlist is supported.
- Press
CTRL+d
to download the selection
Quitting
- Press
CTRL+c
to quit ytui-music - If download is ongoing, press
CTRL+ALT+C
to force quit
Adding to favorites
- Highlight the item you want to add or remove from favorites
- Press
f
to add oru
to remove from favorites - To see your list
- Favorite music are shown in
Liked
section in sidebar - Favorite playlists are shown in
My playlist
section in sidebar - Favorite artists are shown in
Following
section in sidebar
- Favorite music are shown in
Screenshots
This is what ytui-music looks like. It may even look better on yours. ;)
<details> <summary> Click to see screenshots</sumary>