Operation manual
Guide
Install on Nintendo Switch
You'll need a console running Atmosphère CFW and the homebrew menu.
- Download
GMCA.nrofrom the latest release and copy it tosdmc:/switch/. - Launch GMCA from the homebrew menu.
- 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).
- 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.vpkwith 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
| Gamepad | Keyboard | Action |
|---|---|---|
| A | space | Play / Pause |
| B | esc | Stop |
| Y | o | Toggle OSD |
| X | f4 | Menu |
| R / L | ] / [ | Seek forward / back |
| + | f1 | Video profile |
| RS | f2 | Video quality |
| LS | f3 | Playback 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.