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.
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.
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 adjacentoriginal-gamecheckout; 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.


