mmtc

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

• Installation
• Building from source
• Usage
• Environment variables
• Key bindings
• Configuration.md
• CHANGELOG.md

Installation

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