Minimal mpd terminal client that aims to be simple yet highly configurable


Keywords
cli, terminal, music, mpd, tui, command-line, hacktoberfest, mpd-client, music-player, rust, terminal-based
License
MPL-2.0

Documentation

mmtc

release version deps license ci

Minimal mpd terminal client that aims to be simple yet highly configurable

Installation

repology

The latest precompiled binaries are available on github.

Alternatively you can install mmtc from crates.io with cargo.

cargo install mmtc

Building from source

cargo build --release

Usage

Usage: mmtc [OPTIONS]

Options:
      --clear-query-on-play     Clear query on play
  -C, --cmd [<CMD>...]          Run mpd commands and exit
      --cycle                   Cycle through the queue
      --no-clear-query-on-play  Don't clear query on play
      --no-cycle                Don't cycle through the queue
      --address <address>       Specify the address of the mpd server
  -c, --config <file>           Specify the config file
      --jump-lines <number>     The number of lines to jump
      --seek-secs <number>      The time to seek in seconds
      --ups <number>            The amount of status updates per second
  -h, --help                    Print help information (use `--help` for more detail)
  -V, --version                 Print version information

Environment variables

Setting both MPD_HOST and MPD_PORT is the equalvalent of --address $MPD_HOST:$MPD_PORT

Precedence: command line arguments > environment variables > configuration file

Key bindings

Key Action
q or Ctrl + q quit mmtc
r toggle repeat
R toggle random
s toggle single
S toggle oneshot
c toggle consume
p toggle pause
; stop
h or Left seek backwards
l or Right seek forwards
H previous song
L next song
Enter play selected song or quit searching mode if in searching mode
Space select current song or the first song in the queue
j, Down, or ScrollDown go down in the queue
k, Up, or ScrollUp go up in the queue
J, Ctrl + d, or PageDown jump down in the queue
K, Ctrl + u, or PageUp jump up in the queue
g go to the top of the queue
G go to the bottom of the queue
/ enter searching mode
Ctrl + u empty search query
Escape quit searching mode and empty query

Configuration

See Configuration.md

Changelog

See CHANGELOG.md