ditty/README.md

56 lines
1.5 KiB
Markdown
Raw Normal View History

2020-01-08 23:38:41 +00:00
# ditty
[![Donate](https://img.shields.io/liberapay/receives/rocketnine.space.svg?logo=liberapay)](https://liberapay.com/rocketnine.space)
Audio player
## Features
- Uses a small amount of resources
- Files are read in chunks
- Remembers playing song and queue on exit
- Supports FLAC, MP3, OGG and WAV files
2020-01-08 23:38:41 +00:00
## Screenshot
2020-01-29 15:29:38 +00:00
[![](https://ditty.rocketnine.space/static/screenshot2.png)](https://ditty.rocketnine.space/static/screenshot2.png)
2020-01-08 23:38:41 +00:00
## Demo
If you are running Linux with ALSA, you can try ditty without installing:
2020-04-24 22:39:02 +00:00
```ssh -q ditty.rocketnine.space -p 20020 2> >(aplay --quiet)```
2020-01-25 18:02:25 +00:00
If you can't hear anything, you may need to specify which device ```aplay```
should use with ```-D```.
To list available sound devices, execute ```aplay -l```.
2020-01-08 23:38:41 +00:00
## Install
Choose one of the following methods:
### Download
[**Download ditty**](https://ditty.rocketnine.space/download/?sort=name&order=desc)
### Compile
2021-04-09 15:07:07 +00:00
```go get code.rocketnine.space/tslocum/ditty```
2020-01-08 23:38:41 +00:00
2020-01-22 22:54:55 +00:00
## Dependencies
* [faiface/beep](https://github.com/faiface/beep)
* [hajimehoshi/oto](https://github.com/hajimehoshi/oto)
* [mewkiz/flac](https://github.com/mewkiz/flac)
* [hajimehoshi/go-mp3](https://github.com/hajimehoshi/go-mp3)
* [jfreymuth/oggvorbis](https://github.com/jfreymuth/oggvorbis)
2021-04-09 15:07:07 +00:00
* [tslocum/cview](https://code.rocketnine.space/tslocum/cview)
2020-01-22 22:54:55 +00:00
2020-01-09 17:48:00 +00:00
## Documentation
2020-01-08 23:38:41 +00:00
2021-04-09 15:07:07 +00:00
See [CONFIGURATION.md](https://code.rocketnine.space/tslocum/ditty/src/branch/master/CONFIGURATION.md) for default keybindings.
2020-01-08 23:38:41 +00:00
## Support
2021-04-09 15:07:07 +00:00
Please share issues and suggestions [here](https://code.rocketnine.space/tslocum/ditty/issues).