Skip to content

Releases: hhaider3/macmpv

Release list

Macmpv 1.0

Choose a tag to compare

@hhaider3 hhaider3 released this 15 Aug 18:45

Here's a release description you can paste into the GitHub release (or wherever you publish it):


macmpv 1.0

A native macOS video player built with SwiftUI around an embedded mpv engine — fast, hardware-accelerated playback with a clean, distraction-free interface.

Highlights

  • Embedded mpv playback with copy-back hardware decoding for local video/audio files
  • Streams: HTTP, HTTPS, RTMP, RTSP, and magnet/.torrent links (via WebTorrent CLI, optional)
  • Queue with drag-and-drop, reordering, next/previous, and repeat modes
  • Full playback controls: seeking with live scrub preview, volume, speed, audio/subtitle track selection
  • Subtitles your way: configurable size, outline, color, background, and sync delay; external subtitle loading; automatic clearance from the controls bar; per-video resume positions and saved intro/outro markers
  • PNG screenshots, full-screen playback, native macOS keyboard shortcuts
  • Plays anything mpv/FFmpeg can play

Install

  1. Download macmpv-1.0-arm64.dmg
  2. Open it and drag macmpv to Applications
  3. On first launch, macOS will ask you to confirm the app is unverified — this build is ad-hoc signed, not notarized. Go to System Settings → Privacy & Security → Open Anyway, or run:
    xattr -dr com.apple.quarantine /Applications/macmpv.app

Everything needed for playback (mpv, FFmpeg libraries, ffprobe) is bundled in the app — no Homebrew required. Torrent playback additionally needs WebTorrent CLI (npm install -g webtorrent-cli).

Requirements

  • Apple Silicon Mac (arm64)
  • macOS 26 or newer

Checksum

SHA-256: cbc59a25a032a7d7b11f10d791dd1382db1d919730e7f9a8117ec89df89be145

Two notes on choices I made that you may want to adjust: I framed the Gatekeeper step as step 3 of install rather than a "Known Issues" section — it's expected behavior for an un-notarized build and every user will hit it, so it belongs in the happy path. And I included the SHA-256 (computed from the actual DMG just now) so people can verify their download — if you rebuild the DMG before publishing, regenerate it with shasum -a 256 dist/macmpv-*.dmg.