~dajolly/dmgl

A lightweight GameBoy emulator, written in C.

c76bb11 code cleanup

~dajolly pushed to ~dajolly/dmgl git

12 hours ago

82669e7 code cleanup

~dajolly pushed to ~dajolly/dmgi git

12 hours ago

License: MIT Build Status

DMGL

#Install

git clone https://git.sr.ht/~dajolly/dmgl
cd dmgl
make
sudo make install
# The default installation directory is /usr/local
# To install into a different directory, redefine PREFIX
sudo make install PREFIX=/your/path

#Usage

Usage: dmgl [options] [file]

Options:
   -f, --fullscreen  Set window fullscreen
   -h, --help        Show help information
   -l, --link        Set link id
   -p, --palette     Set color palette
   -s, --scale       Set window scale
   -v, --version     Show version information
# To launch without a file, run the following command
dmgl

# To launch with a file, run the following command
dmgl file.gb

# To launch with a fullscreen window, run the following command
dmgl --fullscreen file.gb

# To launch with a link id, run the following command
dmgl --link id file.gb

# To launch with a color palette, run the following command
dmgl --palette [0-3] file.gb

# To launch with a scaled window, run the following command
dmgl --scale [1-8] file.gb

#Keybindings

Button Key
A X
B Z
Select C
Start Space
Right Right-Arrow
Left Left-Arrow
Up Up-Arrow
Down Down-Arrow

#Mappers

Id Type Description
0,8-9 MBC0 32KB ROM/8KB RAM
1-3 MBC1 2MB ROM/32KB RAM
5-6 MBC2 256KB ROM/512B RAM
15-19 MBC3 2MB ROM/32KB RAM/RTC
25-30 MBC5 8MB ROM/128KB RAM

#Palettes

Id Color Description
0 None None
1 DMG GameBoy (DMG-01)
2 Pocket GameBoy Pocket (MGB-001)
3 Light GameBoy Light (MGB-101)

#License

Copyright (C) 2024 David Jolly jolly.a.david@gmail.com. Released under the MIT License.