Skip to content

Unobtrusive terminal music player written in Rust

License

Notifications You must be signed in to change notification settings

Techno-coder/pmu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pmu

Play music in your terminal!

Features

Play past songs from any directory

After you play a song, run the same command to play the same song even if you're in a different directory! Playback history is stored in an SQLite database.

Extract metadata from supported song folders

Metadata is automatically extracted from special song folders. Supported folders include those from:

  • osu!
  • Stepmania

Discord Rich Presence

Show off the song you're playing in Discord!

Last.fm scrobbling

Track the music you play on last.fm!

Installation

$ cargo install --locked --git https://github.com/Techno-coder/pmu

Usage

Play a song

$ pmu play path/to/song.mp3

Print help

$ pmu help

Print configuration directory

$ pmu config

Configuration

The configuration file is named config.json. The documentation for each option can be found here.

Recommended additions

fzf lets you quickly search for audio files and past command history.

Hotkey terminal

Some terminal emulators such as iTerm2 allow you to set a keyboard shortcut to instantly activate a terminal window.

Shell aliases

You can set aliases in your ~/.bashrc or ~/.zshrc profile to play songs faster:

alias song="pmu play --now"
alias pause="pmu pause"
alias stop="pmu stop"

Troubleshooting

The daemon can be spawned manually with pmu daemon:

Releases

No releases published

Packages

No packages published

Languages