Repository navigation
Releases
wer 0.32.0
Pocket Sonar
Bandai's fish finder cartridge (Gyogun Tanchiki: Pocket Sonar). Its MBC1S sends sonar pulses and reads the echoes; wer answers them as real echoes would come back, timed by how far the sound has gone, from a made-up lake: a floor 1 to 13 m down that rises and falls as the boat drifts, rocks on it, and fish. So every depth setting works, the game reads out the floor's depth, and with 魚マーク on it marks the fish. (A real Game Boy Color sees nothing through it; wer's does.)
Sewing machines
The Jaguar JN-100 / JN-2000 and Singer IZEK-1500 (--link=sewing, or Menu → Link → Sewing machine), for Raku x Raku Mishin. When the game has sent a pattern it asks you to press the machine's start switch; wer sews it right away, into a PNG of the fabric next to the game (game-sewing-1.png, ...), like a printout. Patterns repeat over 60 mm, lettering is sewn once. Tried with zigzags at two stitch lengths and lettering (あいう). Embroidery isn't supported.
The fabric's feed is four times what Dan Docs' table gives: with it the game's 1.5 mm stitch comes out at 1.5 mm, and letters come out square.
Shorter README
The README is now a front page; the details moved to docs/: FEATURES.md (with the test results), USAGE.md, ACCESSORIES.md and DEVELOPMENT.md.
Also
- New tests: the sonar's echoes and the sewing machine's packets, plus Pocket Sonar and Raku x Raku Mishin from power on (games not included); all 358 tests pass.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.32.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.32.0-linux-x86_64 |
| Windows x64 | wer-0.32.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.32.0-macos-arm64.zip (not notarized: right-click > Open the first time) |
wer 0.31.0
Nintendo Power GB Memory cartridge
The flash cartridges Nintendo's Japanese kiosks wrote games to: a menu and up to seven games on 1 MiB, sharing 128 KiB of save RAM. wer runs the menu, and the game picked from it gets its own MBC, ROM and part of the RAM, as the cartridge's G-MMC1 chip maps them. On a Game Boy Color the menu resets the console into the game (so the boot ROM colours a black-and-white one), on a DMG it switches straight to it.
The layout comes from the .map file beside the .gb (as gbnp and cartridge readers save it); without one, wer works it out from the menu's list of games. Saves go to one .sav for the whole cartridge. Programming the flash (the kiosk's job) isn't emulated.
Accessories from the command line
--inputscripts can now work the device on--linkat a given frame, as its menu line does:card=(Barcode Boy, Bardigun reader),wave=(Full Changer),watts=(Pikachu 2),gift=(Pocket Sakura). For example--link=bardigun --input=…,11020:card=4900363432103.--headlessnow honours--link, with notices printed to the terminal. Together, every link device can be used without a window.
Also
- New unit tests for the GB Memory chip and the script actions; all 351 tests pass.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.31.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.31.0-linux-x86_64 |
| Windows x64 | wer-0.31.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.31.0-macos-arm64.zip (not notarized: right-click > Open the first time) |
wer 0.30.0
Six more accessories
All on Menu → Link (and --link=...), each tried with its game:
- Turbo File GB (
--link=turbo): ASCII's save drive for RPG Tsukuru GB and RPG Tsukuru GB2, with its memory card. Files saved there are kept in~/.wer/turbo-file.bin, one drive for every game. RPG Tsukuru GB saves, lists and loads its files on it. - Power Antenna / Bug Sensor (
--link=antenna): the light of Keitai Denjuu Telefang and Network Adventure Bugsite, shown as a red dot at the picture's top right. - Bardigun reader (
--link=bardigun): Barcode Taisen Bardigun's card reader. Swipe card... asks for a 13-digit barcode; the cards from Dan Docs' list hatch their Bardigun. - Full Changer (
--link=changer): Zok Zok Heroes' toy. The menu's Character line picks one of the 70 Cosmic Characters, and Enter waves it. - Pokémon Pikachu 2 (
--link=pikachu): on Gold or Silver's Mystery Gift screen, Enter on the Watts line sends them, and the game gives the pet's gift (Berry at 100 ... Rare Candy at 999), with no daily limit. Any region's game. - Pocket Sakura (
--link=sakura): in Sakura Taisen GB, Title (second page) > 通信 > ポケットサクラ; Enter on the Gift line sends one of the game's items (to the Romandō shop) or a points bonus. Its protocol was worked out from the game.
Also
- Game Boy Color games' infrared light now reaches the devices that watch it.
- New tests from power on with the games (not included): RPG Tsukuru GB, Barcode Taisen Bardigun, Pokémon Silver and Sakura Taisen GB.
- Test results unchanged: 261/261 on the GB Emulator Shootout's set, Gambatte 5225/5225, Mooneye, SameSuite, AGE, Mealybug, Blargg and the rest. Save states from 0.10.1 and later still load.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.30.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.30.0-linux-x86_64 |
| Windows x64 | wer-0.30.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.30.0-macos-arm64.zip (not notarized: right-click > Open the first time) |
wer 0.29.0
Mobile Adapter GB
wer now plugs in the Mobile Adapter GB, the Japanese phone adapter of Pocket Monsters Crystal, Mobile Trainer, Net de Get and the other Mobile System GB games: Menu → Link → Mobile Adapter, or --link=mobile (desktop and Android; not in a browser, which has no sockets). It is written from the protocol as Dan Docs describes it.
- Online: the game calls the ISP, logs in and talks to its server by itself. Nintendo's servers are gone, so the names it looks up go to the DNS server you set in
wer.conf:mobile-dns = ADDRESS[:PORT](andmobile-dns2), a REON server's. - The adapter's memory (what Mobile Trainer fills in: the account, the ISP) is
~/.wer/mobile.bin; theconfig.bina REON server gives its users works there as it is. - Calls between two wers: a 12-digit number calls another wer at that IP address (
127000000001= 127.0.0.1), waiting for a call in its game, on port 1027 (mobile-port). The waiting side's notice shows its own number. - Also in
wer.conf:mobile-adapter = blue | yellow | redandmobile-unmetered = yes(a flat-rate plan: Crystal lifts its daily battle time limit).WER_MOBILE_TRACE=1prints each command the game sends.
Tested with Net de Get: from power on to its Server menu, a call to the ISP, the login, the server looked up and its minigame list downloaded (REON's files, served locally). Calls between two adapters are tested over this computer's own network, not yet with Crystal.
Also
- Test results unchanged: 261/261 on the GB Emulator Shootout's set, Gambatte 5225/5225, Mooneye, SameSuite, AGE, Mealybug, Blargg and the rest. Save states from 0.10.1 and later still load.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.29.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.29.0-linux-x86_64 |
| Windows x64 | wer-0.29.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.29.0-macos-arm64.zip (not notarized: right-click > Open the first time) |
wer 0.28.0
WorkBoy
wer now plugs in the WorkBoy, Fabtek's keyboard for the Game Boy (with a clock inside), made in 1992 but never released: Menu → Link → WorkBoy, or --link=workboy. It runs the WorkBoy program (not included) and all its tools work: clock, temperature, money, calculator, date, conversion, records, world, phone. The keyboard follows SameBoy's emulation of it (MIT), the only one there is.
- Typing: once the program talks to it, the computer's keyboard is the WorkBoy's. Letters, digits and symbols go in as you type them; F1–F9 open its nine tools; the arrows, Enter, Backspace and Esc are its own keys. On a phone, the on-screen keyboard comes up.
- wer's menu: Shift+Esc (or a gamepad's menu button) while the WorkBoy has the keyboard.
- First start: the program asks for the home city on a world map. N and P go through the cities, S picks one.
- Clock: the computer's local time. If the program sets it, wer keeps the difference in
wer.conf(workboy-clock).
Also
- With the GB KISS LINK plugged in, a game's link cable transfer no longer waits forever.
- Link cable bytes are echoed to the terminal only with nothing plugged in (the echo is for test ROMs).
- Test results unchanged: 261/261 on the GB Emulator Shootout's set, Gambatte 5225/5225, Mooneye, SameSuite, AGE, Mealybug, Blargg and the rest. Save states from 0.10.1 and later still load.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.28.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.28.0-linux-x86_64 |
| Windows x64 | wer-0.28.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.28.0-macos-arm64.zip (not notarized: right-click > Open the first time) |
wer 0.27.0
GB KISS LINK
wer can now be the PC that Hudson's GB KISS LINK (HC-749), an infrared modem, was plugged into: Menu → Link → GB KISS LINK, or --link=kiss. The protocol was worked out from the game itself, with Dan Docs and gbkiss.org.
- GB KISS files (
.gbf, such as the programs on gbkiss.org) go both ways with a game's GB KISS menu:- To the game: open or drop a
.gbfon the window, or pick one on the menu's File line, then press Start (or 受信, Receive) in the GB KISS menu. The file lands in the cartridge's battery RAM exactly as it is on disk, and runs from there. - From the game: when the menu sends a file (送信, Send), wer saves it next to the game as
game-kiss-1.gbf,-2, ….
- To the game: open or drop a
- Nectaris GB's maps: "send to PC" (パソコンニオクル) saves the map as
game-map-1.binnext to the game. "Receive from PC" (パソコンカラモラウ) gives the game the map picked on the Map line.
Tested with Nectaris GB. Hudson's other games with a GB KISS menu should work the same way, but haven't been tried yet.
Also
- The file dialog and the web version's file picker accept
.gbf. - Test results unchanged: 261/261 on the GB Emulator Shootout's set, Gambatte 5225/5225, Mooneye, SameSuite, AGE, Mealybug, Blargg and the rest. Save states from 0.10.1 and later still load.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.27.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.27.0-linux-x86_64 |
| Windows x64 | wer-0.27.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.27.0-macos-arm64.zip (not notarized: right-click > Open the first time) |
wer 0.26.0
Accuracy
wer now passes every test of the GB Emulator Shootout's set, 261 of 261, as it runs out of the box (boot ROM on), measured with the shootout's own test ROMs, reference pictures and comparison. (wer isn't in its table yet.) What it took:
- STOP on a Color Game Boy: the PPU keeps running while the rest stops, but it can't read VRAM, OAM or the palettes, so the screen goes black, unless STOP came in mode 3, when the picture stays as it was (daid's
stop_instrtests). - MBC3 clock: any single write to
$6000-$7FFFlatches the clock, not only$00then$01; with the clock, the RAM bank register is 4 bits and banks$04-$07and$0D-$0Fmap to nothing (CasualPokePlayer's hardware research). - Super Game Boy packets: a bit is read when P1 returns to
$30, by the line that was low last; both lines low restarts the packet anywhere; the stop bit isn't checked (CasualPokePlayer'ssgb-ext-test). - Boot ROM handoff: wer's own boot ROMs (its logo and chime, no Nintendo code) now hand the game exactly the machine Nintendo's do (timer, where the screen is in its frame, sound, registers, the logo's tiles in VRAM), so everything passes with the boot ROM as it does without it. On a Color Game Boy a DMG game keeps the colours the boot ROM picked.
The Color Game Boy is now a CPU CGB E
--mode=cgb, CGB (E) in the menu, and Color-only games started in another mode now run on a CPU CGB E, the last revision (as SameBoy does). The CGB C that was the default is --mode=cgb-c or CGB (C) in the menu. A few timing details differ between the two (some sound and PPU edge cases); games almost never notice. A mode = cgb in wer.conf now means E.
Also
- Test results otherwise unchanged: Gambatte 5225/5225, Mooneye, SameSuite, AGE, Mealybug (on the revisions their screenshots are of), Blargg and the rest. Save states from 0.10.1 and later still load.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.26.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.26.0-linux-x86_64 |
| Windows x64 | wer-0.26.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.26.0-macos-arm64.zip (not notarized: right-click > Open the first time) |
wer 0.25.0
Movies (tool-assisted play)
Menu → Movie records your play, button by button, from power-on (Record) or from where you are (Rec here), into game-movie-N.wer next to the game, and Play plays it back exactly, frame for frame.
- Re-recording: while recording, rewind (R) or load a save state and the movie goes back with you; what you play from there replaces what came after. Pause (P) and frame advance (N) let you play a frame at a time. The movie counts its rerecords.
- Take over: while a movie plays, take over to record on from that frame into a new movie.
- Open a
.werwith Ctrl+O or drop it on the window to watch it. In a browser a finished recording downloads. - From the command line:
--movie=FILEplays one (with--headless, to its end),--record-movie=FILErecords the run. - Every save state now knows how many frames the game has run and which buttons were pressed, so a state from an abandoned take ends the recording (saved so far) instead of making a movie that wouldn't play back.
- The file is text: a short header, the buttons in
--input'sFRAME:KEYS*Nform, and the starting state. - Not with the link cable; tilt and the camera picture aren't recorded.
Palettes
Original Game Boy games in DMG and Pocket mode can now be shown in other colours: Menu → Palette or --palette=:
- Auto (the default, as before): the DMG's green, a Pocket's grey
- Green, Classic (the darker pea-soup green), Pocket, Grey
- any of the Super Game Boy's 32 palettes (SGB 1-A … 4-H)
- your own four colours, lightest first:
--palette=e0f8d0,88c070,346856,081820, ordmg-colors = …in~/.wer/wer.confand then Custom in the menu
The choice is kept in wer.conf as dmg-palette, apart from the SGB palette.
Also
- The fuzzer now also feeds damaged movie files to the reader (it found and fixed a small leak on bad ones).
- Test results unchanged: Gambatte 5225/5225, Mooneye, SameSuite, AGE, Mealybug, Blargg and the rest as before. Save states from 0.10.1 and later still load.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.25.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.25.0-linux-x86_64 |
| Windows x64 | wer-0.25.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.25.0-macos-arm64.zip (not notarized: right-click > Open the first time) |
wer 0.24.0
Zipped games
A .zip opens like the ROM inside it (the first .gb or .gbc in it): from the command line, from the menu's file dialog, or in a browser through the page's button. Saves, save states and patches go by the zip's name (game.sav for game.zip), and a zip with no Game Boy ROM in it, or one that is damaged or encrypted, is refused with a message.
Drag and drop
Drop a ROM (or a zip) on the window to open it, as if chosen in Menu → Open ROM.
STOP
The STOP instruction now does what the hardware does: with no button held, the whole Game Boy stops (screen white, timer, sound and picture standing still) until a button is pressed, as games that use it for a low-power pause expect. Before, it went on like a NOP. With a button held it acts as HALT, as on hardware, and a CPU locked up by an illegal opcode no longer counts as stopped.
Builds
- Every release is now built and tested on GitHub: the test ROM suites run on Linux and on macOS before anything is packaged.
- The Linux binary has SDL built in: it no longer needs SDL 3 installed.
Also
- The fuzzer now also feeds damaged zip archives to the zip reader.
- Test results unchanged: Gambatte 5225/5225, Mooneye, SameSuite, AGE, Mealybug, Blargg and the rest as before. Save states from 0.10.1 and later still load.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.24.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.24.0-linux-x86_64 |
| Windows x64 | wer-0.24.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.24.0-macos-arm64.zip (not notarized: right-click > Open the first time) |
wer 0.23.0
Patches
Fan translations and ROM hacks in IPS, UPS or BPS apply as the game loads, and the ROM file stays as it is. Put game.ips, game.ups or game.bps next to game.gbc, or name one with --patch=FILE. UPS and BPS patches say which ROM they are for, so a patch for another version of the game is refused (with a message, and the game runs unpatched) instead of making a broken one.
Recording
F11 starts and stops recording: the picture as an animated GIF and the sound as a WAV, game-rec-N.gif and .wav next to the game (in a browser they download when you stop). Every frame the game runs goes in, fast forward included, so recordings play at the game's own speed. F11 can be changed in Menu → Controls.
Scripted play
--input presses buttons at given frames, so a game plays the same way every time: --input=400:down,460:a,600:start*30,900:a+b. With --frames and --screenshot, or --record=NAME (which records a whole run, with --headless too), that makes screenshots and clips without touching the keyboard.
Also
- The fuzzer now also feeds random and damaged patches to all three formats.
- Test results unchanged: Gambatte 5225/5225, Mooneye, SameSuite, AGE, Mealybug, Blargg and the rest as before. Save states from 0.10.1 and later still load.
Downloads
| Platform | File |
|---|---|
| Web browsers | wer-0.23.0-web.zip, or play at https://8lall0.github.io/wer/ |
| Linux x86-64 | wer-0.23.0-linux-x86_64 (needs SDL 3.2 or newer) |
| Windows x64 | wer-0.23.0-windows-x64.zip |
| macOS, Apple silicon (11 or newer) | wer-0.23.0-macos-arm64.zip (not notarized: right-click > Open the first time) |