Skip to content

LeoRiether/tori

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0c27b32 · Jan 31, 2024
Jan 30, 2024
May 24, 2023
Aug 1, 2023
Sep 26, 2023
Sep 17, 2023
Jan 31, 2024
Jul 29, 2023
May 24, 2023
Jan 31, 2024
Jan 30, 2024
Apr 12, 2023
May 12, 2023
May 22, 2023

Repository files navigation

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