Files
GameAndWatch_MiSTer/docs/platform_installation.md
Brendan Saricks 50a6927ebc Vibed Take One
2026-05-11 20:46:43 -05:00

69 lines
3.0 KiB
Markdown

# Platform-Specific Installation
* [ROMs](#roms)
* [Analogue Pocket](#analogue-pocket-1)
* [MiSTer](#mister-1)
## ROMs
ROMs must be generated from their MAME counterparts. The generator source is included in [`rom generator/`](../rom%20generator); see [ROM Generator](rom_generator.md) for more information.
----
### Analogue Pocket
All ROMs are placed in `/Assets/gameandwatch/common/`
----
### MiSTer
All ROMs are placed in `/games/Game and Watch/`
## Analogue Pocket
### Easy Mode
I highly recommend the updater tools by [@mattpannella](https://github.com/mattpannella), [@RetroDriven](https://github.com/RetroDriven), and [@neil-morrison44](https://github.com/neil-morrison44). Choose one of the following updaters:
* [Pocket Updater](https://github.com/RetroDriven/Pocket_Updater) - Windows only
* [Pocket Sync](https://github.com/neil-morrison44/pocket-sync) - Cross platform
* [Pocket Updater Utility](https://github.com/mattpannella/pocket-updater-utility) - Cross platform, command line only
Any of these will allow you to automatically download and install openFPGA cores onto your Analogue Pocket. Go donate to the creators if you can
----
### Manual Mode
Visit [Releases](https://github.com/agg23/fpga-gameandwatch/releases) and download the latest version of the core by clicking on the file named `agg23...-Pocket.zip`.
To install the core, copy the `Assets`, `Cores`, and `Platform` folders over to the root of your SD card. Please note that Finder on macOS automatically _replaces_ folders, rather than merging them like Windows does, so you have to manually merge the folders.
See [ROMs](#roms) to install the correct ROMs and have a booting core.
## MiSTer
### Easy Mode
#### Update All
Open the [Update All](https://github.com/theypsilon/Update_All_MiSTer) settings menu, the `Unofficial Cores` submenu, and enable `agg23's MiSTer Cores` from there. [Visit the Update All page](https://github.com/theypsilon/Update_All_MiSTer) for more information on how to set up the script
#### Downloader
You can manually add my cores to the [MiSTer Downloader](https://github.com/MiSTer-devel/Downloader_MiSTer) script to automatically fetch all of my cores on release.
To start receiving my cores, simply paste the following snippet at the bottom of your `downloader.ini`. This will add my database to the list of locations MiSTer Downloader checks for updates from:
```
; This allows you to continue to receive main MiSTer downloads
[distribution_mister]
[agg23_db]
db_url = 'https://github.com/agg23/mister-repository/raw/db/manifest.json'
```
### Manual Mode
Visit [Releases](https://github.com/agg23/fpga-gameandwatch/releases) and download the latest version of the core by clicking on the file named `agg23...-MiSTer.zip`.
To install the core, copy the `_Console` and `games` folders over to the root of your SD card. Please note that Finder on macOS automatically _replaces_ folders, rather than merging them like Windows does, so you have to manually merge the folders.
See [ROMs](#roms) to install the correct ROMs and have a booting core.