Guide

Clamshell documentation

How to set up and use Clamshell, the controller-first home screen and game library for Android handhelds.

Clamshell is a home screen and game library for Android handhelds, phones and TV boxes. You can use all of it with a controller. It works on one screen, and on two-screen handhelds like the Retroid Pocket Duo Lite.

New here? Start with Getting started.

Guides

Getting started: install, set up your ROM folder, pick emulators and make

Clamshell your home screen.

Home and navigation: layouts, buttons, the Start menu and search.
Two screens: for two-screen handhelds. Which screen you browse on, where games

open, and what the other screen shows while you play.

Art and game info: box art and descriptions, and an easy way to enter

API keys.

RomM: browse and download games from your own RomM server (patron builds).
Saves: syncing RetroArch saves with RomM, and how to quit RetroArch without losing

your place.

Desktop: the desktop app for macOS, Windows and Linux. Not released yet.
FAQ and troubleshooting: fixes for common problems, and how to report

a crash.

Get help

Ask on Discord, or see what Clamshell sends online in the privacy statement.