Game Boy Interface/Standard Edition

Game Boy Interface

Information
Author(s)	Extrems
Type	Utility
Version	Rolling release
Licence	All rights reserved
Links
Download main package Download extra package
Website
Discussion
Source

Controls

On-screen display

Nintendo GameCube	Nintendo GameCube Controller	Logitech Speed Force	Action
	A/B Buttons	A/B Buttons	Hide on-screen display
	X Button	X Button	Toggle on-screen display
	Y Button	Y Button	Revert offset/zoom
	Z Button	Z Button	Take screenshot
	Start/Pause (Hold for 1 second)	Start/Pause (Hold for 1 second)	Quit
	+Control Pad	+Control Pad	Offset
	L/R Buttons	L/R Buttons	Zoom
Reset Button	X, Y and Start/Pause Buttons (Hold for 1.5 seconds)		Recalibrate
Reset Button			Save movie

In-game

Nintendo GameCube	Nintendo GameCube Controller	Logitech Speed Force	Action
	A/B Buttons	A/B Buttons or Accelerator/Brake Pedals	A/B Buttons
	X Button	X Button	Toggle on-screen display
	Y Button	Y Button	Turbo
	Z Button	Z Button	Select
	Start/Pause	Start/Pause	Start
	+Control Pad or Control Stick	+Control Pad or Steering Wheel	+Control Pad
	L/R Buttons	L/R Buttons	L/R Buttons (Only for Game Boy Advance)
Reset Button			Power Switch

Options

--aspect=<w:h>

Set screen aspect ratio. (default: sram)

--offset=<x:y>

Set default offset. (default: sram)

--zoom=<x:y>

Set default zoom. (default: sram)

--rotate=<0-359>

Set default rotation. (default: 0)

--poll=<0-11>

Set polling rate. (default: 1)

--turbo=<on:off>

Set autofire interval. (default: 3)

--movie=<path>, --no-movie

Play input log. (default: no)

--movie-record, --no-movie-record

Record input log. (default: no)

--overlay=<path>, --no-overlay

Set texture palette. (default: frame.tpl.gz)

--overlay-id=<id>

Set texture palette index. (default: sram)

--overlay-scale=<x:y>

Set texture scale. (default: auto)

--filter=<none|scale2x[ex|plus]|eagle2x|scan2x|normal2x|normalnx>

Set image doubling filter. (default: normalnx)

--dither=<none|threshold|bayer8x8|bayer4x4|bayer2x2|cluster8x8|cluster4x4>

Set dithering algorithm. (default: threshold)

--scaler=<nearest|bilinear|oversample|box>

Set image scaling filter. (default: bilinear)

--matrix=<identity|gba|gbc|gbi|nds|palm|psp|vba>

Set color matrix. (default: gbi)

--input-gamma=<r:g:b>

Set gamma. (default: 2.2)

--output-gamma=<1.0|1.7|2.2>

Set screen gamma. (default: 2.2)

--contrast=<r:g:b>

Set gain. (default: 1.0)

--brightness=<r:g:b>

Set bias. (default: 0.0)

--volume=<l:r>

Set audio gain. (default: 0.75)

--sound=<mono|stereo>

Set sound mode. (default: sram)

--format=<ntsc|pal|pal-m|ntsc-50|pal-60|custom>

Set video format. (default: sram)

--scan-mode=<interlace|quasi-interlace|non-interlace|non-progressive|progressive>[,double-clock[,oversample]]

Set scan mode. (default: sram)

--osd, --no-osd

Toggle on-screen display. (default: yes)

--ipv4-address=<aaa.bbb.ccc.ddd>

Set static IPv4 address. (default: dhcp)

--ipv4-gateway=<aaa.bbb.ccc.ddd>

Set static IPv4 gateway. (default: dhcp)

--ipv4-netmask=<aaa.bbb.ccc.ddd>

Set static IPv4 netmask. (default: dhcp)

--network, --no-network

Toggle networking. (default: yes)

--stream[=<aaa.bbb.ccc.ddd>], --no-stream

Stream video to IP address on UDP port 1234. (default: no)

--enhance, --no-enhance

Toggle Game Boy Player enhancements. (default: yes)

<path>

Set Game Boy Advance multiboot. (default: default.mb.gz)

Examples

Color restoration

