2020-10-21 16:47:41 +00:00
|
|
|
# mmtc
|
2020-11-02 22:58:54 +00:00
|
|
|
|
2020-11-03 00:36:38 +00:00
|
|
|
[](https://github.com/figsoda/mmtc/releases)
|
2021-03-16 14:34:50 +00:00
|
|
|
[][crate]
|
2020-11-03 00:36:38 +00:00
|
|
|
[](https://libraries.io/cargo/mmtc)
|
|
|
|
|
[](https://www.mozilla.org/en-US/MPL/2.0)
|
|
|
|
|
[](https://github.com/figsoda/mmtc/actions?query=workflow:ci)
|
|
|
|
|
|
2020-11-11 13:47:23 +00:00
|
|
|
Minimal [mpd](https://github.com/musicplayerdaemon/mpd) terminal client that aims to be simple yet highly configurable
|
2020-11-02 22:58:54 +00:00
|
|
|
|
2021-02-07 18:48:12 +00:00
|
|
|
- [Installation](#installation)
|
|
|
|
|
- [Building from source](#building-from-source)
|
|
|
|
|
- [Usage](#usage)
|
|
|
|
|
- [Environment variables](#environment-variables)
|
|
|
|
|
- [Key bindings](#key-bindings)
|
2020-11-07 18:12:06 +00:00
|
|
|
- [Configuration.md]
|
|
|
|
|
- [CHANGELOG.md]
|
2020-11-02 22:58:54 +00:00
|
|
|
|
2020-11-13 17:03:37 +00:00
|
|
|
|
2020-11-03 00:36:38 +00:00
|
|
|
## Installation
|
|
|
|
|
|
2021-02-11 15:28:53 +00:00
|
|
|
[](https://repology.org/project/mmtc/versions)
|
|
|
|
|
|
2020-11-03 00:36:38 +00:00
|
|
|
The latest precompiled binaries are available on [github](https://github.com/figsoda/mmtc/releases/latest).
|
|
|
|
|
|
2021-03-16 14:34:50 +00:00
|
|
|
Alternatively you can install mmtc from [crates.io][crate] with cargo.
|
2020-11-03 00:36:38 +00:00
|
|
|
|
2020-11-30 22:54:16 +00:00
|
|
|
```sh
|
2021-02-05 15:54:50 +00:00
|
|
|
cargo install mmtc
|
2020-11-03 00:36:38 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
2020-11-02 22:58:54 +00:00
|
|
|
## Building from source
|
|
|
|
|
|
2020-11-30 22:54:16 +00:00
|
|
|
```sh
|
2021-02-05 15:54:50 +00:00
|
|
|
cargo build --release
|
2020-11-02 22:58:54 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
2020-11-30 22:54:16 +00:00
|
|
|
```sh
|
2020-11-03 20:34:59 +00:00
|
|
|
mmtc [FLAGS] [OPTIONS]
|
2020-11-02 22:58:54 +00:00
|
|
|
```
|
|
|
|
|
|
2020-11-09 13:13:14 +00:00
|
|
|
flag | description
|
|
|
|
|
-|-
|
2020-11-09 21:28:23 +00:00
|
|
|
--clear-query-on-play | Clear query on play
|
2020-11-10 23:33:10 +00:00
|
|
|
--cycle | Cycle through the queue
|
2020-11-09 13:13:14 +00:00
|
|
|
-h, --help | Prints help information
|
2020-11-09 21:28:23 +00:00
|
|
|
--no-clear-query-on-play | Don't clear query on play
|
2020-11-09 13:13:14 +00:00
|
|
|
--no-cycle | Don't cycle through the queue
|
|
|
|
|
-V, --version | Prints version information
|
2020-11-02 22:58:54 +00:00
|
|
|
|
2020-11-09 13:13:14 +00:00
|
|
|
option | description
|
|
|
|
|
-|-
|
2020-11-09 19:47:34 +00:00
|
|
|
--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
|
2020-11-02 22:58:54 +00:00
|
|
|
|
|
|
|
|
|
2021-02-07 18:44:29 +00:00
|
|
|
## 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
|
|
|
|
|
|
|
|
|
|
|
2020-11-03 00:34:18 +00:00
|
|
|
## Key bindings
|
|
|
|
|
|
|
|
|
|
Key | Action
|
|
|
|
|
-|-
|
2020-12-21 23:53:56 +00:00
|
|
|
<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
|
2021-11-08 18:56:16 +00:00
|
|
|
<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
|
2021-01-15 14:36:16 +00:00
|
|
|
<kbd>g</kbd> | go to the top of the queue
|
|
|
|
|
<kbd>G</kbd> | go to the bottom of the queue
|
2020-12-21 23:53:56 +00:00
|
|
|
<kbd>/</kbd> | enter searching mode
|
2021-07-27 20:48:44 +00:00
|
|
|
<kbd>Ctrl</kbd> + <kbd>u</kbd> | empty search query
|
2020-12-21 23:53:56 +00:00
|
|
|
<kbd>Escape</kbd> | quit searching mode and empty query
|
2020-11-03 00:34:18 +00:00
|
|
|
|
|
|
|
|
|
2020-11-03 16:28:42 +00:00
|
|
|
## Configuration
|
|
|
|
|
|
2020-11-07 18:12:06 +00:00
|
|
|
See [Configuration.md]
|
2020-11-03 16:28:42 +00:00
|
|
|
|
|
|
|
|
|
2020-11-02 22:58:54 +00:00
|
|
|
## Changelog
|
|
|
|
|
|
2020-11-07 18:12:06 +00:00
|
|
|
See [CHANGELOG.md]
|
2020-11-03 00:36:38 +00:00
|
|
|
|
|
|
|
|
|
2021-01-15 21:28:28 +00:00
|
|
|
[CHANGELOG.md]: CHANGELOG.md
|
2021-03-16 14:34:50 +00:00
|
|
|
[Configuration.md]: Configuration.md
|
|
|
|
|
[crate]: https://crates.io/crates/mmtc
|
