funkwlmpv/README.md

41 lines
1.8 KiB
Markdown
Raw Normal View History

2023-08-03 08:35:37 +00:00
# funkwlmpv
Just for fun. A simple TUI media player for FunkWhale instances. Writen on python
2022-03-29 23:47:33 +00:00
2022-11-08 21:03:22 +00:00
Features:
* Simple interface
2022-11-25 17:42:00 +00:00
* Listening to tracks
* Listening to radios (including users/libraries)
* Selecting and listening to albums
* Selecting and listening to artists
2022-11-08 21:24:59 +00:00
* Search by albums, artists
2022-11-25 17:42:00 +00:00
* Switching instance from the public list[1] and the official instances list network.funkwhale.audio (if avalaible)
* All other features are working 50/50
2022-03-29 23:47:33 +00:00
2022-11-25 17:42:00 +00:00
Dependencies:
2022-11-08 21:03:22 +00:00
* python3.9+
* [mpv](https://mpv.io)
* [fzf](https://github.com/junegunn/fzf)
2022-11-08 21:05:38 +00:00
2022-11-25 17:42:00 +00:00
Python dependencies:
2022-11-08 21:03:22 +00:00
```pip install -r requirements.txt```
2023-01-02 15:43:18 +00:00
Optional: brotli
2022-03-29 23:47:33 +00:00
### About cache folder
2023-08-03 08:35:37 +00:00
funkwlmpv has to cache tracks before playing (default disabled "enable_persistent_cache"). Cache is persistent and you should manage it manually because the (script/program) can't clean it automatically.
Cache structure: cache/domain.tld/[track uuid]
You can play tracks offline, example: mpv --shuffle cache/*/*
cache_helper.sh - it might be useful for compression cache (lossy: vorbis 128 kbps, no thumbnail)
2022-11-25 17:42:00 +00:00
Also, tnx Inex for his FunkWhale instance (set by default instance)
2022-04-02 16:21:25 +00:00
2022-11-10 00:31:36 +00:00
[1]**Warning:** may content _unofficial instances_
2023-03-02 18:00:31 +00:00
**Warning 2:** This software not userfriendly. Maybe developerfriendly.
2022-03-30 18:55:54 +00:00
2023-08-10 18:54:58 +00:00
___
Simular projects:
[funkblubber - Naiji's Funkwhale CLI tool writen on Dart](https://git.reisen.church/NaiJi/funkblubber)
[funkwhale-cli - Official Command line interface to interact with a Funkwhale server, writen on python](https://dev.funkwhale.audio/funkwhale/cli)
[funkwhale-cli (2) - Same as official, but rewriten on rust](https://gh.phreedom.club/SkyLeite/funkwhale-cli)
[HTTPDirFS - HTTP Directory Filesystem with a permanent cache, and Airsonic / Subsonic server support! Writen on C](https://gh.phreedom.club/fangfufu/httpdirfs)