Game Boy/Game Boy Color (SameBoy)Link

Contribute to this documentationLink

In order to propose improvements to this document, visit its corresponding source page on github. Changes are proposed using "Pull Requests."

There is a To-Do list for libretro/docs here

You can submit suggestions or issues regarding documentation at the libretro/docs issue tracker or in our forum thread.

BackgroundLink

SameBoy is an extremely accurate open source Gameboy (DMG) and Gameboy Color (CGB) emulator, written in portable C.

Why use this core?Link

  • Supports GameBoy (DMG) and GameBoy Color (CGB) emulation
  • Battery save support
  • Save states
  • Includes open source DMG and CGB boot ROMs
  • Real time clock emulation
  • Extremely high accuracy

How to get and install the SameBoy core:Link

  • Start up RetroArch. Inside the main menu, go to 'Online Updater'.

  • Just to make sure we have the latest info files, select 'Update Core Info FIles'. Wait until this is done. Then, select 'Core Updater'.

  • Browse through the list and select 'Game Boy/Game Boy Color (SameBoy)'.

After this has finished downloading, the core should now be ready for use!

How to start (after installation):Link

  • Go back to RetroArch's main menu screen. Select 'Load Content'.

  • Browse to the folder that contains the content you want to run.

  • Select the content that you want to run.

  • If you are asked which core to select, choose 'Game Boy/Game Boy Color (SameBoy)'.

The content should now start running!

AuthorsLink

  • LIJI32

See alsoLink

GB/GBCLink

LicenseLink

A summary of the licenses behind RetroArch and its cores have found here.

The SameBoy core is licensed under

ExtensionsLink

Content that can be loaded by the SameBoy core have the following file extensions:

  • .gb
  • .gbc

DatabasesLink

RetroArch database(s) that are associated with the SameBoy core:

BIOSLink

Required or optional firmware files go in RetroArch's system directory.

Attention

The SameBoy core has reverse engineered Game Boy/Game Boy Color boot ROMs baked into the core itself so real BIOS files aren't required. If you’d like to override this, you can place the following BIOS files in RetroArch's system directory.

Filename Description md5sum
dmg_boot.bin Game Boy boot ROM - Optional 32fbbd84168d3482956eb3c5051637f5
cgb_boot.bin Game Boy Color boot ROM - Optional dbfce9db9deaa2567f6a84fde55f9680

FeaturesLink

RetroArch-level settings or features that the SameBoy core respects.

Feature Supported
Restart
Screenshots
Saves
States
Rewind
Netplay ✔ (not link-cable emulation)
Core Options
RetroAchievements
RetroArch Cheats
Native Cheats
Controls
Remapping
Multi-Mouse
Rumble
Sensors
Camera
Location
Subsystem
Softpatching
Disk Control
Username
Language
Crop Overscan

DirectoriesLink

The SameBoy core's directory name is 'SameBoy'

The SameBoy core saves/loads to/from these directories.

RetroArch's Save directory

  • 'content-name'.srm (Cartridge backup save)
  • 'content-name'.rtc (Real time clock save)

RetroArch's State directory

  • 'content-name'.state# (State)

Geometry and timingLink

  • The SameBoy core's internal FPS is 59.72
  • The SameBoy core's internal sample rate is 44100 Hz
  • The SameBoy core's core provided aspect ratio is 160/144

Core optionsLink

The SameBoy core has the following option(s) that can be tweaked from the core options menu. The default setting is bolded.

Settings with SameBoy means that core has to be closed for the new setting to be applied on next launch.

  • Color Correction (off/correct curves/emulate hardware/preserve brightness)

Self-explanatory. Only for Gameboy Color games

Color Correction - off

Color Correction - correct curves

Color Correction - emulate hardware

Color Correction - preserve brightness

  • High Pass Filter (off/accurate/remove dc offset)

Awaiting description.

ControllersLink

Device typesLink

The SameBoy core supports the following device type(s) in the controls menu, bolded device types are the default for the specified user(s):

User 1 device typesLink

  • None - Doesn't disable input.
  • RetroPad - Joypad
  • Nintendo Gameboy - Joypad

Rumble supportLink

Rumble only works in the SameBoy core when

  • The content being ran has rumble support.
  • The joypad input driver being used has rumble support. (e.g. Xinput)
  • The joypad device being used has rumble support.

Controller tablesLink

Joypad and analog device type tableLink

User 1 Input descriptors RetroPad Inputs Nintendo Gameboy
B B
Select Select
Start Start
Up Up
Down Down
Left Left
Right Right
A A

CompatibilityLink

Awaiting description.