Record M3U internet streams
on Apple TV
Schedule live channel recordings from Apple TV and watch them in Mimir. Your server records the M3U streams, handles interruptions and stores the video while the Apple TV app provides the guide and playback.
See the Apple TV recording demonstration
Watch Mimir on Apple TV on YouTube to see live viewing, the guide and recording options, followed by playback of a saved recovery test. The demo source was interrupted for 35 seconds, and Mimir resumed capture after it returned.
The uncut playback excerpt crosses the join in the captured footage. The missing interval remains a clock jump. Watch both recording demos and read the test explanation.
What you need before you start
- An Apple TV compatible with the Mimir tvOS app. Check the App Store for current requirements.
- A computer or Docker host running the free Mimir server, with storage for recordings.
- Your own M3U channel playlist and an XMLTV program guide for scheduling from listings.
- Apple TV and the server on the same network for discovery and initial pairing.
The server and browser interface are free. The Apple TV app requires a subscription, with a free trial to start. Check the App Store for local pricing, trial eligibility and renewal terms. Mimir supplies no channels or content.
1. Install the server and choose recording storage
Download Mimir Server for your host and follow the setup wizard in its browser interface. Choose a recordings folder with enough free space. Your Apple TV streams files from this library; recordings are stored on the server.
Keep the server running and disable sleep during recording hours. The server setup walkthrough shows the wizard screens.
2. Add your M3U playlist and XMLTV guide
Add the playlist and guide addresses in the server's source settings, or select files stored on the server. Choose the channels for your lineup and check that programs appear against the right channels. Correct guide mappings if listings are missing or incorrect.
Configure the playlist once on the server. You do not need to type a long M3U address with the Siri Remote. Learn how playlist and guide matching works.
3. Install Mimir on Apple TV and pair it
Install Mimir from the tvOS App Store. Open it on the same network as your server and select the discovered server. The TV shows a short pairing code; approve that device in the server's web interface from a phone or computer.
Apple TV then uses the channel lineup, XMLTV guide and recording library already configured on your server.
4. Schedule a program from the TV guide
Open a program in the Apple TV guide and choose its recording option. Adjust start and end padding to capture before or after the published listing. Check the schedule before the program begins.
The server performs the recording. Watch something else, close the app or let Apple TV sleep while it runs. The server must stay awake and connected to your source for the recording window.
5. Watch on Apple TV, Android TV or mobile
Open your recordings in Mimir to watch a completed program, or start an in-progress recording from the beginning. Your paired Android TV and iPhone, iPad and Android mobile apps access the same library, so you can resume on another screen.
Taking a flight? Download a completed recording to iPhone, iPad or Android through the mobile app before leaving, then watch offline on that device.
What happens if the internet stream disconnects?
Mimir retries the source until the scheduled end and resumes capture when video returns. It checks and repairs captured segments during finalisation. Missing footage stays missing, but a temporary interruption does not need to end the rest of your recording. Read how recording recovery works across all apps.
If a channel will not record
Check that the channel plays from the server's web interface. Confirm the source address works, guide mapping is correct, the recordings folder has room and the source has capacity for another channel. The server log helps explain a failed connection or capture.
If Apple TV cannot find the server, check both are on the same network and the host firewall permits Mimir. Contact Mimir support for help.
Try recording with your own channels
The server and browser interface are free. Native TV and mobile apps require a subscription, with a free trial to start. Mimir supplies no channels or content.