Skip to content

HugoRS00/CelebrateShortcut

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ‰ Celebrate Shortcut

A tiny Mac menu bar app that shoots confetti across your entire screen with a keyboard shortcut.

Press βŒ˜β‡§C β†’ emoji confetti (πŸŽ‰πŸŽŠβœ¨πŸ₯³) explodes from the bottom of your screen β†’ disappears after 3 seconds. That's it.

Works on top of every app, even fullscreen ones. No dock icon, no clutter β€” just a small πŸŽ‰ in your menu bar.


Quick Install

Requirements: macOS 14+ and Xcode Command Line Tools (xcode-select --install)

git clone https://github.com/HugoRS00/CelebrateShortcut.git
cd CelebrateShortcut
chmod +x scripts/build.sh
./scripts/build.sh

That's it. The script builds the app, installs it to ~/Applications, and asks if you want to launch it.


How to Use

πŸŽ‰ Trigger confetti Press βŒ˜β‡§C anywhere on your Mac
πŸ–±οΈ Trigger from menu Click the πŸŽ‰ in your menu bar β†’ Celebrate!
⌨️ Change shortcut Menu bar πŸŽ‰ β†’ Preferences β†’ click the shortcut box β†’ press your new combo
πŸ”‡ Toggle sound Menu bar πŸŽ‰ β†’ Preferences β†’ toggle Play celebration sound
πŸ”„ Auto-update Checks GitHub for new releases on launch. Toggle in Preferences
πŸš€ Launch at login Menu bar πŸŽ‰ β†’ Preferences β†’ toggle Launch at login

Start / Stop

Start the app:

open -a "Celebrate Shortcut"

Or double-click Celebrate Shortcut.app in ~/Applications.

Stop the app:

Click the πŸŽ‰ in your menu bar β†’ Quit

# Or from terminal:
pkill -f CelebrateShortcut

Uninstall

chmod +x scripts/uninstall.sh
./scripts/uninstall.sh

Stops the app, deletes it, and clears preferences. Clean.


Troubleshooting

Problem Fix
No πŸŽ‰ in menu bar App isn't running β€” open -a "Celebrate Shortcut"
Shortcut doesn't work Open Preferences, re-record it. Must include ⌘, βŒ₯, βŒƒ, or ⇧
Build fails Run xcode-select --install first

Contributing

PRs welcome! This is a simple SwiftUI + SpriteKit app β€” easy to hack on.

CelebrateShortcut/
β”œβ”€β”€ App/           β†’ App entry point, menu bar setup
β”œβ”€β”€ MenuBar/       β†’ Menu dropdown UI
β”œβ”€β”€ Overlay/       β†’ Transparent fullscreen window + confetti particles
β”œβ”€β”€ Hotkey/        β†’ Global keyboard shortcut
β”œβ”€β”€ Preferences/   β†’ Settings window + key recorder
β”œβ”€β”€ Audio/         β†’ Sound player
└── Settings/      β†’ UserDefaults persistence

To build from source: swift build (or open in Xcode).


License

MIT β€” do whatever you want with it.


Made by Hugo

⚑ tradingwizard.ai β€” Supercharge your trading

About

A tiny Mac menu bar app that shoots confetti across your screen with a keyboard shortcut πŸŽ‰

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors