Termusic

termusic is a terminal music and podcast player written in Rust. It allows you to listen to music and podcasts freely, both in terms of freedom and cost. You can download music from YouTube, NetEase, Migu, and KuGou for free, without the need for monthly paid memberships.

• Freedom: Enjoy music without being controlled by online service providers.
• Free of Charge: Download from various platforms for free.
• Minimalist UI: An intuitive interface with a tag editor.
• Multiple Backends: Supports Symphonia, Mpv, and Gstreamer.

termusic supports a wide range of audio formats across different backends:

The default backend is rusty.

• MSRV: Minimal Supported Rust Version 1.75.0.
• Git: Required to build the package.

• Symphonia: Requires ALSA, soundtouch, and clang (build only).
• GStreamer: Requires GStreamer.
• MPV: Requires MPV.
• Protobuf: Required for building and running termusic.
• Dbus: Required if use_dbus configuration option is enabled.
• yt-dlp support: Optionally install yt-dlp and FFmpeg for downloading MP3s from YouTube.

Install from the AUR using an AUR helper:

paru termusic

Install from the official repositories:

pkgin install termusic

Install using nix-env:

nix-env --install termusic

{
    environment.systemPackages = with pkgs; [
      termusic
    ];
}

Install from crates.io:

cargo install termusic termusic-server --locked

Clone the repository and build from source:

git clone https://github.com/tramhao/termusic.git
cd termusic
make
make install

To display album covers on terminals other than Kitty or iTerm2, install ueberzug or ueberzugpp and build with:

make full

Run termusic:

~/.local/share/cargo/bin/termusic

You can copy it to any location in your $PATH. The configuration file is located in ~/.config/termusic/config.toml (or on macOS, ~/Library/Application Support/termusic/config.toml).