whatisgithub

What is picogus?

ianhan/picogus — explained in plain English

Analysis updated 2026-08-08 · repo last pushed 2026-05-29

Audience · generalComplexity · 4/5MaintainedSetup · hard

In one sentence

A small open-source board built around a Raspberry Pi Pico that plugs into vintage DOS PCs and emulates classic 1990s sound cards like the Gravis Ultrasound, Sound Blaster, and AdLib, giving you authentic retro audio without needing rare original hardware.

Mindmap

mindmap
  root((repo))
    What it does
      Emulates retro sound cards
      Outputs authentic audio
      USB mouse and joystick support
    Sound cards emulated
      Gravis Ultrasound
      Sound Blaster variants
      AdLib and CMS
      Tandy and MIDI
    Tech stack
      Raspberry Pi Pico
      RP2040 microcontroller
      Open hardware designs
      Emulation code from DOSBox
    Use cases
      Play classic DOS games
      Demoscene music playback
      Build your own card
      Period-accurate audio
    Audience
      Retro computing fans
      Demoscene enthusiasts
      Vintage PC owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play classic DOS games on original hardware with authentic 1990s sound card audio.

USE CASE 2

Experience demoscene music the way it was meant to sound on vintage PCs.

USE CASE 3

Build your own retro sound card using the project's open hardware designs.

USE CASE 4

Use modern USB mice and joysticks with legacy DOS computers.

What is it built with?

Raspberry Pi PicoRP2040 microcontrollerC/C++Open hardware designsDOSBox-X emulation codeDREAMM emulator code

How does it compare?

ianhan/picogus000madz000/rfid-attendance00kaku/gallery-slider-block
LanguageTypeScriptJavaScript
Last pushed2026-05-292024-07-222021-05-19
MaintenanceMaintainedDormantDormant
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires building or buying a physical board, opening up a vintage PC, installing it in an ISA slot, and configuring DOS software drivers and settings.

The project is open source, meaning the designs and code are freely available for you to use, modify, and build upon.

So what is it?

PicoGUS lets you bring authentic 1990s sound back to vintage DOS computers. It is a small board, built around a Raspberry Pi Pico microcontroller, that plugs into a retro PC and acts like several classic sound cards from that era. The primary focus is emulating the Gravis Ultrasound, a beloved sound card known for its rich audio in demoscene productions and games. But it also emulates Sound Blaster variants, AdLib, Tandy 3-voice, CMS/Game Blaster, and even interfaces with MIDI instruments and certain Panasonic CD-ROM drives. You can also plug in modern USB mice and joysticks. The way it works is by using the Pico's RP2040 chip to electronically pretend to be these old sound cards. When a DOS program tries to play music or sound effects, PicoGUS intercepts those signals and processes them the way the original hardware would have. It then outputs real audio. The project pulls together emulation code from several existing open-source projects, including DOSBox-X and the DREAMM emulator, and runs it on the microcontroller so your vintage computer thinks a genuine 1990s card is installed in its expansion slot. This is designed for retro computing enthusiasts, demoscene fans, and anyone who wants period-accurate audio on original DOS-era hardware. If you have an old 486 or Pentium-era PC and want to play classic games like they originally sounded, or experience demoscene music the way it was meant to be heard, this gives you a modern way to do it without hunting down rare and expensive vintage sound cards. The project notes that GUS support in games is very good to excellent. The project is open source and openly described as a work in progress. The creator notes that due to the nature of emulation and the varying specs of old PC hardware, some things will likely never be perfectly accurate. Fully assembled cards are available from several shops that ship worldwide, or you can build your own using the project's open hardware designs. The creator also accepts donations of motherboards and funds to help test and improve compatibility across more vintage systems.

Copy-paste prompts

Prompt 1
Help me build a PicoGUS board for my vintage 486 PC, what components do I need and what are the assembly steps?
Prompt 2
I have a PicoGUS board and want to use it with DOS games. Walk me through flashing the firmware and configuring it for Gravis Ultrasound emulation in DOS.
Prompt 3
Explain how to switch my PicoGUS between Sound Blaster and AdLib emulation modes for different DOS games.
Prompt 4
My PicoGUS isn't producing sound in my vintage PC. Help me troubleshoot common issues like ISA slot configuration, port addresses, and IRQ settings.

Frequently asked questions

What is picogus?

A small open-source board built around a Raspberry Pi Pico that plugs into vintage DOS PCs and emulates classic 1990s sound cards like the Gravis Ultrasound, Sound Blaster, and AdLib, giving you authentic retro audio without needing rare original hardware.

Is picogus actively maintained?

Maintained — commit in last 6 months (last push 2026-05-29).

What license does picogus use?

The project is open source, meaning the designs and code are freely available for you to use, modify, and build upon.

How hard is picogus to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is picogus for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.