Mario & Luigi: Superstar Saga

This game reduces contrast when played with Game Boy Player enhancements.

--overlay=frame-srgb.tpl.gz
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=1.1

The Legend of Zelda: Oracle of Ages/Seasons

This game reduces gamma when played on a Game Boy Advance. Due to Game Boy Color limitations, only shadows can be restored perfectly.

--input-gamma=4.

This can be combined with Gambatte/higan's color correction as a special case.

--overlay=frame-srgb.tpl.gz
--matrix=gbc
--input-gamma=1.8
--output-gamma=1.

Mimicking

Game Boy Player Start-up Disc

Included as gbi.cli.example.

--overlay=frame-srgb.tpl.gz
--dither=none
--matrix=identity
--input-gamma=1.
--output-gamma=1.
--contrast=.78125
--no-osd

Changelog

May, 2018

• Changed default aspect ratio for progressive scan to 16:9.
• Fixed rumble protocol handshake.

April, 2018

• Added movie recording/playback.
• Updated GBA-as-GC controller.

March, 2018

• Improved multiboot implementation.
• Improved Game Boy sound quality.
• Improved audio rendering.
• Reduced audio latency.
• Changed default color matrix to GBI's original.
• Fixed SD card compatibility.
• Fixed multiboot to rumble protocol transition.

February, 2018

• Added color matrix from Gambatte.
• Added mono sound mode.
• Fixed wiiload autoboot with tiny GBA multiboot ROMs.
• Disabled machine checks.

January, 2018

• Updated color matrices by Pokefan531.
• Improved Game Boy Player driver.

September, 2017

• Added overlay scale setting.
• Added Logitech Speed Force support.
• Added Active Life Mat support.
• Improved Game Boy Player driver.
• Changed wiiload server to accept oversized DOLs.
• Fixed one random kernel crash.

August, 2017

• Added DK Bongos support.
• Updated color matrices by Pokefan531.
• Improved Game Boy Player driver.

July, 2017

• Added CLI append support.
• Updated color matrices by Pokefan531.
• Updated GBA-as-GC controller.

April, 2017

• Added component video DAC oversampling.
• Added experimental 960i and 1152i video modes.

March, 2017

• Added temporal/spatial dithering.
• Added color matrices by Pokefan531.
• Added TPL overlay support to wiiload server.
• Changed default color matrix to Pokefan531's.
• Changed default gamma to 2.2.
• Optimized NormalNx filter.

February, 2017

• Added volume control.
• Added per-channel settings where possible.
• Changed volume to 75% to mitigate clipping.
• Fixed framebuffer clearing for 576i.

November, 2016

• Updated GBA-as-GC controller.
• Optimized Scale2xEx filter.

October, 2016

• Added Scale2xEx and Scale2xPlus filters.
• Added oversample and box scalers.
• Added basic video streaming.
• Added Remote RetroPad support.
• Optimized video rendering.

September, 2016

• Added polling rate setting.

May, 2016

• Updated GBA-as-GC controller.
• Improved Game Boy Player driver.
• Fixed WaveBird Controllers.

April, 2016

• Added GBA multiboot support to wiiload server.
• Added Xboo Communicator.
• Added BIOS/ROM dumper.
• Replaced GBA-as-controller with GBA-as-GC controller.

March, 2016

• Added GBA-as-controller support.
• Recognized a half press of the analog triggers.

December, 2015

• Expanded video options. Now includes 25, 30, 100 and 120 Hz modes.
• Added gamma-encoded borders for special use.

November, 2015

• Added (GZipped) TPL overlay support.
• Added all 20 borders from the Game Boy Player Start-up Disc.

October, 2015

• Added Scale2x, Eagle2x, Scan2x and Normal2x filters.

August, 2015

• Added executable compression.
• Added return to autoexec.dol.
• Added memory card distribution files.
• Added auto-cropping for Game Boy screenshots.
• Optimized video rendering.
• Reduced coil whine.

July, 2015

• Added rumble.
• Added hold to quit.
• Added screenshot saving.
• Added SNTP broadcast listener.
• Changed default video mode to interlaced.
• Fixed Game Boy Player detection issue.

May, 2015

• Changed all 60 Hz modes to have 486 active lines.

March, 2015

• Added digital PWM sound.
• Added turbo button.
• Fixed 288p.