Skip to content

aishwaryanatesh-hub/Oinkulus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

13 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🐷 Oinkulus

a fidget for your eyes

A tiny macOS fidget app: a pixel pig that glides gently across your screen.
A calm, repetitive bit of motion to fidget on while you read, think, or breathe.
No clutter. No Dock icon. Tiny menu bar icon. 🀏🏽


🐷 flies bilaterally Β· πŸ–±οΈ change the speed Β· πŸ…ΏοΈπŸ…ΈπŸ…ΆπŸ†‚πŸ…΅πŸ…»πŸ†ˆ letters


Oinkulus

πŸ’­ Why I made this

I live with anxiety and ADHD, and reading long blocks of text can be hard: my eyes skip and my mind wanders. One day I set a pixel pig flying across the top of an article and read underneath it. It just worked.

  • 🌿 The gentle, repetitive motion settles my nervous system, like watching waves.
  • πŸŒ€ The pig adds just enough variation for my ADHD brain. A small visual fidget, kind of like brown noise but for my eyes: enough to stay engaged, not enough to distract.

If your brain works like mine, I hope it helps you too. πŸ·πŸ’›

πŸ“₯ Install (60 seconds)

  1. ⬇️ Download the latest Oinkulus.dmg
  2. Open it and drag Oinkulus into Applications.
  3. First launch: this build isn't signed by Apple yet, so macOS will say it "can't be checked." Go to System Settings β†’ Privacy & Security, find the Oinkulus notice, and click Open Anyway. One time only. βœ…

πŸ·πŸ’› Oinkulus is not a medical device and makes no clinical claims.

▢️ Using it

Oinkulus has no window. It starts flying the moment you open it and lives in your menu bar as a 🐷 (which turns to πŸ’€ when paused).

To read with it: open any article, PDF, or doc and let the pig fly over your text. It's click-through, so you can still scroll, click, and select normally. Press βŒ˜β‡§E anytime to pause or resume.

Menu item What it does
β–Ά / ⏸ Start / Pause Oinkulus Launch or land the pig (βŒ˜β‡§E)
Speed Slow, Medium, Fast
Shape 🐷 Pig, Triangle, Circle, Diamond
Side Letters Toggle the floating letters
Quit Send the pig home

πŸ› οΈ Build it yourself

Requires Xcode and macOS 14 or later.

# Build
xcodebuild -project Overlay.xcodeproj -scheme Overlay -configuration Release build

# ...or build a shareable DMG
./scripts/release.sh        # produces build/Oinkulus.dmg
πŸ” Maintainer notes: signing & notarization (optional)

The default build is unsigned (free, no Apple account). For a warning-free, notarized DMG you need the Apple Developer Program ($99/yr):

  1. Create a Developer ID Application certificate (Xcode β†’ Settings β†’ Accounts).
  2. Store notary credentials once:
    xcrun notarytool store-credentials oinkulus-notary \
      --apple-id "you@example.com" --team-id "TEAMID" --password "app-specific-password"
  3. Set DEVELOPMENT_TEAM and ENABLE_HARDENED_RUNTIME = YES in Overlay.xcodeproj and the teamID in ExportOptions.plist, then run NOTARIZE=1 ./scripts/release.sh.

Made with 🩷 and a flying pig · MIT License

Oinkulus

About

🐷 Oinkulus a fidget for your eyes A tiny macOS fidget app: a pixel pig that glides gently across your screen. A calm, repetitive bit of motion to fidget on while you read, think, or breathe. No clutter. No Dock icon. Tiny menu bar icon. 🀏🏽

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors