finds.dev

BBBannon/Shoalcade

Repo for Shoal Cade - Jellyfin Plugin and Android app for retro gaming

View on GitHub

CGPL-3.0updated Nov 2026

// the take

Shoalcade is a Jellyfin plugin paired with Android and Windows apps that turn a self-hosted Jellyfin server into a personal retro-game library: your own ROMs for GB through 3DS (and now GameCube/Wii/PS2 on Windows) get downloaded for offline play, with saves synced back to the server. It's for Jellyfin admins who already run their own media server and want retro gaming folded into it rather than relying on a third-party cloud sync or a standalone emulator frontend.

The save-sync design is the real engineering here: full version history, explicit conflict prompts instead of silently picking a winner, pinning, and backups before any overwrite, across three clients and one server — that's the hard part of this kind of app and it's been thought through rather than bolted on. It leans on mature, well-tested libretro cores (mGBA, Mupen64Plus-Next, melonDS, PCSX ReARMed, PPSSPP, Azahar) plus Dolphin and PCSX2-derived cores for the new consoles rather than reinventing emulation. The security model is also more careful than you'd expect from a hobby project: every endpoint requires a Jellyfin login, there's a path-traversal guard on disc lists, the browser emulator runs sandboxed, and credentials are stored via Android Keystore / Windows DPAPI rather than plain tokens.

It's a zero-star, apparently single-maintainer project, and the author is upfront that the Windows app is a first release not yet widely tested on real hardware, with GameCube/Wii/PS2 support validated only against homebrew test programs rather than actual games — real-world reliability on the newest and heaviest-to-emulate platforms is unproven. There's no visible automated test coverage for the sync/conflict logic, which is exactly the part most likely to eat someone's save data if it's wrong. The surface area is large for one person to maintain long-term: a .NET Jellyfin plugin, an Android app with its own NDK/JNI shims per core, a separate Windows app, and a browser player via EmulatorJS, each needing to track upstream emulator core updates in lockstep. And several of the newer features (PS2, 3DS, GameCube/Wii) depend on BIOS/firmware files and specific decrypted ROM formats the user has to source and manage themselves, which raises the practical bar for getting anything beyond the simpler consoles actually working.

We read the README, the directory tree and a key source file in November 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
0
Forks
0
Language
C
License
GPL-3.0
Last commit
2 Nov 2026

// nearby

If Shoalcade isn't quite it.

All repos →