Help: Analogue Pocket (Game Boy, GBA)

Console guide

Analogue Pocket

Earn achievements on the Analogue Pocket with your original Game Boy, Game Boy Color and Game Boy Advance cartridges or backups you made of them. Here Cheevotron runs entirely on the Pocket: a Cheevotron openFPGA core checks the achievements while you play and pops up each unlock on the Pocket's screen with a short chime. No phone needed while you play.

Your unlocks are kept on the Pocket's SD card, encrypted. Whenever you like, connect the Pocket to your phone or computer with a USB-C cable and sync them to your Cheevotron profile.

What you need

  • An Analogue Pocket with Pocket OS 2.1 or later, for its USB SD Access.
  • Your Game Boy, Game Boy Color or Game Boy Advance cartridges, or backups you made of your own cartridges.
  • The Game Boy Color BIOS file gbc_bios.bin, dumped from your own Game Boy Color.
  • An Android phone with the Cheevotron app, or a computer with Chrome or Edge, and a USB-C data cable to the Pocket (or a card reader for its SD card).

Syncing with the app

The first sync sets the Pocket up. After that, sync whenever you want your unlocks on your profile.

  1. On the Pocket, turn on USB SD Access.
  2. Connect the Pocket to the phone with the USB-C cable.
  3. In the app, open Settings › Pocket and choose Choose the Pocket's SD card. Pick the Pocket's card in the list Android shows and allow access. The sync starts right away.
  4. When the app says it's done, unplug the cable.

Each sync uploads your unlocks to your Cheevotron profile, installs or updates the Cheevotron core on the card, and downloads the latest achievement sets. The app remembers the card, so next time Sync now is all it takes. No Pocket tab in the settings? Add the Pocket in Settings › General › Your consoles.

An SD card reader on the phone works too: put the Pocket's card in the reader and pick it the same way.

Sync from a computer

The setup page syncs the Pocket from Chrome or Edge on a Windows, Mac, Linux or ChromeOS computer. It does what the app does: it sends your unlocks to your profile, installs or updates the Cheevotron cores and downloads the latest achievements. Sync from the computer or the app, whichever is at hand: each picks up where the other left off.

  1. Open the setup page on the computer, choose Sync the Pocket under Analogue Pocket and sign in.
  2. On the Pocket, turn on USB SD Access and connect it to the computer with a USB-C data cable. Or take the Pocket's SD card out and put it in a card reader.
  3. Choose Choose SD card and pick the card's top folder, the one with Analogue_Pocket.json in it. Allow Chrome or Edge to make changes. The page shows which core version is on the card and whether a BIOS is missing.
  4. Choose Sync and keep the tab open until the page says it's done. It shows how many unlocks went to your profile and whether the cores and achievements on the Pocket are up to date.
  5. Eject the card on the computer before you unplug the Pocket or take the card out.

The page writes only Cheevotron's own folders on the card (listed under Updating and removing), and the Game Boy and Game Boy Advance files in Platforms where the card has none yet. Your unlocks stay on the card until your profile has them: if the page can't reach Cheevotron, they wait for the next sync. Safari, Firefox and phones can't write to a folder you choose, so the page needs Chrome or Edge on a computer.

Playing

Start the Cheevotron GBC core on the Pocket.

  • Backups of your cartridges: put the backups you made of your own Game Boy and Game Boy Color cartridges in Assets/gbc/common on the SD card and pick one in the core.
  • Cartridges: insert a cartridge in the Pocket's cartridge slot and choose Play Cartridge in the core. The first time, the core reads the cartridge once to recognise it: a few seconds, with a progress bar. After that the game starts right away.

The core needs gbc_bios.bin, dumped from your own Game Boy Color, in Assets/gbc/common. The app warns you when it's missing.

On the Pocket

  • Ready chime: when the achievements become active, the Pocket plays a short rising chime.
  • Unlocks: each unlock pops up on the Pocket's screen with a rising "ding-ding" chime.
  • No phone needed: unlocks wait on the SD card, encrypted, until your next sync.
  • Challenges: Nuzlocke, Random Team and Speedrun runs need the app checking the rules while you play, so they don't work on the Pocket yet. Play them on the Chromatic or the Game Bub.
  • Pop-up style: each pop-up shows at the top right of the screen, with the chime and the ready message. Settings › Pocket › Pop-ups has no switches for them yet.

Achievement list

Press Y during a game, or choose Achievements (Y) in the Pocket's menu, to see the game's achievements. The game pauses, and the screen lists them with medal, title, points and description, and shows at the top how many you've unlocked and your points. Up and Down choose, Left and Right turn the page, L and R switch between ALL, LOCKED and UNLOCKED, and A opens the chosen achievement: its full text, points, whether it's unlocked and your progress where the game counts it. B goes back and Start returns to the game, which goes on where it stopped.

Sleep, Memories and fast-forward

  • Sleep: put the Pocket to sleep in the middle of a game, and the achievements carry on after it wakes up, including your progress towards them.
  • Memories: loading a Memory (a save state) pauses the achievements until you restart the game. This keeps achievements fair.
  • Fast-forward is off while achievements are active.

Game Boy Advance

The app installs the Cheevotron GBA core together with the Game Boy one.

  • Cartridges: insert a Game Boy Advance cartridge in the Pocket's cartridge slot and choose Play Cartridge in the core. Before the game starts, the core reads the cartridge into memory, with a progress bar. Your saves stay on the cartridge.
  • Backups of your cartridges: put the backups you made of your own Game Boy Advance cartridges in Assets/gba/common. A gba_bios.bin dumped from your own Game Boy Advance can go there too, but it's optional: the core has a built-in replacement BIOS. The first start of each game takes a few seconds while the core identifies it.
  • Achievements that read the save work with every kind of cartridge save. On a cartridge that saves to EEPROM, they wait until the game has read its save once.
  • The Pocket's FPGA is full, so the Cheevotron GBA core has no Memories and no sleep (the link cable works). For Memories or sleep, use the regular GBA core.

Tips

  • Start games faster: on the Pocket, turn off Settings › Analogue OS › Group openFPGA. The cores are then listed right in the main menu.
  • Sleep is the fastest way back into a game.

If something goes wrong

  • A red band at the top of the screen when the core starts: the achievement system couldn't start. Sync with the app; it reinstalls the files.
  • NO ACHIEVEMENTS YET – SYNC THE POCKET WITH THE APP: the Pocket has no achievement data yet. Sync it with the app.
  • NO ACHIEVEMENTS FOR THIS GAME YET: there's no achievement set for this game, or for this version of it, yet.

Updating and removing

Each sync puts the core the app carries on the card, so an app update brings the Pocket's next core with it. Settings › Pocket shows the version on the Pocket next to the app's and says when an update is waiting.

To remove Cheevotron, sync once more so no unlock stays behind, then delete these folders on the Pocket's SD card with a computer or a card reader: Cores/Cheevotron.GBC, Cores/Cheevotron.GBA, Assets/gbc/Cheevotron.GBC and Assets/gba/Cheevotron.GBA. Leave Platforms and your BIOS files in Assets/gbc/common and Assets/gba/common alone: other cores use them.

Open source

The Cheevotron core is open source under the GPL-3.0. It's based on budude2's openFPGA port of the MiSTer Gameboy core. Its full source code comes with the app: open Settings › General › Licenses and choose Save the core's source code.

Last updated November 20, 2026. Something unclear or wrong? Tell us at hello (at) cheevotron (dot) com and we'll fix the page.