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)
|
|
|
|
|
[][Crate]
|
|
|
|
|
[](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-04 22:51:46 +00:00
|
|
|
Minimal mpd terminal client that aims to be simple yet highly configurable
|
2020-11-02 22:58:54 +00:00
|
|
|
|
|
|
|
|
|
2020-11-03 00:36:38 +00:00
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
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. This requires the nightly toolchain of Rust.
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
cargo +nightly install mmtc
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
2020-11-02 22:58:54 +00:00
|
|
|
## Building from source
|
|
|
|
|
|
|
|
|
|
This requires the nightly toolchain of Rust.
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
cargo +nightly build --release
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
```
|
2020-11-03 20:34:59 +00:00
|
|
|
mmtc [FLAGS] [OPTIONS]
|
2020-11-02 22:58:54 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### FLAGS
|
|
|
|
|
|
|
|
|
|
```
|
2020-11-03 20:34:59 +00:00
|
|
|
--cycle Cycle through the queue
|
|
|
|
|
-h, --help Prints help information
|
|
|
|
|
--no-cycle Don't cycle through the queue
|
|
|
|
|
-V, --version Prints version information
|
2020-11-02 22:58:54 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### OPTIONS
|
|
|
|
|
|
|
|
|
|
```
|
2020-11-02 23:57:13 +00:00
|
|
|
--address <address> Specify the address of the mpd server
|
2020-11-02 22:58:54 +00:00
|
|
|
-c, --config <config> Specify the config file
|
2020-11-02 23:57:13 +00:00
|
|
|
--jump-lines <jump-lines> The number of lines to jump
|
2020-11-03 14:40:37 +00:00
|
|
|
--seek-secs <seek-secs> The time to seek in seconds
|
2020-11-02 23:57:13 +00:00
|
|
|
--ups <ups> The amount of status updates per second
|
2020-11-02 22:58:54 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
2020-11-03 00:34:18 +00:00
|
|
|
## Key bindings
|
|
|
|
|
|
|
|
|
|
Key | Action
|
|
|
|
|
-|-
|
|
|
|
|
`q` | quit mmtc
|
|
|
|
|
`r` | toggle repeat
|
|
|
|
|
`R` | toggle random
|
|
|
|
|
`s` | toggle single
|
|
|
|
|
`S` | toggle oneshot
|
|
|
|
|
`c` | toggle consume
|
|
|
|
|
`p` | toggle pause
|
|
|
|
|
`;` | stop
|
|
|
|
|
`h`, `Left` | seek backwards
|
|
|
|
|
`l`, `Right` | seek forwards
|
|
|
|
|
`H` | previous song
|
|
|
|
|
`L` | next song
|
2020-11-04 17:24:39 +00:00
|
|
|
`Enter` | play selected song or quit searching mode if in searching mode
|
2020-11-03 00:34:18 +00:00
|
|
|
`Space` | select current song or the first song in the queue
|
|
|
|
|
`j`, `Down`, `ScrollDown` | go down in the queue
|
|
|
|
|
`k`, `Up`, `ScrollUp` | go up in the queue
|
|
|
|
|
`J`, `PageDown` | jump down in the queue
|
|
|
|
|
`K`, `PageUp` | jump up in the queue
|
2020-11-04 17:24:39 +00:00
|
|
|
`/` | enter searching mode
|
|
|
|
|
`Escape` | quit searching mode and empty query
|
2020-11-03 00:34:18 +00:00
|
|
|
|
|
|
|
|
|
2020-11-03 16:28:42 +00:00
|
|
|
## Configuration
|
|
|
|
|
|
|
|
|
|
See [Configuration.md](https://github.com/figsoda/mmtc/blob/main/Configuration.md)
|
|
|
|
|
|
|
|
|
|
|
2020-11-02 22:58:54 +00:00
|
|
|
## Changelog
|
|
|
|
|
|
|
|
|
|
See [CHANGELOG.md](https://github.com/figsoda/mmtc/blob/main/CHANGELOG.md)
|
2020-11-03 00:36:38 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
[Crate]: https://crates.io/crates/mmtc
|
