6 releases

0.2.2 May 24, 2023
0.2.1 May 22, 2023
0.1.2 Apr 22, 2023

#80 in Visualization

Download history 18/week @ 2023-04-15 42/week @ 2023-04-22 5/week @ 2023-04-29 15/week @ 2023-05-06 37/week @ 2023-05-13 56/week @ 2023-05-20 26/week @ 2023-05-27

135 downloads per month

GPL-3.0-or-later

165KB
4.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

~8–15MB
~306K SLoC