install

Additional install commands

macOS

Homebrewverified · 100%

brew install termusic

local Homebrew formula metadata

MacPortsverified · 94%

sudo port install termusic

MacPorts ports tree · multimedia/termusic/Portfile · source: api.github.com

Linux

Nixverified · 92%

nix profile install nixpkgs#termusic

nixpkgs package indexes · pkgs/by-name/te/termusic/package.nix · source: api.github.com

Arch Linux pacmanverified · 92%

sudo pacman -S termusic

Arch Linux sync databases · termusic · source: geo.mirror.pkgbuild.com

Windows

Scoopverified · 92%

scoop install main/termusic

Scoop official bucket manifest trees · bucket/termusic.json · source: api.github.com

overview

Package summary

Music Player TUI written in Rust

Project links

Commands and aliases

termusic
termusic-server

history

Project history and usage

termusic is a Rust terminal music and podcast player. Its history is rooted in the Unix/TUI tradition of local media clients, but its README frames the motivation around freedom from centralized music services and a rewrite from GOMU to avoid data-race problems.

Project history

The repository was created in June 2021. The README says the author had contributed to GOMU, encountered serious data-race problems during development, and rewrote the player in Rust to address them.

The project grew into a split client/server terminal application with audio playback, podcast support, library indexing, playlists, metadata/tag editing, album-cover display, multiple playback backends, and optional download helpers. GitHub releases show steady v0.x development from v0.6.x in late 2021 through v0.13.x in 2026.

Adoption history

termusic has unusually broad package-manager reach for a TUI media player. The README lists Cargo and cargo-binstall as official install sources and documents unofficial or downstream package availability through Arch Linux repositories, AUR, Homebrew, NetBSD pkgin, and Nix/NixOS. The input package facts also show Brew, MacPorts, Nix, pacman, and Scoop packaging.

How it is used

Users run `termusic` for the TUI and `termusic-server` for the server component. The README documents local configuration under platform-specific application config directories, optional playback backends such as MPV and GStreamer, support for common audio containers/codecs, podcast database files, playlist storage, and logs in temporary directories.

Why package nerds care

For package nerds, termusic is interesting because it is both a Rust TUI application and a media stack integration point: packaging must account for Rust MSRV, protobuf, audio backends, ALSA/DBus on Linux, optional yt-dlp/ffmpeg helpers, album-cover protocols, and separate client/server binaries. That makes it a more complex package than a simple single-binary CLI.

Timeline

2021: GitHub repository created.
2021: v0.6.2 and subsequent v0.6.x releases appeared on GitHub.
2023: v0.7.11 released after continued v0.x maintenance.
2024: v0.9.x releases continued terminal music-player development.
2025: v0.10.0 and v0.11.0 released.
2026: v0.13.2 released, with README metadata showing active Rust/MSRV and packaging maintenance.

Related projects

The README names GOMU as the project that motivated the Rust rewrite.
The README also thanks tui-realm, termscp, netease-cloud-music-gtk, alacritty-themes, shellcaster, and stream-download as related or influential projects.

Sources

security posture

Risk level: blue

broad file, network, media, or database tool signal.

Risk classifier

blue risk · medium confidence · tool

Why

broad file, network, media, or database tool signal

Signals

text:server

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Installs with 1 runtime dependencies.
Build metadata lists 3 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Linux: ~/.config/termusic/server.toml~/.config/termusic/tui.toml
macOS: ~/Library/Application Support/termusic/server.toml~/Library/Application Support/termusic/tui.toml
Windows: %APPDATA%\termusic\server.toml%APPDATA%\termusic\tui.toml

executables

Installed executables

Command	Kind	Exposure	Note
`termusic`	cli	global executable
`termusic-server`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version0.13.2

manager updated2026-05-12

local dataok

upstreamcurrent

latest detectedv0.13.2

https://github.com/tramhao/termusic

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:termusic
Version	0.13.2
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/termusic
Homepage	https://github.com/tramhao/termusic
Repository	https://github.com/tramhao/termusic
Upstream docs	https://github.com/tramhao/termusic#readme
License	MIT AND GPL-3.0-or-later
Source archive	https://github.com/tramhao/termusic/archive/refs/tags/v0.13.2.tar.gz
Last updated	2026-05-12T10:30:28-04:00
Pulse	updated
Dependencies	opus
Build dependencies	pkgconf, protobuf, rust
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	termusic
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

termusic

nix profile install nixpkgs#termusic

normalized package name match
Matched by: Termusic

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/te/termusic/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

pacman95%

termusic 0.13.2-1

Music Player TUI written in Rust

https://github.com/tramhao/termusic

sudo pacman -S termusic

License: MIT AND GPL3
Architecture: x86_64
10 dependencies
4 optional deps
normalized package name match
Matched by: Termusic

Arch Linux sync databases · geo.mirror.pkgbuild.com · Arch Linux sync databases: termusic from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

MacPorts95%

termusic

sudo port install termusic

normalized package name match
Matched by: Termusic

MacPorts ports tree · api.github.com · MacPorts ports tree: multimedia/termusic/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

Scoop95%

main/termusic

scoop install main/termusic

normalized package name match
Matched by: Termusic

Scoop official bucket manifest trees · api.github.com · Scoop official bucket manifest trees: bucket/termusic.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/termusic.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install termusic with Homebrew, MacPorts, Nix, pacman, scoop