In development · ahead of Alpha 0.1
Clamshell
A launcher for retro handhelds and two-screen devices
Clamshell finds your ROMs, downloads their art, and launches each game in the emulator you choose.
Features
A controller-first home screen and game library for Android handhelds, on one screen or two.
Home
Console is one row of big tiles with the selected game shown above. Grid is a grid you can zoom, rearrange, and sort into folders. XMB runs categories across the screen and games down. Minimal is a plain list in large type, with the focused line filled.
Screens
With two screens, one shows the selected game and the other is where you browse. Automatic puts Console and XMB on the top screen and Grid and Minimal on the bottom. Swap them in Settings › Screens.
Library
Point Clamshell at one ROM folder with a sub-folder for each system. It scans that folder and keeps the list up to date. Smart folders include Continue playing, Favorites, Never played, a folder per platform, and genre. Search covers every system.
Launch
Signed emulator definitions pick the app and the intent for each system. Set one emulator for a system, or override it for a single game. Updated definitions download on their own, so a launch fix does not wait on a new app build.
Art
Sources run in an order you set. Built in are SteamGridDB, ScreenScraper, Libretro thumbnails, and IGDB, plus art already on the device from Cocoon or ES-DE. Downloads run in the background, pause while a game is playing, and show progress on Home.
Your files
An optional data folder holds saved art, gamelist.xml exports, logs, and backups. Reinstall, point Clamshell at that folder, and the library comes back.
Controls
Every setting works with a gamepad. Button letters follow the Nintendo, Xbox, or PlayStation layout printed on the controller. Accounts and keys can be pasted from a phone by scanning a QR code. On the first screen, whichever button you press becomes OK. Using touch? Tap anywhere.
Look
Lagoon is the default theme. Lagoon Night is darker. Material You follows the wallpaper. Lite, Standard, and Rich match the device. Lite turns off video and blur. Change it in Settings › Performance.
In progress
RomM
The RomM add-on browses a RomM server and downloads games into the library. It is still in progress.
Screenshots
These are placeholders. Clamshell does not have public screenshots yet. Each frame says so on the glass.
Placeholder
Home
No screenshot yet
Placeholder
Top screen
No screenshot yet
Placeholder
Bottom screen
No screenshot yet
Placeholder
Game details
No screenshot yet
Devices
Clamshell measures the window. A wide screen and a near-square screen lay Home out differently, and a handheld it has never seen still gets a layout. It does not keep a list of supported model names.
A second display is picked up when it is built in or plugged in. That includes the AYN Thor, the Ayaneo Pocket DS, and the Retroid dual-screen add-on. The larger screen starts as the stage. You can swap the two.
Games that use two screens, such as DS, 3DS, and Wii U, can launch with both. Smart sends a game to the screen that fits its shape, and Clamshell can warn you before a widescreen game opens on the bottom screen.
Download
Clamshell is in development, ahead of Alpha 0.1. There is no public build yet, and early builds can change. Builds go to patrons before a public release.
Placeholder link. Nothing is published on the releases page yet. When a public build exists, this button will point at it.