Mediagg Documentation

Using it day to day

The dashboard, adding films and series, requests, downloads, updates, keeping the computer awake and the password.

Adding a film or a series

Either way it is downloaded, moved into your library, and appears in Jellyfin and Mediagg by itself. It needs indexers in Prowlarr first — see Setting it up.

The dashboard

Open it at the address the install command printed — http://localhost:7979 on the computer itself, or its network address for one with no screen — and sign in with your server's name and password.

The sidebar has Home and How to use; under Library, Films & Series, Music and Audiobooks & Podcasts; under Server, Downloads, Requests, Indexers, Media folders, People, Devices and Settings; and Pair a phone or TV. The bar above every page says how the services stand — All 9 running, say — and has the dashboard's address with Copy, Help and Sign out.

Turning things on and off

Each part of your library has its own page, with its switches — for Films & Series Watch, New episodes, New films, Requests and Subtitles; for Music Listen, New albums and Requests for music. A switch that is on has Open, for the service behind it. Turning one on installs what it needs, and asks first when that brings something else along. Turning one off asks too, says what goes with it, and keeps its settings for when you turn it on again — its ••• has Turn off and delete its settings. The last place to watch or listen cannot be turned off.

Paired phones and TVs pick up what you turn on by themselves.

Downloads

What is coming in, newest first, with how far each has got and the time left. Each one moves into your library by itself when it is done.

Requests

With Requests on, Requests lists what has been asked for and where each one is — Pending approval, Searching, Downloading 40%, Available. It shows yours; Asked for by switches to Everyone, or to one person. The sidebar says how many are pending.

Whether someone's requests wait for you is set for each person under People.

Updates

When a new version is out, the dashboard says so — Mediagg Server 0.12.0 is out — with an Update to 0.12.0 button. Updating restarts the dashboard; the services keep running and nothing you have changes. Whatever an older version did not set up is put right as the new one starts, with no need to repair. If the new version runs newer, tested versions of the services, an Updates for card follows, naming them, with Update services. Each restarts, and its settings stay.

It looks for a new version by itself every six hours; Check for updates, under Settings, looks now. Running the install command again does the same as updating.

Keep this computer awake

A sleeping computer serves nothing: your phone and TV cannot play, and downloads stop. The switch under Settings — Keep this Mac awake, or Keep this computer awake on Linux — stops it going to sleep by itself; the screen still turns off, so it costs little. Turn it off whenever you like.

It cannot stop everything: on battery it may still sleep to save power, and closing a laptop's lid may sleep it anyway.

A computer that never sleeps, like most home servers, does not need it.

After a restart every service starts again by itself — on a Mac once you sign in, when Docker Desktop starts; on Linux with the computer, before anyone signs in. On a Mac, Start with this Mac, under Settings, turns that off: Docker Desktop is then no longer opened for it when you sign in.

Change the password

Change password, under Settings, changes it for the dashboard and every service at once. Paired phones and TVs pick it up by themselves.

Forgotten it? It is in MediaggStack/manager/state.json in your home folder, which only your account can read. That file also holds every service's API key.

Watching away from home

Not yet. The server is reachable on your home network only; remote access is planned.