Home

Awesome

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

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

Configuration

See Configuration.md

Changelog

See CHANGELOG.md