2 unstable releases
new 0.4.5 | Nov 27, 2024 |
---|---|
0.3.0 | Nov 25, 2024 |
0.2.0 |
|
0.2.0-beta |
|
0.1.8 |
|
#44 in Audio
300 downloads per month
21KB
400 lines
mprs
A lightweight MPD client written in Rust, designed for simplicity,
performance, and open-source collaboration. mprs
provides a command-line
interface to control your MPD (Music Player Daemon) server efficiently.
Features
- High Performance: Built with Rust for speed and reliability.
- Simple Command Line Interface: Intuitive commands to manage your music playback.
- Customizable Connection: Supports connecting to MPD servers on any host and port.
Installation
Prerequisites
- Rust (nightly): Install Rust using rustup. Ensure you are using the stable version.
- MPD: Install and configure MPD on your system.
Install from crates.io
To build mprs
.
# Build the project
cargo install mprs
Build and Install
To build and install mprs
, follow these steps:
# Build the project
cargo build --release
# Install the binary
cargo install --path .
Usage
The mprs
command-line tool provides subcommands for interacting with MPD.
General Syntax
mprs [OPTIONS] <COMMAND>
Options
--host <HOST>
: Specify the MPD server host (default:127.0.0.1
).--port <PORT>
: Specify the MPD server port (default:6600
).-h, --help
: Display help information.
Commands
Command | Description |
---|---|
current |
Display MPD's current playback info. |
play |
Play the currently queued song. |
pause |
Pause playback. |
next |
Skip to the next song in the queue. |
prev |
Go back to the previous song in the queue. |
stop |
Stop playback. |
kill |
Kill the MPD process. |
list |
List files in the MPD music_directory . |
add |
Add a song to the queue using its path. |
queued |
Show the current queue. |
clear |
Clear all songs from the queue. |
help |
Show help for a specific subcommand. |
Example Commands
-
Play a song:
mprs play
-
Pause playback:
mprs pause
-
List files in the music directory:
mprs list
-
Add a song to the queue:
mprs add <path-to-song>
-
Clear the queue:
mprs clear
Contributing
Contributions are welcome under the terms of the GPL-3.0 License. Here's how you can contribute:
- Fork this repository.
- Create a branch for your feature or bugfix.
- Write clear and concise commit messages.
- Submit a pull request with a description of your changes.
Please ensure your code adheres to Rust's style guidelines.
License
mprs
is distributed under the terms of the GNU General Public License
v3.0. See the LICENSE file for details.
Get Started with mprs
Take control of your MPD music server with mprs
—an open-source, Rust-powered
client designed for simplicity and speed. 🎶
Dependencies
~1–12MB
~77K SLoC