tori

The frictionless music player for the terminal

tori is a terminal-based music player and playlist manager that can play music from local files and external URLs (supported by yt-dlp).

Features

• Plays songs from local files and external URLs
• Configurable keybinds
• Filters songs by name, artist or filepath/URL
• Sorts songs by name or duration
• Spectrum visualizer

Documentation

tori's documentation is hosted here. It includes a Getting Started guide and configuration instructions.

For code-related documentation, there's also a docs.rs entry.

Installing

• Make sure you have the dependencies installed
• Install the Rust toolchain
• Run cargo install tori

Alternatively, if you use an Arch-based Linux distro, you can install tori from the AUR: yay -S tori-bin

Prebuild binaries for Windows, Mac and other Linux distros will be available soon.

Dependencies

• mpv
• yt-dlp (recommended) or youtube-dl
• cava (optional) for the visualizer

yt-dlp

If you're using yt-dlp instead of youtube-dl, edit your mpv.conf and paste the following line: conf script-opts=ytdl_hook-ytdl_path=yt-dlp

Either this or follow the guide I followed :)

Alternatives

• musikcube is what I used before writing tori. It's a great player, but only plays from local files.
• cmus
• yewtube