Initially created by Eliot Berriot as a personal project in 2015, Funkwhale evolved in a community-driven project that lets you listen and share music and audio within a decentralised, open network. Likewise Pleroma and Peertube, Funkwhale implements the Activity Pub protocol to federate instances, allowing Nomagic users to follow other people's library.

Funkwhale code of conduct is often cited in online communities as an example of a well-written set of guidelines and rules to be applied for healthy exchanges in a community.

Official documentation

Nomagic documentation

The official documentation is complete and should provide everything necessary to get started.

Here we will provide 2 different ways to convert your music on GNU/Linux, either from a CD (Compact Disc) or from a FLAC (Free Lossless Audio Codec, and open format) file to an OGG Vorbis file, which is our personal recommendation to store music on your Funkwhale account on Nomagic.

OGG Vorbis is an open audio format for lossy audio compression. It has a better size/quality ratio than the popular proprietary format MP3.

We recommend to use a compression quality of 5. A quality of 1 is extremely lossy, 5 is considered enough for audio transparency, and from 7 onwards it is pretty much impossible to notice any difference compared to a lossless version of the file.

Converting from a CD

On GNU/Linux, we recommend to use the soundjuicer application. Ideally, if you have enough storage for it, we recommend to extract the CD in FLAC, so that you can have exactly the same quality from your computer than from the CD itself (and you can further gift the CD to someone else 😉).

From then you will have a set of FLAC files, that you can now convert to OGG Vorbis, because storage space on our instance is limited to 3 GB, and files in FLAC format would fill that space very quickly!

Transcoding to OGG Vorbis

Depending on how familiar you are with the terminal, you can either use oggenc from the command-line, or alternatively use SoundConverter from the Gnome project. On Windows™, we found FOSS applications such as flacsquisher and free:ac (not tested).

  • Using SoundConverter
  1. Install package soundconverter via your software manager
  2. Open the software and select your preferred quality for the transcoding. We tested with 'Normal', and couldn't hear a difference from the recommended quality 5. Looking at the file size, Normal setting results in a slightly lower file size than the equivalent from the command-line tool.

After opening the application, select Preferences, choose where to export transcoded file, and select your level of quality for transcoding.

  • Using command-line tool oggenc

The tool is very simple to use. Here below is one possible way to do mass conversion from FLAC to OGG Vorbis could be:

  1. Install package vorbis-tools using your package manager
  2. Tag all your FLAC files using Music Brainz Picard
  3. Assuming all FLAC files are into sub-directories of path /home/myuser/Music/FLAC, the following command will convert all FLAC files to ogg, putting everything in /home/myuser/Music_converted
test -d "/home/${USER}/Music_converted"  || mkdir /home/${USER}/Music_converted
find /home/${USER}/Music -type f -iname "*.flac" -exec oggenc -q 5 '{}' \;
find /home/${USER}/Music -type f -iname "*.ogg" -exec mv '{}' /home/${USER}/Music_converted/ \;


Can I just upload in FLAC?

You can, but ideally you shouldn't, for yourself and others' sake. Funkwhale will accept it and play it for you, however you will very quickly fill up your 3GB limit. Also, this will take significantly more bandwidth than a normal Ogg Vorbis file while transfering. Cumulated with Peertube viewings and a few video-conferences on Jitsimeet, we could drift toward a bottleneck on the network.

I deactivated transcoding to not hamper CPU, so the other side effect is the amount of data that will be downloaded. If you have a limited data plan, you will be 'burning' it by playing your music on the move, as a FLAC albums can quickly reach 600 MB to 1 GB or more.

How to subscribe to an RSS podcast feed?

Say you found the RSS feed for a podcast you want to follow and listen from the comfort of Funkwhale, for example: (SUBSCRIBE link at the bottom right corner of each podcast will reveal the RSS feed URL).

Connect to and authenticate, then go to Channels and select + Add new

Paste the RSS podcast feed URL you want to subscribe to and select Subscribe.

That's it! Your newly subscribed podcast will show instantly.

Select it to see the list and details of available episodes.