README.md

January 13, 2026 ยท View on GitHub

Flippy Lid Icon

๐Ÿ’ป Flippy Lid ๐Ÿฆ…

The first productivity tool powered by your hinge!
Built with SwiftUI + Private IOKit Sensors + Pure Chaos

macOS ARM Only License

English | ไธญๆ–‡


๐Ÿง 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)
Demo GIF

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).
Demo GIF

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.
Demo GIF

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.

  1. Hinge Health: Your MacBook hinge is designed for gentle adjustments, not high-frequency flapping. We are not responsible if your screen becomes floppy.
  2. Social Awkwardness: Using this app in public will make people stare at you. Embrace it.
  3. 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

  1. Clone this repository.
  2. Open Flappy.Lid.xcodeproj in Xcode.
  3. Build & Run.
  4. Grant Accessibility Permissions (needed for Key Simulation).
  5. Start flapping! ๐Ÿฆ…

Made with โค๏ธ and questionable judgment by Lizhuo