muOS Base/Extra Core + Builder

This script builds and packages libretro cores defined in data/core.json for muOS.
It supports full builds, selective builds, exclusions, repository purging, cache control, and update archive generation.

---

Build All Cores

To build all cores defined in data/core.json:

./build.sh -a

Build Specific Cores

To build only selected cores, specify them after -c:

./build.sh -c dosbox_pure sameboy

Multiple cores may be listed, separated by spaces.

Exclude Specific Cores

When building all cores, you may exclude specific ones using -x:

./build.sh -a -x fbneo mame2010

This builds everything except the listed cores.

Purge Existing Core Repositories

To delete existing cloned repositories before building, use -p.

./build.sh -p -a

Or with specific cores:

./build.sh -p -c dosbox_pure sameboy

This removes cloned core repositories before proceeding.

Force Rebuild (Ignore Cache)

To force rebuilding cores without purging repositories:

./build.sh -f -a

This ignores any cached state and rebuilds from the existing repo directories.

Build Latest Remote HEAD

By default, cores are built from pinned branches or specific commits defined in core.json.

To ignore pinned revisions and build from the remote repository's latest HEAD:

./build.sh -l -a

This overrides branch/commit pinning.

Create Combined Update Archive

To combine all built core archives into a single update package:

./build.sh -u

This does not build cores. It collects existing archives and bundles them into one update archive.

Valid Option Combinations

Allowed primary modes (choose one):

• -a Build all cores
• -c Build specific cores
• -u Create update archive

Optional modifiers:

• -x Only valid with -a
• -p Must be first argument
• -f Can be combined with -a or -c
• -l Can be combined with -a or -c

---

Example Commands

Build everything:

./build.sh -a

Build everything except specific cores:

./build.sh -a -x fbneo mame2010

Build only selected cores:

./build.sh -c dosbox_pure sameboy

Purge and rebuild all:

./build.sh -p -a

Purge and rebuild specific cores:

./build.sh -p -c dosbox_pure sameboy

Force rebuild without purging:

./build.sh -f -a

Build latest remote versions:

./build.sh -l -a

Generate combined update archive:

./build.sh -u

---

Please Note

• Before using this build system, run a manual build outside of it to verify that all required commands and variables are correctly configured.
• This build system assumes you have already configured and initialised a toolchain.

Core Structure

• source - The repository URL where it the core will clone from
• branch - The repository branch of the above source
• directory - Usually the name of the repository but can be anything
• output - The end file that is compiled for processing
• make.file - The file which make calls upon
• make.args - Additional arguments that is used alongside make
• make.target - A specific target to use with make if required
• make.skip - Skip running make for cores that use other build systems
• symbols - Set it to 1 if you require debug symbols
• commands.pre-make - Commands to run before make is run
• commands.post-make - Commands that are run after successful compilation

The branch and commands sections are completely optional and can be omitted.

Example Core (SameBoy)

{
    "sameboy": {
    "source": "https://github.com/LIJI32/SameBoy",
    "directory": "SameBoy",
    "branch": "f94e607",
    "output": "sameboy_libretro.so",
    "make": {
      "file": "Makefile",
      "args": "CC=gcc CONF=native_release",
      "target": "libretro"
    },
    "symbols": 0,
    "commands": {
      "pre-make": [
        "make clean",
        "printf 'Ensuring pinned RGBDS for bootrom build'",
        "mkdir -p _tools",
        "if [ ! -x _tools/rgbds/bin/rgbasm ]; then rm -rf _tools/rgbds-src _tools/rgbds; git clone https://github.com/gbdev/rgbds.git _tools/rgbds-src; cd _tools/rgbds-src && git checkout v0.8.0 && make -j$MAKE_CORES && make PREFIX=$(pwd)/../rgbds install; fi; cd ../..",
        "printf 'Building Boot ROMs'",
        "env PATH=$(pwd)/_tools/rgbds/bin:$PATH make bootroms",
        "mkdir -p build/bin",
        "ln -snf ../../../BootROMs build/bin/BootROMs"
      ],
      "post-make": [
        "printf 'Moving sameboy_libretro.so'",
        "if [ -f build/bin/sameboy_libretro.so ]; then mv build/bin/sameboy_libretro.so .; elif [ -f libretro/sameboy_libretro.so ]; then mv libretro/sameboy_libretro.so .; else echo 'sameboy_libretro.so not found' >&2; find . -maxdepth 3 -name 'sameboy_libretro.so' -print; exit 1; fi"
      ]
    }
  }
}

Additional Notes

• SameBoy core requires the RGBDS (Rednex Game Boy Development System) to be installed to your existing toolchain, all instructions are on that page.

These are additional systems and core packages that can be installed by the on-device Core Downloader mechanism.

Current Core List

---

