Skip to content

README.md

Latest commit

 

History

History
77 lines (51 loc) · 3.49 KB

README.md

File metadata and controls

77 lines (51 loc) · 3.49 KB
Raw

It's GOAT time

Your MacBook has a lid. Open it and find out.

It's GOAT time is a native macOS menu bar app that uses your MacBook's built-in lid angle sensor to detect when you open the lid — then screams like a goat. Every. Single. Time. It's the app nobody asked for but everybody needs.

What does it do?

When you open your MacBook lid (even a tiny bit), the built-in lid angle sensor picks up the movement. It's GOAT time translates that into a goat bleat — because obviously that's what should happen when you open a laptop.

Sound modes:

  • Classic Bleat — A solid, no-nonsense "baaah"
  • Baby Goat — High-pitched, adorable, slightly unhinged
  • Screaming Goat — The internet-famous dramatic goat scream
  • Billy Goat — Deep, guttural, authoritative
  • Goat Chorus — Multiple goats. At once. You're welcome.
  • Random — Let fate decide which goat greets you

Features

  • Lives in your menu bar — zero desktop clutter
  • Real-time lid angle display with status labels
  • Sound mode picker with instant preview buttons for each bleat
  • Volume slider
  • Sensitivity control — set how many degrees of lid movement triggers a bleat
  • Launch at login — because your Mac should always be ready to scream
  • All settings persist across restarts via UserDefaults
  • Auto-enable on launch — picks up right where you left off
  • In-app update checker via GitHub releases API
  • No sudo required — lid angle sensor is accessible without admin privileges

Install

  1. Download ItsGOATtime.zip from the latest release
  2. Unzip it, then right-click Install.command → Open (not double-click)
  3. Click Open when macOS asks for confirmation — this only happens once
  4. The installer copies the app to Applications, removes quarantine, and launches it
  5. Look for the 🐐 in your menu bar and open your lid

Why right-click → Open? macOS blocks unsigned apps and scripts downloaded from the internet. Right-click → Open bypasses this for the installer script. You only need to do this once — future launches work normally.

Build from source

git clone https://github.com/thefactremains/ItsGOATtime.git
cd ItsGOATtime
./build.sh

Output lands in .build/.

Requirements

  • macOS 13+ on Apple Silicon (M2+ recommended — does NOT work on M1)
  • MacBook Pro 2019+ with lid angle sensor
  • Xcode Command Line Tools

How it works

It's GOAT time is a single-process native Swift menu bar app. It reads the MacBook's lid angle sensor directly via IOKit HID — no external binaries, no sudo, no subprocess. The sensor (Apple VID 0x05AC, PID 0x8104) reports the lid angle as a 16-bit value via HID Feature Reports, polled at 10Hz.

When the angle increases from its baseline by more than the sensitivity threshold, a goat bleat plays. The baseline resets after each bleat and tracks downward movement, so closing and reopening the lid (or even nudging it open a fraction) triggers another bleat.

All five goat sounds were generated using the ElevenLabs sound generation API.

Why?

Because every time you open your laptop, something meaningful should happen. And what's more meaningful than a goat screaming at you?

Also, it's a great way to announce your presence in a meeting.

Built with questionable judgment by @thefactremains

Powered by LidAngleSensor research by @samhenrigold