Mira Wiki FR

Start

Install on Mac

Install Mira on a Mac with the disk image or Homebrew, allow it the first time, and let it update itself.

  • macOS 15 or later
  • Apple silicon

Mira for Mac plays your Jellyfin library with the same mpv player as on Windows. It needs a Mac with Apple silicon (M1 or later) on macOS 15 Sequoia or later, and a Jellyfin server you already have: Mira for Mac does not install Jellyfin.

With the disk image#

  1. Download Mira-0.9.4-mac-arm64.dmg.
  2. Open it and drag Mira onto Applications.
  3. Open Mira from Applications. macOS stops it the first time: see below.

With Homebrew#

If you use Homebrew, one command in Terminal replaces steps 1 and 2:

brew install --cask sasou-web/mira/mira

It comes from Mira's own tap, sasou-web/homebrew-mira: Homebrew's main catalogue only takes apps notarised by Apple. Homebrew checks the image's SHA-256 and keeps macOS's protection, so the first opening is the same as below. Mira then updates itself; brew uninstall --cask --zap mira removes it with its settings.

Allow Mira the first time#

Mira is not signed with a paid Apple developer account, so macOS cannot check it and refuses to open it the first time. Once only:

  1. Open Mira, then close the message.
  2. Go to System Settings → Privacy & Security.
  3. At the bottom, next to "Mira was blocked", click Open Anyway, then confirm.

If macOS says Mira is "damaged", or the button does not appear, type this in Terminal:

xattr -dr com.apple.quarantine /Applications/Mira.app

It only removes the "downloaded from the Internet" mark from Mira. It changes no security setting of your Mac.

First sign-in#

Type your server's address (192.168.1.20, nas:8096…), your username and password. Mira finds the right port and protocol. Away from home, use the server's Tailscale address, or let Built-in Tailscale reach it without the Tailscale app.

Your password is never stored: Mira keeps only the session Jellyfin opens, in your Mac's keychain (item "Mira"). The rest is in ~/Library/Application Support/Mira, readable by your macOS account only.

Updates#

Mira updates itself. When it opens, then every 6 hours, it asks GitHub for a new version, downloads the disk image and keeps it only if its size and SHA-256 match the release's signed manifest. It installs it when you quit Mira, or right away with Restart in the notice.

Mira cannot replace itself when it runs from the disk image, from the Downloads folder (macOS runs a protected copy), or from a folder your account cannot change. It still downloads and checks the new version, and Open the disk image lets you drag it to Applications.

To stop the automatic check, turn off Settings → Mira on this Mac → Update automatically.

Trackpad#

Mira follows your trackpad settings (natural scrolling, swipe between pages).

  • In the library: swipe with two fingers to go back and forward, pinch to change the size of the posters, force click a poster for its menu.
  • In the player: swipe left or right to seek, up or down for the volume; spread two fingers for full screen, pinch to leave it, then to shrink the player to the mini player.

Start over#

Sign out first (Settings → Account & server), quit Mira, then delete ~/Library/Application Support/Mira.