mirror of
https://github.com/figsoda/mmtc
synced 2024-11-25 08:30:18 +00:00
109 lines
3.7 KiB
Markdown
109 lines
3.7 KiB
Markdown
# mmtc
|
|
|
|
[](https://github.com/figsoda/mmtc/releases)
|
|
[][crate]
|
|
[](https://deps.rs/repo/github/figsoda/mmtc)
|
|
[](https://www.mozilla.org/en-US/MPL/2.0)
|
|
[](https://github.com/figsoda/mmtc/actions?query=workflow:ci)
|
|
|
|
Minimal [mpd](https://github.com/musicplayerdaemon/mpd) terminal client that aims to be simple yet highly configurable
|
|
|
|
- [Installation](#installation)
|
|
- [Building from source](#building-from-source)
|
|
- [Usage](#usage)
|
|
- [Environment variables](#environment-variables)
|
|
- [Key bindings](#key-bindings)
|
|
- [Configuration.md]
|
|
- [CHANGELOG.md]
|
|
|
|
|
|
## Installation
|
|
|
|
[](https://repology.org/project/mmtc/versions)
|
|
|
|
The latest precompiled binaries are available on [github](https://github.com/figsoda/mmtc/releases/latest).
|
|
|
|
Alternatively you can install mmtc from [crates.io][crate] with cargo.
|
|
|
|
```sh
|
|
cargo install mmtc
|
|
```
|
|
|
|
|
|
## Building from source
|
|
|
|
```sh
|
|
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
|
|
-|-
|
|
<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]
|
|
|
|
|
|
[CHANGELOG.md]: CHANGELOG.md
|
|
[Configuration.md]: Configuration.md
|
|
[crate]: https://crates.io/crates/mmtc
|