GitHub - guax/frozen-bubble: A rust remake of the classic linux frozen bubble game.

GitHub

5 min read Original article ↗

The classic Linux bubble shooter, reimplemented in Rust with its original artwork, music, and 100-level single-player campaign.

An independent community remake. This project is not an official Frozen-Bubble release. It focuses on preserving the feel of the original single-player game while running on a modern Rust stack.

Single-player gameplay, with a shot in flight and the launcher already reloaded

Play

macOS app

Download the ZIP for your Mac from this repository's Releases page when a release is available:

  • arm64 for Apple Silicon Macs.
  • x86_64 for Intel Macs.

Unzip it, drag Frozen Bubble.app into Applications, and double-click it. The app has the original penguin icon and launches directly without Terminal. Graphics, levels, and audio are embedded; no separate asset download is needed.

Local builds are ad-hoc signed, not Apple-notarized. Check each release's notes for signing and notarization status. Maintainers can follow the macOS release guide to prepare a signed public download.

Build from source

Install a current stable Rust toolchain, then run from the repository root:

cargo run --release --locked

On macOS, install Xcode Command Line Tools and Python 3, then build the double-clickable app:

This creates dist/Frozen Bubble.app, an architecture-labelled ZIP, a matching source archive, and SHA-256 checksums. cargo build --release on its own still produces a command-line executable; make release adds the macOS bundle and icon. No Python packages or third-party packaging tools are required.

Linux builds need graphics drivers, X11 and ALSA development libraries. On Debian/Ubuntu:

sudo apt install build-essential pkg-config libx11-dev libxi-dev libgl1-mesa-dev libasound2-dev
cargo run --release --locked

macOS is the currently exercised release platform. Linux and Windows use Macroquad's platform backends but are not yet verified release targets for this remake.

What's included

  • All 100 original campaign levels and the original graphics, soundtrack, and effects.
  • Matching groups, wall rebounds, falling bubbles, and the descending ceiling.
  • Original penguin aiming, firing, idle, victory, and losing animations.
  • Menus with original artwork, level previews, and an animated pause screen.
  • Saved level unlocks, retry/resume, fullscreen, and adjustable audio.
  • Smooth or sharp scaling and the original colourblind bubble artwork.

Single-player menu using the original artwork

The original animated pause presentation

Controls

Key Action
Left / Right Aim; select a level in the level picker
Up / Space Fire
Down Centre the cannon
Enter Start, retry after losing, or advance after winning
P Pause / resume
R Restart the current level
Escape Open menu, go back, or resume the current game
Up / Down in menus Select an option
F Toggle fullscreen
M / F11 Toggle music
F12 Toggle sound effects

The home menu also accepts mouse selection. Submenus display their keyboard controls. Choose Quit to exit during a campaign.

Progress and preferences

Progress is saved in $XDG_DATA_HOME/frozen-bubble-remake/progress, or ~/.local/share/frozen-bubble-remake/progress when that variable is unset. Set FROZEN_BUBBLE_SAVE to override the full save-file path. Graphics/audio preferences live in a separate settings file beside it.

Only unlocked levels are selectable. Restarting a level does not erase progress, and opening the menu preserves the current game.

Fidelity and scope

The simulation follows the original's 32px bubbles, 28px staggered rows, 20ms steps, shot/aiming speeds, collision threshold, groups of three, and ceiling-connected falling groups. The ceiling lowers every ninth shot; the hurry warning appears after eight seconds and forces a shot at 10.5 seconds. The launcher reloads immediately while the previous ball is still flying.

The game retains the original 640×480 composition, letterboxes resized windows, and interpolates projectile movement. PNG/Ogg assets and levels are copied unchanged; GIF bubbles are decoded losslessly to PNG. The asset import script is provided for provenance, but the original checkout is not required to build or play.

This is a work in progress, not a claim of pixel-perfect or fully identical gameplay. Known remaining single-player work includes random-level mode, original high-score tables, and exact transition timing. Collision snapping selects the nearest empty neighbor; some edge cases differ from the original coordinate-rounding implementation.

Multiplayer, network play, local versus, recordings, and the level editor are outside this project's scope.

Contributing

Bug reports, single-player fidelity fixes, and platform testing are welcome. See CONTRIBUTING.md, the changelog, and release instructions.

make check
cargo run --release -- --smoke-test

The render check writes nine screens to /tmp/frozen-bubble-*.png, including an in-flight shot with the launcher already loaded, and exits without modifying progress or preferences.

  • src/lib.rs: deterministic gameplay and regression tests.
  • src/animation.rs: original penguin frame sequences and tests.
  • src/main.rs: input, drawing, menus, audio, and saves.
  • build.rs: embeds assets in the executable.
  • tools/import_assets.py: imports from an adjacent original-game checkout; requires Pillow only when regenerating assets.
  • tools/release_macos.py: creates the macOS app, archives, and checksums.

License and credits

GNU GPL version 2 only — GPL-2.0-only. See COPYING for the complete, unmodified original license and NOTICE for provenance and attribution. The original explicitly specifies GPL version 2; this remake carries that license forward. There is no warranty.

Original game and assets © 2000–2012 The Frozen-Bubble Team:

  • Design and programming: Guillaume Cottenceau.
  • Artwork: Alexis Younes and Amaury Amblard-Ladurantie.
  • Soundtrack: Matthias Le Bidan.

The complete original credits are preserved. Rust remake contributions are licensed under GPL-2.0-only. Third-party Rust dependencies retain their own licenses. The app and release archives include the license and credits; publish the matching source archive alongside binary releases.