# surge

Command-line YouTube-based music player. System dependencies:

```
* youtube-dl
* libmpv
* A valid YouTube api key
```

You must run `surge` with the YouTube API key as the first (and only) argument:

```bash
alias surge='surge $(cat ~/yt_api_key)'
```

### Play music

* `search` populates a `Vec` of 5 current results
* `cycle` cycles through
* `play <selection>` plays the selection immediately
* `queue <selection>` queues the selection
* `related` populates the `Vec` with 5 related videos
* `pause/play` pauses and resumes
* `stop` stops the player and clears the queue
* `loop` toggles loop mode

### Readline

Surge uses `rustyline` which is a pure-Rust implementation of GNU Readline. It supports command history and other readline goodies:

* Emacs navigation keys
* Ctrl-R for reverse search
* Up/down arrows to cycle through commands