Gearboy

drhelius drhelius
Dépôt créer le : 19/07/2012
Release du : 25/02/2026 Gearboy 3.7.5
Forks: 149 Watcher: 0 1081
Choisir une liste...
FR

Garçon

GitHub Workflow Status GitHub Releases) commits) GitHub contributors GitHub Sponsors License Twitter Follow

Gearboy est un émulateur multiplateforme Game Boy / Game Boy Color écrit en C++ qui fonctionne sous Windows, macOS, Linux, BSD et RetroArch.

Il s'agit d'un projet open source avec son développement continu rendu possible grâce au soutien de cesbackers. Si vous le trouvez utile, veuillez considérersponsoring.

N'hésitez pas à signaler des bogues ou à demander de nouvelles fonctionnalités paropening an issue.

gearboy_debug_03.png

Téléchargements

Plateforme Architecture Télécharger le lien
Windows x64 Gearboy-3.7.5-windows-x64.zip
ARM64 Gearboy-3.7.5-windows-arm64.zip
macOS Bois de maison brew install --cask drhelius/geardome/gearboy
Pomme Silicone Gearboy-3.7.5-macos-arm.zip
Renseignements Gearboy-3.7.5-macos-intel.zip
Linux Ubuntu 24.04 x64 Gearboy-3.7.5-ubuntu24.04-x64.zip
Ubuntu 22.04 x64 Gearboy-3.7.5-ubuntu22.04-x64.zip
Ubuntu 24.04 ARM64 Gearboy-3.7.5-ubuntu24.04-arm64.zip
Rétrographique Toutes les plateformes Libretro core documentation
Dev construit Toutes les plateformes GitHub Actions

Remarques:

Caractéristiques

  • Emulation précise du processeur, passe cpu instrs.gb des tests de blargg.
  • Instructions précises et chronométrage de la mémoire, passe instr timing.gb et mem timing.gb des tests de blargg.
  • Cartouches prises en charge: ROM, ROM + RAM, MBC1, MBC2, MBC3 + RTC, MBC5, HuC-1 et MBC1M (multicart).
  • Emulation précise du contrôleur LCD avec des délais et des priorités corrects, y compris les effets mi-scanline.
  • Prise en charge de la couleur du jeu Boy.
  • Effet fantôme de l'écran LCD comme vu dans le Game Boy original.
  • Effet de matrice de points LCD.
  • Support RAM alimenté par batterie.
  • Sauvez les états.
  • Prise en charge par compression (ZIP).
  • Soutien au démarrage (BIOS).
  • Jeu génieetGameSharkle soutien triche.
  • Enregistreur VGM.
  • Plateformes prises en charge (standalone): Windows, Linux, BSD et macOS.
  • Plateformes prises en charge (libretro): Windows, Linux, macOS, Raspberry Pi, Android, iOS, tvOS, PlayStation Vita, PlayStation 3, Nintendo 3DS, Nintendo GameCube, Nintendo Wii, Nintendo WiiU, Nintendo Switch, Emscripten, Classic Mini systèmes (NES, SNES, C64, ...), OpenDingux, RetroFW et QNX.
  • Débogueur complet avec désassembleur juste à temps, points d'arrêt CPU, points d'arrêt d'accès à la mémoire, navigation de code (adresse goto, JP JR et CALL double click), symboles de débogage, éditeur de mémoire, inspecteur IO et visionneur VRAM y compris les carreaux, sprites, fonds et palettes.
  • Windows et LinuxMode portable.
  • ROM chargement depuis la ligne de commande en ajoutant le chemin ROM comme argument.
  • Chargement ROM en utilisant glisser-déposer.
  • Support pour les contrôleurs de jeux modernes à traversgamecontrollerdb.txtfichier situé dans le même répertoire que l'application binaire.

Conseils

Utilisation de base

  • Démarrage ROM: Gearboy peut fonctionner avec ou sans Boot ROM. Vous pouvez en option charger un Boot ROM et l'activer.
  • Curseur de souris: Se cache automatiquement lorsque vous survolez la fenêtre de sortie principale ou lorsque le menu principal est désactivé.
  • Mode portable: Créer un fichier vide nomméportable.inidans le même répertoire que l'application binaire pour activer le mode portable.

