https://github.com/hikikones/trollstov
A music player for the terminal where your files and their metadata are all you need.
https://github.com/hikikones/trollstov
cli music music-player ratatui terminal terminal-app tui
Last synced: 3 months ago
JSON representation
A music player for the terminal where your files and their metadata are all you need.
- Host: GitHub
- URL: https://github.com/hikikones/trollstov
- Owner: hikikones
- License: mit
- Created: 2026-01-14T16:48:34.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-03T03:05:29.000Z (3 months ago)
- Last Synced: 2026-04-03T12:24:26.486Z (3 months ago)
- Topics: cli, music, music-player, ratatui, terminal, terminal-app, tui
- Language: Rust
- Homepage:
- Size: 521 KB
- Stars: 31
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ratatui - trollstov - A music player for the terminal where your files and their metadata are all you need. (💻 Apps / 🎼 Music and Media)
README
# trollstov
Your music is the database.
The music player with the Monokai Soda color scheme.
`trollstov` is a music player for the terminal that is built around a simple idea — your files and their metadata are all you need. Simply back up your music directory and you have backed up everything. Ratings are part of the metadata, so your favorite songs are always just a few keystrokes away.
The name is a norwegian word play for a substance with magical properties. You have "troll", a creature from Norse mythology, and "stov" which is actually "støv", meaning "dust" in english. Hence, you get "troll dust".
## 📌 Features
- Your music is the database — your files and their metadata are all you need.
- Portable rating — the rating is part of the metadata.
## ⚡ Usage
The `trollstov` command takes one mandatory argument, which is the path to your music directory.
```sh
trollstov /path/to/my/music
```
In addition, it comes with one optional argument.
| Option | Description |
| ------ | ----------- |
| `--mpris` | Add media controls through the Media Player Remote Interfacing Specification (MPRIS). |
## 💡 Supported Audio Formats
| Format | Metadata | Playback |
| ------ | -------- | -------- |
| FLAC | Vorbis Comments | Yes |
| Opus | Vorbis Comments | Yes[^1] |
| Ogg Vorbis | Vorbis Comments | Yes |
| MP3 | ID3v2 | Yes |
[^1]: Requires the `opus` feature.
## ⚠️ Non-goals
- Supporting most audio formats.
- Metadata editing, except for the rating.
- Gapless playback.
## 🔖 Install
The application is only available on GitHub for now, but will probably come to `crates.io` at a later time. Do note that for `opus` support you need `libopus` installed along with `cmake`.
```sh
cargo install --git https://github.com/hikikones/trollstov --features opus
```