| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| PanicButtonFramework_1.2.0.0_setup.exe | 2026-11-15 | 51.0 MB | |
| Totals: 1 Item | 51.0 MB | 2 | |
Panic Button Framework
An open-source system telemetry and psychological anomaly correction utility featuring low-latency reality scanning, micro-arcade diagnostics, and a single high-priority button to make everything normal again.
A professional tool for improving everything. A joke desktop app in JavaFX for cheering people up.
Want to help with code, translations, sounds or a new mini-game? See CONTRIBUTING.md. What is new: CHANGELOG.md.
Features
- "Make everything good" button. A progress bar runs through steps like "Deleting extra Mondays..." and gets stuck at 97% for drama. Then the app asks whether everything is good now. Answer yes and it closes, its mission accomplished. Answer no and it suggests you "adjust your objective reality settings and try again".
- Tic-Tac-Toe: Mortal Battle. You play against the computer, with an over-the-top announcer in the style of 90s fighting games: ROUND 1, FIGHT!, KILL HIM!, FLAWLESS VICTORY!. The announcer is voiced, and every move has a hit sound. When you start it from the menu, you pick the difficulty: Hard 3×3 (a flaming skull) is the real game, and Easy 2×2 (a pacifier) is a 2×2 board where you always move first: the CPU boasts "YOU'LL NEVER WIN!" and loses with your next move to a BANALITY!
- Minesweeper: Mood Minefield. The field hides grumpy "bad moods" instead of mines. Left click opens a cell, right click plants a flag, and clicking a number whose flags are all set opens its neighbours. The first click is always safe. There are three difficulties (Easy 9×9, Medium 11×14, Hard 11×20). Cells open in a wave, a mood face reacts to every click, and an explosion brings a flash, a screen shake and GAME OVER. A win gets YOU WIN! (and FLAWLESS VICTORY! if you used no flags). The commentary is translated into every language.
- Holiday decorations. On international holidays an animated picture sits on the top left corner of the window. Themed particles fly in the background and a greeting appears in the title bar:
- New Year (Dec 1 – Jan 7): a swaying Santa hat and snow;
- Valentine's Day (Feb 14): a beating heart and rising hearts;
- Women's Day (Mar 8): tulips and petals;
- International Day of Happiness (Mar 20): a smiling sun and confetti;
- April Fools' Day (Apr 1): a jester hat;
- Children's Day (Jun 1): balloons;
- Programmers' Day (256th day of the year): a retro monitor and falling bits;
- Halloween (Oct 24–31): a flickering pumpkin, swinging skulls and bats.
To preview a holiday, run with -Dpanicbutton.holiday=HALLOWEEN (or NONE to turn decorations off).
- Fighter select. The game opens with a fighting-game style CHOOSE YOUR DESTINY screen, announced by a starship computer voice. Pick a fighter with the mouse or the arrow keys and Enter: Crosses (CROSSBONES with crossed harpoons, CHAIN REACTION with a harpoon on a chain, classic MR. X) or Noughts (SNOWBALL the ice ball, HAT TRICK the flying straw hat, classic BIG ZERO). The CPU then spins a roulette over the other side, and a VS... READY? screen starts the fight. Crosses move first. The commentator calls fighters by name.
- Juicy pieces. A piece does not just appear: it drops onto the board with a thud, a squash and its own impact sound.
- Futuristic look. The app uses its own borderless neon window instead of the standard Windows frame.
- Drag the window by its title bar.
- The close button is a harpoon-on-a-chain cross, and the minimize button is a piece of chain lying at the bottom. There is no maximize button.
- The background is a live synthwave grid with drifting sparks.
- Screens change with a scanner beam, buttons spring under the mouse, and the window shuts down like an old CRT.
- Retro music. A 90s tracker synthwave theme plays in the menu. The fighter select screen has its own sci-fi select theme, and the fight itself gets a shuffled playlist of retro fight tracks. Tracks crossfade when you switch screens. Turn the music on or off with the ♫ button in the title bar, and all sound effects and announcer lines with the speaker button next to it. Both choices are remembered. The ? button shows the About dialog.
- Multilingual: English, Russian, Lithuanian, German, French, Chinese, Japanese. On first launch the app picks the system language, and remembers your choice after that. You can add or edit languages without recompiling (see
languages/README.txt). - Replaceable sounds. All sounds and music live in the
sound/folder next to the program. Replace any WAV file there to change a sound, no recompiling needed (see below). - Scene Builder. All screens are FXML files you can edit in Scene Builder.
Downloads
Get them from the Files page of the project: https://sourceforge.net/projects/panic-button-framework/files/
| File | For |
|---|---|
PanicButtonFramework_<version>_setup.exe |
Windows 10/11 x64 installer, Java inside |
PanicButtonFramework-<version>-windows-x64.zip |
Windows x64: unpack anywhere and run the exe, Java inside |
PanicButtonFramework-<version>-linux-x64.zip, -linux-aarch64.zip |
Linux x64 / 64-bit ARM (Raspberry Pi 4/5): unpack and run PanicButtonFramework.sh, Java inside |
panicbuttonframework_<version>_amd64.deb, _arm64.deb |
Debian / Ubuntu: sudo apt install ./panicbuttonframework_<version>_amd64.deb (uses the system Java 21+) |
PanicButtonFramework-<version>-macos-aarch64.zip, -macos-x64.zip |
macOS 11+ on Apple silicon / Intel: an app with Java inside (not signed by Apple, see "How to open.txt") |
The Windows setup asks whether to install for the current user only, without administrator rights, into %LOCALAPPDATA%\Programs\Panic Button Framework, or for all users, with administrator rights, into Program Files. For silent installs use /CURRENTUSER or /ALLUSERS together with /VERYSILENT. Uninstalling also removes the saved settings.
Build and run
You need a JDK 21 and Maven 3.9 (NetBeans includes Maven).
mvn package
java -jar target/PanicButtonFramework-<version>-jar-with-dependencies.jar
In NetBeans: Open Project → Run (F6).
mvn package makes the program for every platform: target/PanicButtonFramework-<version>.exe (the Windows program, made by Launch4j with the program and JavaFX inside; it starts the Java runtime in the jre folder next to it) and one jar with all dependencies per platform (Windows and Linux x64, Linux ARM, macOS Intel, macOS Apple silicon).
Installers and archives
Install\build_all.bat builds all downloads of a release into Install\Install_executables: the Windows setup (Inno Setup 6, Install\Create_install.iss), the Windows, Linux and macOS zip archives and the Debian packages. Each step can also run on its own:
"C:\Program Files (x86)\Inno Setup 6\ISCC.exe" Install\Create_install.iss
powershell -ExecutionPolicy Bypass -File Install\build_zip_windows.ps1
wsl bash Install/build_zip_linux.sh x64 # or aarch64
wsl bash Install/build_zip_mac.sh aarch64 # or x64
wsl bash Install/build_deb.sh amd64 # or arm64
Requirements: Inno Setup 6; WSL (or Linux) with zip and dpkg-deb; the Azul Zulu JRE 21 downloads in Install\jre (not in git): the unpacked Windows x64 folder zulu21*jre*win_x64 and the archives zulu21*jre*linux_x64.tar.gz, linux_aarch64, macosx_x64 and macosx_aarch64.
Languages
The phrases under the "Make everything good" progress bar live in separate files: languages/progress_XX.txt, one phrase per line. Each pass shows up to 10 random phrases with no repeats. If a file has fewer than 10 phrases, or there is no file, the built-in standard phrases are added.
Translations live in languages/messages_XX.properties, in UTF-8. To add a language, copy messages_en.properties, rename it (for example to messages_de.properties), set language.name=Deutsch and translate the values. The app picks it up without recompiling.
Sounds
Sounds are not compiled into the program. They are read at runtime from the sound/ folder, and music is in sound/music/. The folder is looked for in the same places as languages/: in the working directory or next to the program. You can also pass -Dpanicbutton.sound=path. If the folder is missing, the program simply runs silently.
All sounds come from CC0 packs by Kenney, qubodup and BMacZero, imported by tools/import_cc0_sounds.py. See CREDITS.md for details.
To change a sound, replace the WAV file with the same name in sound/. For example, replace sound/fight.wav. The change shows up on the next screen switch. Do not commit or redistribute sounds you have no rights to.
| File | When it plays |
|---|---|
choose_your_destiny |
The fighter select screen (a starship computer voice, see below) |
you_ll_never_win, banality |
Tic-Tac-Toe easy mode: the CPU's boast after your first move, and its defeat |
ready |
VS screen after both fighters are chosen |
round_1 … round_5, final_round |
Round start (from round 6 on, every round is the "final" one) |
tie_breaker |
Round start after a draw |
player_1, player_2 |
Who moves first |
championship_mode, survival_mode |
Instead of player_* when you lead or trail by 3+ wins |
fight |
After the round announcement |
begin |
Minesweeper: start of a game |
kill_him, kill_it |
When you are one move away from winning |
sudden_death |
When the computer is one move away from winning |
3, 2, 1, time |
Countdown when you think for more than 8 seconds |
you_win, you_lose, it_s_a_tie, tie |
End of a round |
flawless_victory |
You won in 3 moves |
combo_breaker, multi_kill, winner |
Finishing announcements after your win |
game_over, loser |
After the computer wins |
combo, prepare_yourself |
Matching commentary lines |
toasty |
Easter egg: a lightning-fast first move into the very centre |
making_everything_good, you_win |
"Make everything good": a starship computer voice says "Making everything good" over a scanner sweep at the start, and YOU WIN! plays when you press "Yes, everything is good" |
msw_boom, msw_tick, msw_flag |
Minesweeper: explosion, opening a cell, planting a flag |
hit_x, hit_o, block |
Moves with classic X / O, and blocks |
drop_harpoons, drop_chain, drop_ice, drop_hat |
A fighter piece lands on the board |
Your own sci-fi voice
tools/make_scifi_voice.py turns a voice recording into a starship computer voice. It cleans up the recording, adds a metallic comb filter, a light robotic tremolo and a hall echo, and can put a scanner sweep under the voice. Put the recording into recordings/ and run:
python tools/make_scifi_voice.py recordings/making_everything_good.wav
The result replaces sound/making_everything_good.wav, the phrase that plays when you press "Make everything good". Use --name for another sound, --pitch to shift the voice, and --no-sweep to leave out the scanner sound.
Music
All tracks are CC0 (public domain) and come from OpenGameArt; see CREDITS.md. They are stored in sound/music/ as 24 kHz mono mu-law WAV files. Java plays this format without extra libraries, and the files are half the size of 16-bit WAV.
| File | Where |
|---|---|
menu_midnight_drive |
Main menu and "Make everything good" |
select_sci_fi |
Tic-Tac-Toe: fighter select screen |
fight_boss_fight_2, fight_cyber_runner, fight_arion |
Tic-Tac-Toe: the fight; Minesweeper (shuffled, looping) |
To change a track, replace the WAV file with the same name in sound/music/.
Adding a mini-game
The main menu shows mini-games as cards in a grid. The grid wraps into new rows and scrolls when there are many games. To add a game:
- Create its screen:
src/main/resources/com/iton/moodbooster3000/YourGame.fxmland a controller. - Add one entry to the
GAMESlist inMainMenuController: the title and description keys, a small picture for the card and what a click does (usually() -> App.setRoot("YourGame"); Tic-Tac-Toe asks for the difficulty first). - Add
menu.yourGameandmenu.yourGame.descto everylanguages/messages_XX.propertiesfile.
Project layout
languages/ translations (edited without recompiling)
sound/ sounds and announcer voice (WAV); sound/music/ - music
src/main/java/ Java code: Launcher, App, controllers, I18n, Sound, Music
src/main/java-templates/ Version.java (gets the version from pom.xml)
src/main/resources/ FXML screens, CSS, English fallback texts and phrases
src/assembly/ fat jars for Linux ARM and macOS
Install/ installer, archive and package scripts, icons
licenses/ license texts of the third-party components
recordings/ original voice recordings for tools/make_scifi_voice.py
tools/ sound import (CC0 packs) and generator scripts
sound_packs/ downloaded full CC0 packs (git-ignored, see CREDITS.md)
Disclaimer
This is a non-commercial parody. It is not affiliated with, endorsed by, or sponsored by Warner Bros. Entertainment, NetherRealm Studios or Midway Games. "Mortal Kombat" and "Fatality" are trademarks of their respective owners and are mentioned only for parody and reference. The project contains no audio, graphics or code from any Mortal Kombat game.
License
Copyright 2026 Igor Tonkovic. Panic Button Framework is licensed under the Apache License 2.0 with the Commons Clause License Condition v1.0: you may use, change and pass it on for free, but selling it (or a product or service that mainly consists of it) is not permitted without the author's permission. Versions up to 1.1.0 stay under the MIT License.
The third-party components (OpenJFX, the Java runtime, the Launch4j starter) are listed in THIRD-PARTY.txt, the sounds and the music in CREDITS.md.