Plays the current Apple Event (live or replay) in mpv, mpv.net or the mpv app on Android.
Apple Event Streamer VOD
Choose a stream
Video 1/4
❯ SDR H.264 / AVC
SDR [HEVC] H.265 / HEVC
HDR10 HEVC · PQ
Dolby Vision HEVC · Profile 5
↑/↓ move · enter select · ← back · q quit · mouse: click, wheel, right-click back
‹ Back Quit
You need mpv, or mpv.net on Windows, or Termux and the mpv app on Android. Download the app from Releases, then:
apple-event-streamer # pick a stream from a menu
apple-event-streamer --best # highest-bitrate SDR + AAC stream
apple-event-streamer --list # list every streamDownload the archive for your system, extract it and put
apple-event-streamer somewhere on your PATH.
| System | Archive | Needs |
|---|---|---|
| Windows x64 / arm64 | …_windows-amd64.zip, …_windows-arm64.zip |
Windows 10 or later |
| macOS (Intel and Apple silicon) | …_darwin-universal.tar.xz |
macOS 12 Monterey or later |
| Linux x64 / arm64 | …_linux-amd64.tar.xz, …_linux-arm64.tar.xz |
any distribution |
| Android x64 / arm64 | …_android-amd64.tar.xz, …_android-arm64.tar.xz |
Android 6 or later, Termux, the mpv app |
Each archive comes with a .sha256 file. Check it with
sha256sum -c <archive>.sha256, or shasum -a 256 -c <archive>.sha256 on
macOS. On macOS, see Troubleshooting if the app won't
open.
On Android, extract the archive in Termux. uname -m says aarch64 for arm64
and x86_64 for x64. Android 6 needs an apt-android-5 build of Termux from
its releases.
apple-event-streamer [options] [-- player options]
| Option | What it does |
|---|---|
--best |
Pick the highest-bitrate SDR + AAC stream (or the --range/--audio given) without the menu. |
--range sdr|hevc|hdr10|dv |
Video type: SDR (H.264), SDR [HEVC], HDR10 or Dolby Vision. Skips that step. |
--audio aac|atmos |
Audio: AAC stereo or Dolby Atmos. Skips that step. |
--max-res RES |
Highest resolution to offer, e.g. 1080, 1440p, 4k. |
--subs |
Add a subtitles step to the picker. Not with --best. |
--sub-lang LANGS |
Include these subtitle languages, e.g. en or en,fr. en also matches en-GB. |
--all-subs |
Include every subtitle language. |
--ad |
Use audio description instead of the normal audio. |
--asl |
Play the American Sign Language version. |
--list |
Print every stream and exit. |
--url URL |
Use this master playlist (a URL or a file) instead of finding the event. |
--timeout SEC |
Network timeout in seconds. Default 20. |
--no-launch |
Write the playlist and print its path, but don't play it. |
--keep-playlist [FOLDER] |
Keep the playlist in your Downloads folder, or in FOLDER. |
--mpv PATH |
Use this mpv. |
--mpvnet PATH |
Use this mpv.net. |
-v, --verbose |
Print details of what's happening. |
--version |
Print the version. |
-h, --help |
Show help. |
-- ARGS |
Pass everything after -- to the player, e.g. -- --fs --volume=70. Not with the mpv app. |
Examples:
apple-event-streamer --best --range dv --audio atmos
apple-event-streamer --best --sub-lang en --ad
apple-event-streamer --best --keep-playlist Videos/PlaylistsUse ↑/↓ or j/k to move, Enter or → to choose, ←, Esc or
Backspace to go back, 1–9 to choose directly and q to quit. The mouse
works too. On Android, swipe to move, and tap a row to choose it or empty space
to choose the highlighted row.
Video types the event doesn't have (e.g. HDR10 for live events) are greyed out.
On Windows the app uses mpv.net if it's on your PATH, and mpv if not. On
macOS and Linux it uses mpv. It also looks in common install folders, such as
/Applications/mpv.app.
The player runs in the same terminal, and the app exits when it does.
On Android it opens the mpv app and exits once mpv has loaded the stream.
Playback carries on. --mpv PATH uses mpv from Termux instead, in the same
terminal.
The playlist is deleted when the player closes. Playlists left behind by a
killed run, or written by --no-launch without --keep-playlist, are
deleted the next time the app makes a playlist, once they're a day old.
--keep-playlist keeps it in your Downloads folder, or in the folder you give
(created if missing). On Android the Downloads folder is ~/storage/downloads.
The mpv app gets the playlist from 127.0.0.1, so no file is written unless
you ask for one.
Install mpv (brew install mpv on macOS), or mpv.net on Windows, or pass
--mpv PATH.
Not every build of Termux comes with xz. Run pkg install xz-utils.
Install the mpv app, or pass
--mpv PATH to use mpv from Termux.
--keep-playlist uses the link to your Downloads folder that Termux makes. Run
termux-setup-storage once, or name a folder.
The app isn't notarized, so macOS blocks copies downloaded with a browser. Run
xattr -d com.apple.quarantine apple-event-streamer, or download with curl.
The stream only appears shortly before the event starts.
Subtitles are off by default. With --all-subs none is selected; press j in
mpv, or tap the subtitles button in the mpv app.
Run with --verbose and include the output in an
issue.
See CONTRIBUTING.md for building, CI and releases.