gitwtfhub

wtf is holo?

justingamer191/holo — explained in plain English

Analysis updated 2026-05-18

424SwiftAudience · developerSetup · moderate

TL;DR

An experimental macOS app that turns the desk around your MacBook into four tap-triggered zones for running custom actions.

Mindmap

mindmap
  root((Holo))
    What it does
      Tap zone detection
      Local classification
      Custom actions
    Tech stack
      Swift
      Xcode
      Core Audio
    Use cases
      Desk shortcuts
      Hands free control
      Acoustic research
    Audience
      Developers
      Mac tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Tap a corner of your desk to trigger a Shortcut, open an app, or run a shell command.

REASON 2

Set up quick physical shortcuts for actions like copying text or taking a screenshot.

REASON 3

Experiment with acoustic tap detection as a research prototype on macOS.

REASON 4

Assign different actions to four desk zones around a laptop for hands-free control.

What's in the stack?

SwiftXcodeXcodeGenCore Audio

How it stacks up

justingamer191/holoeyrefree/efresumekageroumado/phosphene
Stars424390495
LanguageSwiftSwiftSwift
Last pushed2024-04-14
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity2/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires macOS 14+, Xcode, XcodeGen to generate the project, and a full manual calibration process on your own desk before it works.

Wtf does this do

Holo is an experimental macOS utility that turns the desk space around a MacBook into four tappable zones you can assign actions to. It listens through the Mac's built in microphone, analyzes short bursts of sound from a tap, works out locally which of the four zones the tap came from, and then runs whatever action you assigned to that zone. The four zones sit in a fixed layout: a rear and front zone on the left side of the laptop, and a rear and front zone on the right side. The project describes itself as a research prototype rather than a finished product. Its automated signal processing tests pass, but how accurately it actually recognizes taps still depends on the specific MacBook, desk, room, and laptop position being used, and the project asks that no accuracy claims be made without running its own 60 tap evaluation on that exact setup. Setting it up starts with a calibration process: you tell Holo about your desk and MacBook position, then tap each of the four zones ten times, spreading the taps around rather than hitting the same spot, while Holo rejects taps that are too weak, muffled, or too loud. After all 40 samples are collected, Holo checks how consistent each zone was and lets you redo any zone that came out weak before saving the profile. You can also record background sounds like talking, typing, or room noise as negative examples so Holo learns to ignore them. Once a profile is set up, each of the four zones can be assigned one action, such as showing a visual highlight only, playing a system sound, copying or speaking text, opening a website, running a Shortcut, opening an app or file, running a shell command, or taking a screenshot. Actions only fire when Holo is confident about a tap, taps it is unsure about, or that happen while you are calibrating or testing, do not trigger anything. Building Holo requires macOS 14 or later, Xcode, and a tool called XcodeGen to regenerate the Xcode project file, and it only works with the MacBook's own built in microphone rather than an external one.

Yoink these prompts

Prompt 1
Walk me through calibrating Holo's four tap zones on my desk.
Prompt 2
Explain how Holo tells the difference between a real tap and background noise like talking or typing.
Prompt 3
Help me build Holo from source using XcodeGen and Xcode.
Prompt 4
What actions can I assign to a Holo tap zone, and how do I set one up to run a Shortcut?

Frequently asked questions

wtf is holo?

An experimental macOS app that turns the desk around your MacBook into four tap-triggered zones for running custom actions.

What language is holo written in?

Mainly Swift. The stack also includes Swift, Xcode, XcodeGen.

How hard is holo to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is holo for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.