Go to file
localhost_frssoft ff42699870 deprecated 2024-05-19 21:35:34 +03:00
src jump by track number in player 2023-08-14 09:59:27 +03:00
.gitignore Checks config; other changes 2022-11-10 02:23:18 +03:00
.icon.txt Added funkwhale ASCII icon when starting 2023-06-15 23:55:45 +03:00
COPYING Removed license; added copying cc0 (public domain) 2022-11-23 02:46:01 +03:00
MIRRORS mirrors renamed 2023-08-03 11:51:42 +03:00 deprecated 2024-05-19 21:35:34 +03:00 Fix cache helper script 2023-03-01 01:14:23 +03:00
funkwlmpv renamed funkwhale-cli -> funkwlmpv 2023-08-03 11:35:37 +03:00
requirements.txt d34b6252f7 2023-08-14 10:00:42 +03:00
run run file for python virtual env 2023-11-08 01:52:56 +03:00



Just for fun. A simple TUI media player for FunkWhale instances. Writen on python


  • Simple interface
  • Listening to tracks
  • Listening to radios (including users/libraries)
  • Selecting and listening to albums
  • Selecting and listening to artists
  • Search by albums, artists
  • Switching instance from the public list[1] and the official instances list (if avalaible)
  • All other features are working 50/50


Python dependencies:
pip install -r requirements.txt Optional: brotli

For virtual env just type (ofc after install mpv, fzf, python3): ./run

About cache folder

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// - it might be useful for compression cache (lossy: vorbis 128 kbps, no thumbnail)

Also, tnx Inex for his FunkWhale instance (set by default instance)

[1]Warning: may content unofficial instances
Warning 2: This software not userfriendly. Maybe developerfriendly. Warning 3: This software optimized for my needs, this can be confuse you.

Simular projects:
funkblubber - Naiji's Funkwhale CLI tool writen on Dart
funkwhale-cli - Official Command line interface to interact with a Funkwhale server, writen on python
funkwhale-cli (2) - Same as official, but rewriten on rust
HTTPDirFS - HTTP Directory Filesystem with a permanent cache, and Airsonic / Subsonic server support! Writen on C