Ramp is a no bullshit, batteries included, configurable music player for the terminal. It is designed to be lightweight, customizable and easy to use.
Note: This project is still a work in progress, contributions are welcome.
Ramp supports basically all common audio formats thanks to symphonia.
MPRIS is supported.
It also uses caching to store metadata about music files in order to avoid loading times during use.
Other than that, it basically just plays music.
cargo install --path .
Ramp is configured using a config.json
file. This file is located in the local configuration directory of your system.
See
config_dir()
from https://crates.io/crates/dirs
Platform | Value | Example |
---|---|---|
Linux | $XDG_CONFIG_HOME or $HOME/.config | /home/alice/.config |
macOS | $HOME/Library/Application Support | /Users/Alice/Library/Application Support |
Windows | {FOLDERID_RoamingAppData} | C:\Users\Alice\AppData\Roaming |
The default configuration file is generated on first run.
Example configuration:
{
"search_directories": ["/home/alice/Musik"],
"extensions": ["mp3", "flac", "ogg", "wav"],
"cache_path": "/home/alice/.config/ramp/ramp.cache",
"log_path": "/home/alice/.config/ramp/ramp.log",
"gain": 0.0
}