Add an M3U playlist and an XMLTV program guide to Mimir for scheduled recording of live internet channels. The server handles stream interruptions and recording repair; Apple TV, Android TV and the mobile apps give you the guide, live viewing and your saved programs.
Nearly every channel source in the world publishes these two formats. Individually each is close to useless. Joined up, they're a television.
A plain-text list of channels and where each one's stream lives, usually with a name, a group and a logo attached to every entry. It answers "what can I watch and where is it?", and nothing else. On its own you get a wall of channel names with no idea what's actually on.
An XML file of programs: titles, descriptions, categories, start and finish times, each tied to a channel identifier. It answers "what's on, and when?", but points at nothing playable. On its own it's a TV guide for channels you can't tune to.
It matches every channel in your playlist to its listings in the guide, then presents the result as a proper program grid you can search, browse and record from. Where the automatic match is wrong (and with real-world data it sometimes is), you can correct any channel's guide mapping by hand, without editing either source file.
Most M3U players hand you the list exactly as it arrived. Mimir treats the source as raw material and gives you a workspace to shape it.
Browse the source's groups and channels in one pane and your own filtered lineup in another, searching each independently, so picking channels out of a huge playlist doesn't mean losing your place.
Drag channels into the exact order you want and give them the numbers you want. What you set is what every device shows: browser, phone and television alike.
Rename a channel, move it to another group, replace a missing or ugly logo, correct its stream address or fix its guide mapping, all stored separately from the playlist itself.
Playlist and guide data refresh independently, daily or hourly. Every customisation you've made is re-applied on top afterwards, so a refresh never costs you an evening's tidying.
Run more than one playlist and more than one guide together, then drag them into a priority order that settles which listing wins when two cover the same channel.
Film and box-set catalogue entries are filtered out before live channels are indexed, so a source with tens of thousands of lines doesn't become an unusable list.
Channel numbers, names and order are yours, not whatever the playlist happened to ship with.
Setup is two addresses. In the source settings you paste the URL of your M3U playlist and the URL of your XMLTV guide, and Mimir fetches and indexes both. From that point the guide grid is populated and every channel is one click from playing or recording.
If your playlist and guide are files already sitting on the machine rather than URLs, that works too; a built-in path browser lets you pick them without typing a full path or copying files around. On Docker, mount the folder that holds them first (the download page shows the one-line mount) and it appears in the picker like any other folder.
An M3U playlist tells Mimir where to find each channel's stream. Attach an XMLTV guide and schedule a program with padding before and after its listed times. Recordings are saved as ordinary video files in a folder you choose, and you can start watching while capture is still in progress.
If the stream disconnects or stalls, Mimir retries until the scheduled end. When the source returns, capture continues. Recording finalisation checks the captured segments for timing discontinuities and repairs their joins for playback. This cannot recover video that the source never delivered. Read about stream recovery and recording repair.
Schedule and watch recordings from Apple TV, Android TV and NVIDIA SHIELD, or the iPhone, iPad and Android mobile apps. The server does the recording, so your viewing device can sleep while it continues.
Set the source's connection limit to match what it allows. Mimir checks scheduling conflicts and gives recording priority when capacity is tight.
Channels in an M3U carry an identifier that's supposed to match a channel in the XMLTV file. In practice sources are inconsistent: identifiers go missing, change without warning, or don't match the guide at all. When that happens the channel appears with no listings.
Mimir lets you set a channel's guide mapping by hand. Point the channel at the correct guide entry, and it stays pointed there, through every subsequent refresh, because your mapping is stored separately from the source data rather than written back into it.
This is the design decision that matters most day to day. Source data and your changes are kept apart. Playlists and guides update on their own schedules; your names, numbers, groups, logos, stream overrides and guide mappings are layered back over the fresh data every time. You set the lineup up once.
You can also export the entire configuration, every selection and every customisation, to a single versioned, checksum-verified file, and import it later. That's your backup before experimenting, and the way to move a finished setup to another machine.
A stream that isn't in any playlist can be added on its own, with a channel number, group, logo and guide mapping of your choosing. It sits in the lineup alongside everything else and records the same way.
These two formats are also how most networked TV hardware publishes itself. A SiliconDust HDHomeRun or VBox TV Gateway puts an aerial, cable or satellite feed onto your network and exposes it as a channel playlist, with VBox publishing a full XMLTV guide alongside it. To Mimir that's simply another source, which means hardware tuners and file-based sources can run side by side in the same lineup, with one guide covering both.
It supplies no channels, no playlists, no guide data and no content of any kind. You bring your own source, and you're responsible for holding the rights to whatever you stream or record. Mimir is the software half of a system whose other half is entirely your choice.
Free server for Windows, macOS and Docker. Add a source, pick your channels, and have a real guide and recorder running tonight.
No account · No subscription · No cloud
