Mediagg Documentation

Your first minutes

AndroidiOS

What Mediagg plays, and the three ways to put something into it.

Mediagg is a player for media you already have. It provides no content of its own — no catalogue to sign up to, nothing to buy. What it does is put three very different libraries behind one player:

They share a library, a queue and a player, so a podcast episode and an album track can sit in the queue together and play one after the other.

The three ways in

A new install opens on Home, which has nothing to show yet and says so: Nothing playing yet. Anything you start, queue or download shows up here. Beside that is the way out of it — a Get Started button on Android, a + in the bar on iOS — and it opens Get started. It offers three things, which map onto the three libraries above.

OptionWhat it is for
Add a subscriptionFollow a podcast by name or by its address
Add a serverJellyfin, Subsonic, Plex, Emby or Audiobookshelf
Add a playlistAn m3u file on this device, or a station list from the web

You do not have to choose one. Most people end up with all three, and nothing about adding one closes off the others.

The music already on the device comes first, above those three, until it has been dealt with. On Android that is two rows, Request audio permissions for local media and Request video permissions for local media, and they go once answered. On iOS, where there is no device-wide library for an app to read, it is Add local media folder — Read a folder of music straight into this device's library.

Nothing is added for you. Mediagg starts genuinely empty — there are no suggested podcasts and no sample content. The way into Get started stays on Home only until a shelf has something on it.

Where things go afterwards

Whatever you add, it lands in the Library, filed by what kind of thing it is. A podcast goes under Subscriptions, a server under Media servers, a station playlist under Subscriptions too — on its own Providers chip.

Once there is something in the library, Home becomes the screen worth opening: it puts what you were in the middle of, what has just arrived, and a few things to try at the top of the app.