Manage your Analogue Pocket from the terminal.
Keep your ROMs on your computer and sync them to the SD card.
$
cargo install --git https://github.com/yilin-zhang/pocketeer
TUI
Run pocketeer with no arguments to open it.
◆ POCKETEER ● card · POCKET · fw 2.4 · 394.4 GiB free · 24 games 1 CORES 2 BIOS 3 GAMES 4 CARD / filter installed all updates not installed 8 ╭ CORES · 8 installed · 369 in inventory ────────────────────────────────────╮╭ DETAILS ───────────────────────────────────────╮ │ CORE PLATFORMS INSTALLED LATEST BIOS ││agg23.NES │ │▸ agg23.NES nes 1.0.1 up to dat ││Platforms nes │ │ agg23.SNES snes 0.4.3 → 0.4.4 ││Installed 1.0.1 │ │ budude2.Lynx lynx 1.0.1 up to dat 1 missin ││Latest 1.0.1 (2024-09-16) │ │ Spiritualized.GB gb 1.3.0 up to dat 1 missin ││Repo https://github.com/agg23/openfpga-NES │ │ Spiritualized.GBA gba 1.0.0 → 1.2.0 ││ │ │ Spiritualized.GBC gbc 1.3.0 up to dat ││ │ │ Spiritualized.Genesis genesis 1.0.8 up to dat ││ │ │ Spiritualized.GG gg 1.2.0 up to dat ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ ╰────────────────────────────────────────────────────────────────────────────────╯╰────────────────────────────────────────────────╯ › ✓ DATs checked, nothing new Enter install / update U update all x remove / search ? help q quit
◆ POCKETEER ● card · POCKET · fw 2.4 · 394.4 GiB free · 24 games 1 CORES 2 BIOS 3 GAMES 4 CARD / filter all missing or wrong 4 ╭ REQUIRED FILES · 2 present · 2 missing · 0 wrong · 1 placeable ────────╮╭ DETAILS ───────────────────────────────────────╮ │ CORE FILE STATUS NEED ││Core budude2.Lynx │ │▸ budude2.Lynx lynxboot.img missing required ││Slot BIOS │ │ Spiritualized.GB dmg_bios.bin at card root → p optional ││Path Assets/lynx/common/lynxboot.img │ │ Spiritualized.GBA gba_bios.bin present required ││Need required: the core won't run without │ │ Spiritualized.GBC gbc_bios.bin present optional ││it │ │ ││Status missing │ │ ││ │ │ ││pocketeer never downloads BIOS files. Copy yours│ │ ││to the root of the card with that exact file │ │ ││name, then press p to move it into place. │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ ╰────────────────────────────────────────────────────────────────────────────────╯╰────────────────────────────────────────────────╯ › ✓ DATs checked, nothing new p place files from card root / filter ? help q quit
◆ POCKETEER ● card · POCKET · fw 2.4 · 394.5 GiB free · 24 games 1 CORES 2 BIOS 3 GAMES 4 CARD / filter all in library on card card only not on card 26 ╭ LIBRARY · 24 games · 5 saves · 2 only on the card · ~/Pocketeer … ╮╭ Kirby's Dream Land (USA, Europe) ───────────────────╮ │ PLATFORM GAME WHERE DAT ART SIZE ││· · · · · · · · · · · · · · · · · · · · · · · · · · ·│ │▸ gb Kirby's Dream Land (USA, Europe). lib + card ✓ 256.0 KiB││ · · · · · · · · · · · · · · · · · · · · · · · · · · │ │ gb Super Mario Land 2 - 6 Golden Coi lib + card ✓ 512.0 KiB││· · · · · · · · · · · · · · · · · · · · · · · · · · ·│ │ gb Tetris (World) (Rev 1).gb lib + card ✓ 32.0 KiB ││ · · · · · no cover yet · · · · · │ │ gb Tetris DX (World) card 64.0 KiB ││· · · · · · · · · · · ·│ │ gba Advance Wars (USA) (Rev 1).gba lib + card ✓ 8.0 MiB ││ · · · · · b import a cover image · · · · · │ │ gba Castlevania - Aria of Sorrow (USA lib + card ✓ 8.0 MiB ││· · · · · · f fetch it · · · · · ·│ │ gba Fire Emblem (USA, Australia).gba lib + card ✓ 16.0 MiB ││ · · · · · F fetch the whole platform · · · · · │ │ gba Golden Sun (USA, Europe).gba lib + card ✓ 8.0 MiB ││· · · · · · C fetch everything missing · · · · · ·│ │ gba Kuru Kuru Kururin (Europe) card 128.0 KiB││ · · · · · · · · · · · · · · · · · · · · · · · · · · │ │ gba Legend of Zelda, The - The Minish lib + card ✓ 16.0 MiB ││· · · · · · · · · · · · · · · · · · · · · · · · · · ·│ │ gba Mario Kart - Super Circuit (USA). lib + card ✓ 4.0 MiB ││ · · · · · · · · · · · · · · · · · · · · · · · · · · │ │ gba Metroid Fusion (USA).gba lib + card ✓ 8.0 MiB ││· · · · · · · · · · · · · · · · · · · · · · · · · · ·│ │ gba Mother 3 (Japan).gba lib + card ✓ 32.0 MiB │╰─────────────────────────────────────────────────────╯ │ gba Pokemon - Emerald Version (USA, E lib + card ✓ 16.0 MiB │╭ DETAILS ────────────────────────────────────────────╮ │ gba WarioWare, Inc. - Mega Microgame$ lib + card ✓ 8.0 MiB ││Game Kirby's Dream Land (USA, Europe) │ │ gbc Legend of Zelda, The - Link's Awa lib + card ✓ 1.0 MiB ││Platform gb │ │ gbc Pokemon - Crystal Version (USA, E lib + card ✓ 2.0 MiB ││Card Both │ │ gbc Wario Land 3 (World) (En,Ja).gbc lib + card ✓ 2.0 MiB ││AP path Assets/gb/common/Kirby's Dream Land (USA, │ │ genesis Sonic The Hedgehog 2 (World) (Rev lib + card ✓ 1.0 MiB ││Europe).gb │ │ genesis Streets of Rage 2 (USA).md lib + card ✓ 2.0 MiB ││Identity Sampled │ │ nes Mega Man 2 (USA).nes lib + card ✓ 256.0 KiB││File Kirby's Dream Land (USA, Europe).gb │ │ nes Super Mario Bros. 3 (USA) (Rev 1) lib + card ✓ 384.0 KiB││Size 256.0 KiB │ ╰───────────────────────────────────────────────────────────────────────────╯╰─────────────────────────────────────────────────────╯ › ✓ DATs checked, nothing new a import S copy to card i from card e rename x remove t standard names d check DAT ? help q quit
◆ POCKETEER ● card · POCKET · fw 2.4 · 394.5 GiB free · 24 games 1 CORES 2 BIOS 3 GAMES 4 CARD ╭ CARD ──────────────────────────────────────────────────────────╮╭ MACOS JUNK ────────────────────────────────────────────────────╮ │Root /Volumes/POCKET ││Scanned only when requested. │ │Firmware 2.4 (built 20250911_101500) ││ c scan and review cleanup │ │Disk 394.5 GiB free of 926.3 GiB ││ │ │Cores 8 ││ │ │Inventory from cache, 1d old ││ │ ╰────────────────────────────────────────────────────────────────╯│ │ ╭ MANAGE ────────────────────────────────────────────────────────╮│ │ │25 ROM file(s) on this card ││ │ │ │╰────────────────────────────────────────────────────────────────╯ │ 3 manage ROMs on the Games tab │╭ RECENT ────────────────────────────────────────────────────────╮ │ V review save backups ││✓ DATs checked, nothing new │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ ╰────────────────────────────────────────────────────────────────╯╰────────────────────────────────────────────────────────────────╯ › ✓ DATs checked, nothing new V saves c clean junk ? help q quit
◆ POCKETEER ● card · POCKET · fw 2.4 · 394.5 GiB free · 24 games 1 CORES 2 BIOS 3 GAMES 4 CARD ╭ CARD ──────────────────────────────────────────────────────────╮╭ MACOS JUNK ────────────────────────────────────────────────────╮ │Root /Volumes/POCKET ││Scanned only when requested. │ │Firmware 2.4 (built 20250911_101500) ││ c scan and review cleanup │ │Disk 394.5 GiB free of 926.3 GiB ││ │ │Cores 8 ││ │ │Inventory from cache, 1d old ││ │ ╰────────────────────────────────────────────────────────────────╯│ │ ╭ MANAGE ────────────────────────────────────────────────────────╮│ │ │25 ROM file(s) on this card ││ │ │ ╭ Back up 2, restore 0 save(s)? ─────────────────────────────────────────╮────────────────────────────╯ │ 3 manage ROMs on the Game│ ← backup Saves/gba/common/Fire Emblem (USA, Australia).sav (new on AP) │────────────────────────────╮ │ V review save backups │ ← backup Saves/gba/common/Metroid Fusion (USA).sav (AP is newer) │ │ │ │ 2 backup(s), 0 restore(s), 0 conflict(s), 4 identical, 0 retained │ │ │ │ │ │ │ │ APPLY y CANCEL n / Esc │ │ │ ╰────────────────────────────────────────────────────────────────────────╯ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ ╰────────────────────────────────────────────────────────────────╯╰────────────────────────────────────────────────────────────────╯ › ✓ DATs checked, nothing new V saves c clean junk ? help q quit
Install and update cores from the openFPGA inventory.
See which BIOS files your cores are missing.
Your library and the card, side by side.
The card, its free space, and junk cleanup.
Every change is shown before it happens.
$ pocketeer cores list --outdated ID INSTALLED LATEST STATUS agg23.SNES 0.4.3 0.4.4 update available Spiritualized.GBA 1.0.0 1.2.0 update available $ pocketeer card copy "EarthBound (USA)" --dry-run + Assets/snes/common/EarthBound (USA).snes (3.0 MiB) Dry run: nothing was changed. $ pocketeer saves backup --dry-run ← backup Saves/gba/common/Fire Emblem (USA, Australia).sav (new on AP) ← backup Saves/gba/common/Metroid Fusion (USA).sav (AP is newer) 2 backup(s), 0 restore(s), 0 conflict(s), 4 identical, 0 retained Dry run: nothing was changed.
$ pocketeer --json cores list --outdated { "schema_version": 1, "ok": true, "data": { "cores": [ { "id": "agg23.SNES", "version": "0.4.3", "platform_ids": ["snes"], "latest": { "version": "0.4.4", "date_release": "2024-09-16" }, "update_available": true }, … ] } }
Get started
-
1
Install
With Rust installed:
cargo install --git https://github.com/yilin-zhang/pocketeer
-
2
Import your ROMs
By default the library is
~/Pocketeer Library.pocketeer library import ~/roms/gba --platform gba
-
3
Copy games to the card
Plug in the card. Run this, or press S on a game in the Games tab.
pocketeer card copy "Metroid Fusion (USA)"
-
4
Back up your saves
Saves are copied to the library, and older versions are kept. Or press V in the TUI.
pocketeer saves backup