#music-player

bin+lib tori

The frictionless music player for the terminal

10 releases

0.2.6 Jan 31, 2024
0.2.5 Oct 3, 2023
0.2.3 Sep 17, 2023
0.2.2 May 24, 2023
0.1.2 Apr 22, 2023

#273 in Audio

GPL-3.0-or-later

185KB
5K SLoC

tori 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).

tori screenshot

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:

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

Dependencies

~12–46MB
~748K SLoC