# [mus](https://sr.ht/~sfr/mus)
a pretty good mpd client

## usage
```
Commands:
  np       show currently playing song (just `mus' also works)
  play     unpause currently playing song or play a new one
  pause    pause currently playing song
  toggle   toggle play/pause
  next     play the next song in the queue
  prev     play the previous song in the queue
  queue    manage the song queue
  shuffle  shuffle the song queue
  help     Print this message or the help of the given subcommand(s)

Options:
  -a, --address <ADDRESS>  location of mpd server [default: 127.0.0.1:6600]
  -h, --help               Print help
  -V, --version            Print version
```

use `mus help <COMMAND>` for more information about subcommands.

## building
```sh
$ cargo build --release

# or directly to your bin directory
$ cargo install --path .
```

## contributing
send patches to [the mailing list](https://lists.sr.ht/~sfr/public-inbox). prefix patches with "`[PATCH mus]`".

see [the guide to `git send-email`](https://git-send-email.io) if this is your first time using sourcehut.

## license
mus is licensed under the MIT license. refer to [the license](LICENSE) for details.