Operation manual

Guide

Install on Nintendo Switch

You'll need a console running Atmosphère CFW and the homebrew menu.

  1. Download GMCA.nro from the latest release and copy it to sdmc:/switch/.
  2. Launch GMCA from the homebrew menu.
  3. On first launch in applet mode, GMCA offers to install a HOME menu tile: press the button, confirm, and the app relaunches as a regular title with full memory. Alternatively, hold R while launching any game (title takeover).
  4. Add your media server (see Connect a server) and start watching.

Coming from pleNx? GMCA reads your existing library, logins and downloads automatically on first launch, nothing to re-configure.

PS Vita, Raspberry Pi & desktop

Every release ships builds for all supported platforms, with fresh nightly artifacts on nightly.link.

PS Vita
Install GMCA.vpk with VitaShell, or find GMCA on VitaDB, for jailbroken consoles.
Raspberry Pi / Linux
Flatpak bundles for x86_64 and arm64v8 (OpenGL 3), plus an Arch package. Wire a Pi to the TV with a controller or keyboard for a full 10-foot media center.
macOS
DMG for Intel and Apple Silicon, macOS 10.15+. If Gatekeeper refuses to open the app, clear the quarantine attribute:
sudo xattr -rd com.apple.quarantine /Applications/GMCA.app
Windows
Portable 7z archives for x64, x86 and ARM64 (Windows 7 or later, DirectX 11.1).

Connect a server

On first launch, pick a backend. The same interface follows whichever you choose.

Plex
Enter the 4-character code shown on screen at plex.tv/link, then pick your server and your Plex Home profile (PIN-protected profiles supported).
Jellyfin / Emby
Type your server URL, then authenticate with Quick Connect (no keyboard) or your username and password.
Stremio
Log in with your Stremio account. Your add-on catalogues and library sync across your devices. Streams play from direct links or your configured debrid service.
File servers
Add a WebDAV, FTP, SFTP or HTTP(S) share straight from the UI, with a connection test before saving. USB drives work too on Switch.

Controls during playback

GamepadKeyboardAction
AspacePlay / Pause
BescStop
YoToggle OSD
Xf4Menu
R / L] / [Seek forward / back
+f1Video profile
RSf2Video quality
LSf3Playback speed

Anywhere in the app, press X (or long-press) on a poster to open the quick actions panel: go to show, go to season, mark watched, download, add to your list.

System requirements

  • Nintendo Switch:Atmosphère CFW, full-memory mode for playback
  • PS Vita:HENkaku/h-encore jailbreak
  • Raspberry Pi / Linux:Flatpak (x86_64 / arm64v8), OpenGL 3 support
  • Windows:Windows 7 or later, DirectX 11.1 support
  • macOS:10.15 or later, Intel or Apple Silicon

MPV decodes H.264, H.265, VP8, VP9 and AV1 video; Opus, FLAC, MP3, AAC, AC-3, E-AC-3, TrueHD and DTS audio; and SRT, VTT, SSA/ASS and DVDSUB subtitles. Anything your hardware can't direct-play, a Plex/Jellyfin/Emby server transcodes.

FAQ

Is this pleNx? What happened to it?

GMCA is the evolution of pleNx: same app and team, renamed as it grew from a Plex-only client into a multi-backend one (Plex, Jellyfin, Emby, Stremio). Existing pleNx installs migrate their data to GMCA automatically on first launch.

Subtitles don't show up on Switch?

Drop any TrueType font at sdmc:/switch/GMCA/subfont.ttf; it will be used to render text subtitles.

macOS won't open the app?

Gatekeeper quarantines unsigned apps downloaded from the internet. Clear the attribute:

sudo xattr -rd com.apple.quarantine /Applications/GMCA.app
How do I enable an external USB drive on Switch?

Set ums in config.json (in sdmc:/switch/GMCA/):

{
  "setting": {
    "ums": true
  }
}
Is GMCA affiliated with Plex, Jellyfin, Emby or Stremio?

No. GMCA is an independent, open-source, third-party client, not affiliated with or endorsed by any of them. It talks to your server with your own account.

Where do I report a bug?

On the GitHub issue tracker. Describe what you did, what happened, your backend, and your device model. On desktop, launching the app with -d -o gmca.log writes a debug log you can attach.

B Back home A Download