Downloads

A free utility for updating the openFPGA cores, firmware, and a bunch of other stuff on your Analogue Pocket.

A complete list of available cores can also be found here: https://openfpga-cores-inventory.github.io/analogue-pocket/

I can't (and don't want to) support old versions, so please make sure you download the latest release before submitting any issues.

Easy Mode

If you just want to use this utility, do not clone the source repository. Just download the latest release. Unzip it, put the executable file for your platform (windows, mac os, or linux) in the root of your sd card, and run the program.

At the main menu run Settings to have it walk through the available settings for you.

Interactive Console Menu

For a full view of the interactive console menu, see here.

RTFM

Update All

Install/Update all of your cores, plus a bunch of other stuff. It can basically be used as the "do everything I want" option. Everything marked with a * can be turned on/off via settings.

Checks for new firmware updates *
Compress and backup Saves and Memories *
Installs/updates every core you have selected
Checks for missing required assets for each core you have selected *
Deletes cores that you do not have selected *
Runs the instance JSON generator for each core you have selected (currently, only PC Engine CD) *
Rename every Jotego core you have selected *

Update Selected

Presents you with a list of your installed cores and lets you choose which ones you want to update.

Install Selected

Presents you with a list of cores you don't have installed and lets you choose which ones you want to install and then immediately installs them with having to run Update All.

Update Firmware

Self-explanatory. Just checks for firmware updates and exits.

Select Cores

This will prompt you to ask if you want new cores installed by default, with 3 options:

Yes
- Selecting this automatically chooses all existing cores, and will continue to automatically install new cores as they are released.
No
- Selecting this means as new cores are released, they will not be installed automatically, nor will you be asked about them. Then you will be presented with a list of all currently available cores, to select from for yourself.
Ask
- Selecting this means as new cores are released, you will be notified each time you run the app and have the option to select them for installation. Then you will be presented with a list of all currently available cores, to select from for yourself.

Download Assets

Checks for missing assets for each core you have selected (mainly arcade ROM files and BIOSes).

Note: You are responsible for finding and adding your own ROMs for non-arcade cores.

Backup Saves & Memories

This will compress the Saves and Memories directories from your Pocket to the location specified in the config settings.

Pocket Setup - Display Modes

Enable Recommended Display Modes

This enables a curates set of display modes and applies them to specific cores that you have installed. This list can be found in the display_modes.json file. If you wish to make changes to this file, download it from GitHub and place it in the same directory as the pupdate executable. Then set use_local_display_modes to true in your pupdate_settings.json file.

Enable Selected Display Modes for All Cores

This presents you with a list of all of the supported display modes and lets you select which ones you want to apply. Then it applies those display modes to all of the cores you have installed.

Enable Selected Display Modes for Select Cores

This presents you with a list of all of the supported display modes and lets you select which ones you want to apply. Next, you'll be asked to select which of your installed cores you want to apply the display modes to. Then it applies those display modes to the cores you have selected.

Reset All Customized Display Modes

This will reset all of the cores with customized display modes back to the original list that was specified by the core.

Reset Selected Customized Display Modes

This will reset the selected cores with customized display modes back to the original list that was specified by the core.

Change Display Modes Option Setting

This will prompt you to ask how you want to apply the display modes to the cores, with 3 options:

Merge
- Selecting this will merge the selected or recommended display modes with the ones specified by the core.
Overwrite
- Selecting this will overwrite the display modes specified by the core with the selected or recommended ones.
Ask
- Selecting this will ask you if you want to merge or overwrite the core specified display modes with the selected or recommended ones each time you run it.

Pocket Setup - Download Platform Image Packs

This will present you with a list of available image packs and automatically download and extract it to the Platforms/_images directory for you

Pocket Setup - Download Pocket Library Images

This will download the System Library Images that were published by Spiritualized1997. They are used for the Library functionality on the Pocket.

Pocket Setup - Download GameBoy Palettes

This will download the palette files for the Pocket GameBoy cartridges. This is currently maintained by davewongillies on GitHub and by R.A.Helllord on Discord and Reddit.

Contents:

All official GBC, SGB, NSO, and 3DS VC palettes
Custom palettes for all Limited Edition Pockets
SGB2 Vaporwave Edition palettes courtesy of flamepanther
Trashuncle's palettes for Mister
Sameboy and BGB palettes
Pipboy palettes (Amber, Green, Blue, and White)
300+ palettes covering a ton of systems and themes by TheWolfBunny64

Pocket Setup - Generating Instance JSON Files (PC Engine CD)

Only supported by PC Engine CD, currently
Put your games in /Assets/{platform}/common
Each game needs to be in its own directory (and be sure to name the directory the full title of the game)
Examples:
- /Assets/pcecd/common/Rondo of Blood
- /Assets/pcecd/common/Bonk
- etc
All games (for PC Engine CD) must be in cue/bin format. The generated json file will be saved using the same filename as the cue file, so be sure to also name that with the full title of the game
When you run the Generate Instance JSON Files or Update All menu items, it will search through every directory in common and create a json file that can be launched by the core
You can disable this process in Update All by setting build_instance_jsons to false in your settings file, if you don't want it to run every time you update.

Pocket Setup - Generate Game & Watch ROMs

How to build game and watch roms that are compatible with the Pocket:

Create 2 new folders.

/Assets/gameandwatch/agg23.GameAndWatch/artwork and /Assets/gameandwatch/agg23.GameAndWatch/roms

Place your [artwork].zip files into the artwork folder and your [rom].zip files into the roms folder

Should look like this:

/Assets/gameandwatch/agg23.GameAndWatch/artwork/gnw_dkong.zip

/Assets/gameandwatch/agg23.GameAndWatch/roms/gnw_dkong.zip

Now just run the menu option in the updater and it will build your games

Pocket Setup - Super GameBoy Aspect Ratio

This allows you to apply the 8:7 aspect ratio to any of the Super GameBoy cores you may have installed. When selected you will be asked which cores you want to do this for.

The 8:7 aspect ratio gives you a more 'full screen' look and feel on the Pocket.

You also have the ability to reset any of the Super GameBoy cores back to the original 4:3 aspect ratio.

Pocket Maintenance - Reinstall or Uninstall Cores

These give you the ability to reinstall all or select cores. The reinstall will erase and reinstall all core specific files and assets. It will not touch your ROMs or Save files.

If you wish to uninstall one or more cores, selecting 'Uninstall Select Cores' will allow you to choose which cores you'd like to remove. It will also prompt you to ask if you wish to remove

Pupdate

Install / Use

README