2 unstable releases

new 0.4.5 Nov 27, 2024
0.3.0 Nov 25, 2024
0.2.0 Sep 26, 2022
0.2.0-beta Jul 14, 2022
0.1.8 Sep 10, 2021

#44 in Audio

Download history 4/week @ 2024-09-23 300/week @ 2024-11-25

300 downloads per month

GPL-3.0 license

21KB
400 lines

Crate Status License

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

  1. Rust (nightly): Install Rust using rustup. Ensure you are using the stable version.
  2. 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

  1. Play a song:

    mprs play
    
  2. Pause playback:

    mprs pause
    
  3. List files in the music directory:

    mprs list
    
  4. Add a song to the queue:

    mprs add <path-to-song>
    
  5. Clear the queue:

    mprs clear
    

Contributing

Contributions are welcome under the terms of the GPL-3.0 License. Here's how you can contribute:

  1. Fork this repository.
  2. Create a branch for your feature or bugfix.
  3. Write clear and concise commit messages.
  4. 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