README.md
January 13, 2026 ยท View on GitHub
๐ป Flippy Lid ๐ฆ
The first productivity tool powered by your hinge!
Built with SwiftUI + Private IOKit Sensors + Pure Chaos
๐ง What is this sorcery?
Flippy Lid turns your MacBook's lid into a physical input controller. Yes, really.
By tapping into the hidden hinge angle sensors (via some dark IOKit magic ๐งโโ๏ธ), we detect when you open or close your laptop. We then translate those physical "flaps" into digital actions.
It's the only app that gives your hinge a workout while you procrastinate.
๐ Features
1. ๐ฎ FLAPPY GAME
The classic game, but you control the bird by physically flapping your MacBook screen.
- Open Lid = Flap Up
- Risk Level: High (Please don't snap your screen)
2. โจ๏ธ KEY SIMULATOR (Universal Controller)
Map your lid "flaps" to ANY keyboard key.
- Map it to Space -> Play Chrome's Dinosaur Game physically.
- Map it to W -> Walk forward in games by oscillating your screen.
- The possibilities are endless (and ridiculous).
3. ๐ LID PASSWORD (James Bond Mode ๐ต๐ปโโ๏ธ)
Automatically type a preset password when you perform a secret "Lid Handshake".
- Trigger: Quickly open/close your lid 3 times.
- Action: Type the preset password in any input box.
- Cool Factor: 11/10 when done in a coffee shop.
4. ๐ก Got more wild ideas?
Open an issue here or just fire off a PR!
๐ก The "Science"
This project stands on the shoulders of giants (and reverse engineers):
- The Sensor: MacBooks have Hall Effect sensors or similar mechanisms to detect lid angle for sleep/wake. We read the raw data from
IOHIDDevice. - The Pioneer: LidAngleSensor by Sam Henri Gold. He did the hard work of finding the magic IOKit keys.
- The Spark: Directed by this tweet from @rebane2001, who wisely asked: "Can I jump by flappy my foldable device?"
โ ๏ธ Warning: Read Before Flapping
Warning
USE AT YOUR OWN RISK.
- Hinge Health: Your MacBook hinge is designed for gentle adjustments, not high-frequency flapping. We are not responsible if your screen becomes floppy.
- Social Awkwardness: Using this app in public will make people stare at you. Embrace it.
- Compatibility:
- ARM Macs Only: Specifically designed for M1/M2/M3 MacBooks. Intel Macs use different sensors (and are too hot to touch anyway).
- Private APIs: We use private APIs. Apple could patch this loophole at any moment. Enjoy it while it lasts!
๐ฎ๐น๏ธ๐พ How to Play
Download the latest release from Releases and double-click the DMG file to install.
๐ ๏ธ How to Build
- Clone this repository.
- Open
Flappy.Lid.xcodeprojin Xcode. - Build & Run.
- Grant Accessibility Permissions (needed for Key Simulation).
- Start flapping! ๐ฆ