Caractéristiques de débogage

  • Dossier Windows: En mode débogage, vous pouvez amarrer les fenêtres ensemble en appuyant sur SHIFT et en faisant glisser une fenêtre sur une autre.
  • Port multi-vues: Dans Windows ou macOS, vous pouvez activer "multi-viewport" dans le menu debug. Vous devez redémarrer l'émulateur pour que le changement prenne effet. Une fois activé, vous pouvez glisser les fenêtres de débogueur à l'extérieur de la fenêtre principale.
  • Symboles de débogage: L'émulateur essaie automatiquement de charger un fichier symbole lors du chargement d'un ROM. Par exemplepath_to_rom_file.gbil essaie de chargerpath_to_rom_file.sym. Vous pouvez également charger un fichier de symboles en utilisant l'interface graphique ou la CLI.

Utilisation de la ligne de commande

gearboy [options] [rom_file] [symbol_file]

Options:
  -f, --fullscreen    Start in fullscreen mode
  -w, --windowed      Start in windowed mode with menu visible
  -v, --version       Display version information
  -h, --help          Display this help message

Instructions de construction

Windows

  • Installez Microsoft Visual Studio Community 2022 ou une version ultérieure.
  • Ouvrez la solution Gearboy Visual Studioplatforms/windows/Gearboy.slnet construire.

macOS

  • Installer Xcode et exécuterxcode-select --installdans le terminal pour que le compilateur soit disponible sur la ligne de commande.
  • Exécutez ces commandes pour générer un Macappensemble:
brew install sdl2
cd platforms/macos
make dist

Linux

  • Ubuntu / Debian / Raspberry Pi (Raspbian):
sudo apt install build-essential libsdl2-dev libgtk-3-dev
cd platforms/linux
make
  • Fedora :
sudo dnf install @development-tools gcc-c++ SDL2-devel gtk3-devel
cd platforms/linux
make
  • Arch Linux :
sudo pacman -S base-devel sdl2 gtk3
cd platforms/linux
make

BSD

  • FreeBSD :
su root -c "pkg install -y git gmake pkgconf SDL2 lang/gcc gtk3"
cd platforms/bsd
gmake
  • NetBSD :
su root -c "pkgin install gmake pkgconf SDL2 lang/gcc gtk3"
cd platforms/bsd
gmake

Libretro

  • Ubuntu / Debian / Raspberry Pi (Raspbian):
sudo apt install build-essential
cd platforms/libretro
make
  • Fedora :
sudo dnf install @development-tools gcc-c++
cd platforms/libretro
make

Essais d'exactitude

Comparativement aux autres émulateurs:see here.

Essaisblargg's test roms:

cpu_instrs.gbinsrt_timing.gblcd_sync.gbdmg_sound.gbcgb_sound.gbmem_timing.gb

Captures d'écran

ScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshot

Contributeurs

Merci à toutes les personnes qui ont déjà contribué à Gearboy!

Contributors

Licence

Gearboy est sous licence GNU General Public License v3.0, voirLICENSEpour plus d'informations.

Contributeurs GitHub

RipleyTom
RipleyTom
2 contributions
not-chciken
not-chciken
1 contributions
AntonioND
AntonioND
2 contributions
warmenhoven
warmenhoven
5 contributions
andres-asm
andres-asm
11 contributions
inactive123
inactive123
5 contributions
rzumer
rzumer
1 contributions
webgeek1234
webgeek1234
3 contributions
Tatsuya79
Tatsuya79
7 contributions
drhelius
drhelius
1209 contributions
mddrill
mddrill
11 contributions
keithbowes
keithbowes
3 contributions
dmoerner
dmoerner
3 contributions
hawkrives
hawkrives
2 contributions
alarixnia
alarixnia
3 contributions
crystalct
crystalct
2 contributions
Copilot
Copilot
1 contributions
BananaRama203
BananaRama203
8 contributions
Ploggy
Ploggy
2 contributions
tomyun
tomyun
2 contributions
francois-berder
francois-berder
2 contributions
BestPig
BestPig
2 contributions
natinusala
natinusala
1 contributions
yoshisuga
yoshisuga
1 contributions
anyputer
anyputer
1 contributions
Oskenso
Oskenso
1 contributions
lubosz
lubosz
1 contributions
ethanaobrien
ethanaobrien
1 contributions
globalspin
globalspin
1 contributions
bjoernh
bjoernh
1 contributions