You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
localhost_frssoft 706d7684dd So, I forgot add this file, oops... 7 hours ago
src So, I forgot add this file, oops... 7 hours ago
.gitignore Checks config; other changes 7 months ago
COPYING Removed license; added copying cc0 (public domain) 7 months ago
MIRRORS New sub mirror 3 months ago Warning about not userfriendly 3 months ago Fix cache helper script 3 months ago Recently listenings 7 hours ago
requirements.txt requirements 7 months ago


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

About cache folder

funkwhale-cli 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.