System	Cores
Amstrad	crocods_libretro.so cap32_libretro.so
Arcade - FB Alpha 2012	fbalpha2012_cps1_libretro.so fbalpha2012_cps2_libretro.so fbalpha2012_cps3_libretro.so fbalpha2012_neogeo_libretro.so
Arcade - MAME	mame_libretro.so
Arcade - MAME 078 Plus	mame078plus_libretro.so
Arcade - MAME 139	mame0139_libretro.so
Arcade - MAME 2000	mame2000_libretro.so
Arcade - MAME 2003 Midway	mame2003_midway_libretro.so
Arcade - MAME 2003 Plus	mame2003_plus_libretro.so
Arcade - MAME 2010	mame2010_libretro.so
Arduboy	ardens_libretro.so arduous_libretro.so
Atari 5200	a5200_libretro.so atari800_libretro.so
Atari 7800	prosystem_libretro.so
Atari 800	atari800_libretro.so
Atari Jaguar	virtualjaguar_libretro.so
Atari ST-STE-TT-Falcon	hatari_libretro.so hatarib_libretro.so
Bandai WonderSwan Color	mednafen_wswan_libretro.so
ChaiLove	chailove_libretro.so
CHIP-8	jaxe_libretro.so
ColecoVision	bluemsx_libretro.so gearcoleco_libretro.so
Commodore 128	vice_x128_libretro.so
Commodore 64	vice_x64sc_libretro.so vice_xscpu64_libretro.so
Commodore Amiga	km_puae_xtreme_amped_2k24_libretro.so puae_libretro.so uae4arm_libretro.so
Commodore CBM-II	vice_xcbm2_libretro.so vice_xcbm5x0_libretro.so
Commodore PET	vice_xpet_libretro.so
Commodore VIC-20	vice_xvic_libretro.so
Crisp Game Lib Portable	ext-cglpsdl2
Discrete Integrated Circuit Emulator	dice_libretro.so
Dragon and Tandy 8-bit	ext-xroar
Fairchild Channel F	freechaf_libretro.so
Galaksija Retro Computer	galaksija_libretro.so
Game Tank	libgametank_libretro.so
GCE Vectrex	vecx_libretro.so
Handheld Electronic - Game and Watch	gw_libretro.so
Java J2ME	freej2me_libretro.so
Karaoke	pocketcdg_libretro.so
LowRes NX	lowresnx_libretro.so
Lua Engine	lutro_libretro.so
Magnavox Odyssey - VideoPac	o2em_libretro.so
Mattel Intellivision	freeintv_libretro.so
Mega Duck - Cougar Boy	sameduck_libretro.so
Microsoft MSX	bluemsx_libretro.so fmsx_libretro.so
NEC PC-8000 - PC-8800 Series	quasi88_libretro.so
NEC PC98	np2kai_libretro.so nekop2_libretro.so
NEC PC-FX	mednafen_pcfx_libretro.so
Nintendo DS	desmume2015_libretro.so ext-drastic-legacy melondsds_libretro.so melonds_libretro.so
Nintendo Famicom Disk System	fceumm_libretro.so mesen_libretro.so nestopia_libretro.so
Nintendo Game Boy	DoubleCherryGB_libretro.so fixgb_libretro.so tgbdual_libretro.so vbam_libretro.so
Nintendo Game Boy Advance	mednafen_gba_libretro.so mgba_rumble_libretro.so vbam_libretro.so vba_next_libretro.so
Nintendo Game Boy Color	DoubleCherryGB_libretro.so fixgb_libretro.so tgbdual_libretro.so vbam_libretro.so
Nintendo N64	mupen64plus_libretro.so parallel_n64_libretro.so km_ludicrousn64_2k22_xtreme_amped_libretro.so
Nintendo NES - Famicom	bnes_libretro.so mesen_libretro.so
Nintendo Pokemon Mini	pokemini_libretro.so
Nintendo SNES - SFC	bsnes2014_performance_libretro.so bsnes_cplusplus98_libretro.so bsnes_mercury_performance_libretro.so bsnes_libretro.so mesen-s_libretro.so snes9x2005_plus_libretro.so snes9x2005_libretro.so snes9x2010_libretro.so snes9x_next_libretro.so
Onscripter	onsyuri_libretro.so onscripter_libretro.so
OpenBOR	ext-openbor4432 ext-openbor6412 ext-openbor7142 ext-openbor7530
Philips CDi	same_cdi_libretro.so
Pyxel	ext-pyxel
Quake	tyrquake_libretro.so
Quake II	vitaquake2_libretro.so vitaquake2-rogue_libretro.so vitaquake2-xatrix_libretro.so vitaquake2-zaero_libretro.so
ScummVM	scummvm_libretro.so
Sega Mega Drive - Genesis	genesis_plus_gx_expanded_libretro.so
Sega Pico	genesis_plus_gx_wide_libretro.so genesis_plus_gx_libretro.so picodrive_libretro.so
Sega Saturn	mednafen_saturn_libretro.so yabause_libretro.so ext-yabasanshiro-hle ext-yabasanshiro-bios yabasanshiro_libretro.so
Sega SG-1000	bluemsx_libretro.so gearsystem_libretro.so genesis_plus_gx_libretro.so
Sharp X1	x1_libretro.so
Sharp X68000	px68k_libretro.so
Sinclair ZX 81	81_libretro.so
Sinclair ZX Spectrum	fuse_libretro.so
SNK Neo Geo	geolith_libretro.so
Sony PlayStation	mednafen_psx_libretro.so
SVI - ColecoVision - SG1000	bluemsx_libretro.so
Texas Instruments TI-83	numero_libretro.so
TIC-80	tic80_libretro.so
The 3DO Company - 3DO	opera_libretro.so
Uzebox	uzem_libretro.so
VeMUlator	vemulator_libretro.so
Vircon32	vircon32_libretro.so
WASM-4	wasm4_libretro.so
Watara Supervision	potator_libretro.so