A little Liquid Glass panel in the menu bar that fixes the everyday kinks of macOS.
It records meetings with a transcript, grabs text and colors off the screen, sends every link
to the right browser, mounts your servers in Finder, and unsticks the Dock, Finder,
Notification Center and Universal Control.
Meetings · Tools · Keep Awake · iPad · Universal Control · Links · Drives · Restart · Glass · Install
Click the paw in the menu bar and a glass panel drops down with everything in one place. Each part below is a section of that panel. Pages like Restart, Universal Control and Settings slide in, and the glass stretches to fit them. Escape or a click anywhere else closes it.
It's a handful of Swift files built from the command line. It needs nothing else, except Homebrew's whisper.cpp and ffmpeg for meeting transcripts. It runs as you and never asks for an admin password.
|
Record sits at the top of the panel. Screen records the screen the pointer is on, with all sound and your mic. Audio records just the two sides of the call, with no video. While it runs, the menu bar shows a red record button and how long it has been going. Click it to stop, or right-click it for the panel. The strip shows the time and bars that move while sound is coming in and lie flat through silence.
Either one stops a recording that's running. |
When a browser or a meeting app (Zoom, Teams, Webex, Slack, FaceTime) has used the mic for 5 seconds, a panel under the menu bar asks whether to record the call. Record records the screen the call's window is on, Audio Only skips the video, and Not now leaves that call alone until the app lets go of the mic.
When a recorded call goes quiet, meaning its app has stopped using both the mic and the speakers for 8 seconds, the panel counts down 15 seconds before stopping.
These panels show over full-screen apps and appear even with notifications or a Focus turned off. Nothing is ever recorded without you asking, and Offer to record calls in Settings turns the offers off.
|
The recording's folder opens in Finder as soon as you stop. The panel then shows how the transcript is coming along, and Transcript ready when it's done, with the meeting's length and how many action items it found. Open shows An audio-only recording ends up as |
- Transcript. Written on the Mac by whisper.cpp (
brew install whisper-cpp), labelled Me (your mic) and Them (the call). whisper detects the language, Turkish and English included, or you can pick one under Transcript language in Settings. Without headphones your mic also hears the call, and those duplicate lines are dropped. Without whisper, Gremlin falls back to Apple's speech recognition, which only knows a few languages. - Summary. If the Claude Code CLI is installed,
claude -padds a summary, decisions and action items in English at the top, using your Claude login rather than an API key. - Names. With calendar access, a recording is named after the event it happened during, and the transcript and summary list who was invited.
- Smaller copy. ffmpeg (
brew install ffmpeg) compresses the video with x265 at CRF 26 and mixes the call and your mic into one audio track. While any app is using the mic it runs at background priority, so it doesn't slow down a call. An hour-long call takes roughly 15 minutes on an M5, and the panel shows the percentage as it goes.
Recording details
While recording, and until the compressed copy is done, the folder holds recording.mov: 15 fps, one pixel per point of the screen and at most 2560 px, with all other sound and your mic on separate tracks. Recording at Retina resolution and 30 fps made calls drop frames. It's written in 10-second fragments, so a crash or a power cut loses at most the last few seconds. Gremlin moves it to the Trash once the compressed copy is the same length. Without ffmpeg, it is kept.
The panel warns you, and a panel pops up, if the mic sends nothing, or only silence for the first 90 seconds, or if the file stops growing. If recording can't start, Gremlin says so in a dialog and in the panel, with a Fix button when it's a missing permission.
The first transcript downloads whisper's model (large-v3-turbo, about 875 MB) and a voice detection model to ~/Library/Application Support/Gremlin/Models. After that, a call is transcribed in a fraction of its length: 3 minutes of Turkish took 24 seconds on an M5. If Gremlin quits before a meeting is transcribed or compressed, it finishes the job the next time it starts.
The row of round buttons under Record. Each one also has a shortcut that works anywhere.
| Tool | What it does |
|---|---|
| Grab Text ⇧⌘1 |
Drag over any part of the screen (space switches to window mode) and the text in it goes to the clipboard. It uses Apple's on-device text recognition, the same engine as Live Text. If the selection has a QR code or barcode, its content is copied instead. |
| Pick Color ⇧⌘2 |
Opens the system color loupe. The color you click goes to the clipboard as sRGB hex, e.g. #1e1e2e. |
| Plain Paste ⌃⌥⌘V |
Strips the formatting from the clipboard and pastes. |
| Fix Focus ⌃⌥⌘F |
Fixes the menu bar showing one app while your typing goes nowhere, or to a window behind it. That happens most after switching Spaces or using Universal Control. Gremlin takes focus for a moment, hands it back to the app whose window is on top, and raises that window. |
Auto-Fix Lost Focus in Settings does that last one for you. It steps in when the frontmost app has windows on screen but none of them has focus, or another app's window sits on top of them, for 3 seconds. Apps that never report focus properly are left alone after one try. It's off by default because it needs Accessibility permission.
Keeps the display and the Mac awake for 30 minutes to 4 hours, or until you turn it off (∞). Drag the knob or click a stop. The panel shows when it ends and lists any other app that is keeping the Mac awake, and the knob slides down as time runs out. It survives a Gremlin restart until its time is up.
The iPad card shows your iPad's name and whether it's nearby, connected as a display, or away and when it was last seen. Connect (⌃⌥⌘S) makes it a Sidecar display, and Disconnect gives it back. It always takes the iPad: an iPad that is a display for another Mac switches over, and a session this Mac is still holding is dropped and started fresh. With several iPads nearby, it picks the first one.
It uses the same private SidecarCore calls as the Displays menu in Control Center. If a macOS update changes them, the card disappears instead of misbehaving.
|
What it is. Universal Control lets one keyboard and mouse work across Macs and iPads sitting next to each other. You move the pointer past the edge of one screen and keep going on the next device. The pain. After a Mac wakes up, the devices sometimes fail their first handshake, and macOS gives up for good. The pointer stays stuck on one side until you go into System Settings on the right Mac and turn Universal Control off and on. The fix. Gremlin reads Universal Control's logs to spot the moment it gives up, and toggles it for you, retrying with increasing delays. Paired Gremlins talk over the local network, so whichever Mac notices the problem can get the other Mac to toggle. The card in the panel shows what the watcher sees and when it last reset, with Reset now (Reset here once you've paired another Mac). The › button opens this page: the devices, a reset on this Mac, the other one or both, and pairing. |
To pair, install Gremlin on both Macs, choose Pair Another Mac… on each, and click Pair on both if the 6-digit codes match. The details are further down.
Make Gremlin your default browser and every link you click goes through it first, then on to the right browser, profile or app. It removes the tracking on the way. It's off until you press Make Default on the Links page, and macOS asks you to confirm.
When a link is set to Ask Every Time, a panel opens by the pointer. The app you clicked in stays in front until you choose.
| To | Do this |
|---|---|
| Open it | Click a browser, press its letter or number, or use the arrows or ⌃⇥ and then Return |
| Open it behind what you're doing | Hold ⌃ while choosing |
| Always open this site there | ⌘-click the browser, which makes a rule |
| Open a new or private window | Right-click the browser |
| Copy the link | ⌘C |
| Drop it | Esc or click elsewhere |
Links that arrive while it's open join the waiting one, and your choice covers them all.
|
Each link takes the first of these that fits:
Where would this link go? runs a pasted link through all of it and shows the result, without opening anything. The main panel's Links card switches the default in one click, and History shows where recent links went and why. |
A rule opens matching links in a browser, a profile, a private window, the picker or any other app. It can match on:
- The link: a domain (
github.comcovers its subdomains, andgithub.com/bunniesinconly that path), what the link starts with, or a regex. - The app it was clicked in: helpers count as their app, so Slack's helper process is Slack.
With both, both must fit. A rule can also change the link with a script once it has matched, and Try a link checks a rule as you write it. Copy Rules and Paste Rules move them as JSON, and everything lives in ~/Library/Application Support/Gremlin/links.json.
Scripts are JavaScript with url and sourceApp. Return a new link, or nothing to leave it alone:
return url.replace("https://old.example.com", "https://new.example.com")A script under Before any rule can change which rule matches, while one on a rule can't. A script that throws or takes over a second is skipped and the link carries on.
Every link goes through these in order, and each has a switch:
- Unwrap redirect links: Google, Outlook SafeLinks, Proofpoint, Facebook, Instagram, LinkedIn, Slack, YouTube and others wrap outgoing links, and Gremlin takes the real one out without asking the network.
- Expand short links: bit.ly, t.co, tinyurl and about 40 others, plus any you add. Gremlin asks the shortener and stops at its answer, so the page itself never sees the request. If it takes over 2.5 seconds, the short link opens as it is.
- Remove tracking:
utm_*,fbclid,gclidand about 160 others, plus names that only mean tracking on certain sites, likesandton X orsion YouTube.
|
Gremlin finds every browser on the Mac. Choose which ones the picker shows, their order, and the key for each. Find Profiles reads the profiles of Chrome, Edge, Brave, Vivaldi and Firefox, and macOS may ask first. Gremlin only looks when you press it. Each profile can then be shown in the picker or used in a rule. Private windows work in Chrome, Edge, Brave, Vivaldi, Opera, Firefox, Zen and LibreWolf. |
- ⌃⌥⌘L opens the link on the clipboard.
- Open Links with Gremlin and Open Links with Gremlin Picker are services for selected text. Turn them on in System Settings › Keyboard › Keyboard Shortcuts › Services. Hold ⌥ to get the picker from the first one.
- Handoff from an iPhone or iPad goes through Gremlin like any other link.
- A
gremlin:link does it from Shortcuts or a script, which also lets a Focus or an automation change the default:
| Link | Does |
|---|---|
gremlin:open?url=https%3A%2F%2Fexample.com |
Routes it like a click. url can repeat. |
gremlin:open?url=…&prompt |
Shows the picker |
gremlin:open?url=…&app=org.mozilla.firefox |
Opens it there, skipping the rules. Add &profile=Work or &private. |
gremlin:set-default?app=com.apple.Safari |
Changes the default. Use ?prompt for the picker. |
Only http and https links are accepted this way, because any page can open a gremlin: link.
- Links clicked inside a browser stay in that browser. macOS only hands over links that open from outside one.
- Universal Links go straight to their app, because overriding them takes an entitlement from Apple.
- Profiles in Safari and Arc, and Safari private windows, have no way in from outside.
- Firefox profiles made with its newer profile switcher aren't found, only the ones listed in
profiles.ini. - Email links aren't handled, only web links.
- Source apps are a best guess for command line tools.
openhas often exited by the time the link arrives, so the app in front counts instead.
Mount a folder on any server you can ssh into, and it shows up in Finder like a disk. Gremlin connects the way ssh does in Terminal, with your ~/.ssh/config, keys, agent and ProxyJump, so a host that works there works here. There's nothing to install on either end: no macFUSE, no kernel extension, and the server only needs SFTP, which comes with OpenSSH.
|
Add a drive with + on the Drives page, or one of the hosts Gremlin found in your SSH config. It needs a name, the host, and a folder, which is your home folder if you leave it empty. Mount opens it in Finder. It lives in
|
|
On a server like this, macOS keeps Finder tags, download info and other extended attributes in a |
Each drive runs ssh -s <host> sftp and speaks SFTP over it. Gremlin hands those files to macOS's own NFS client from a small NFS 3 server on 127.0.0.1, and mounts it without admin rights. A user can mount NFS on a folder they own, which is why drives live in ~/Drives and not /Volumes.
- Nothing else can use the server: it listens on 127.0.0.1 only, refuses requests from other accounts on this Mac, signs its file handles with a random secret, and hands out the root handle only while Gremlin's own mount runs.
- The mount is soft, with a dead timeout of 45 seconds. If Gremlin crashes with a drive mounted, apps get an error instead of hanging and macOS unmounts it. Gremlin clears any mount left over when it next starts.
- A write is on the server before macOS is told it's done. Names are sent in NFC, the way Linux spells them, so an
şorütyped on the Mac matches the file made on the server. - ssh uses your config minus what doesn't suit a file connection: no port forwardings, remote command or terminal, and it never becomes the connection master a terminal session would rely on.
- Times are kept to the second, as SFTP keeps them.
- The Trash doesn't exist on a server, so deleting in Finder asks to delete right away, as on any network volume.
- Changes made on the server show up within about 15 seconds.
- Permissions come from the server's mode bits. Groups beyond your primary one aren't visible, so Finder can offer to edit a file the server then won't let you save.
- File locks only hold on this Mac.
- Symlinks to absolute paths outside the drive's folder point into this Mac, so they look broken. Ones that stay inside the folder work.
- Spotlight doesn't index it.
|
When part of macOS hangs, restarting just that part usually fixes it, without logging out. The panel has Dock, Finder and Menu Bar one click away, and More opens all of them. A tile restarts its part straight away and says so. Restart All asks for a second click, since it also empties the clipboard. All of these run as you, and macOS starts them again right away. Fix Stuck Notification Center in Settings watches for a macOS 27 bug where a banner freezes halfway in and Notification Center spins at 100% CPU. If it stays above 90% for 30 seconds, Gremlin restarts it. It's on by default. |
| Tile | Restarts | Try it when |
|---|---|---|
| Dock | Dock |
Mission Control, Spaces or ⌃-number shortcuts stop working, often after sleep |
| Finder | Finder |
Finder windows or the desktop stop responding |
| Menu Bar | SystemUIServer |
Menu bar items are missing or frozen |
| Control Center | ControlCenter |
Control Center or its menu bar icons misbehave |
| Notification Center | NotificationCenter |
Banners freeze or notifications stop showing |
| Window Manager | WindowManager |
Stage Manager or window tiling gets stuck |
| Clipboard | pboard |
Copy, paste or drag and drop stop working. This empties the clipboard. |
| Universal Clipboard | useractivityd, then pboard |
Copying on one device no longer pastes on another |
| iCloud Drive | bird |
iCloud Drive stops syncing |
|
Settings › at the bottom of the panel turns features on and off, and Gremlin remembers them between launches.
Everything Gremlin does is logged to |
Every surface, from the panel and its cards and buttons to the record strip and the call panels, takes its look from one place: GlassLook in Glass.swift. It follows the system's Light or Dark Mode. Light looks like a regular macOS menu, and Dark is very dark, so either reads well over any window. Both are Liquid Glass over a blur, and each knob can be changed without rebuilding:
defaults write com.bunniesinc.gremlin glass.dark.tint -float 0.7
defaults write com.bunniesinc.gremlin glass.material clearglass.<knob> changes both modes, and glass.light.<knob> or glass.dark.<knob> changes just one. The next panel that opens uses it, and defaults delete com.bunniesinc.gremlin glass.dark.tint goes back to the default.
| Knob | Light | Dark | What it changes |
|---|---|---|---|
material |
frosted |
frosted |
frosted is Liquid Glass over a blur that reads well anywhere; regular is Liquid Glass alone; clear is see-through and only readable over plain backgrounds |
tint |
0.5 |
0.5 |
How strongly the tint color covers the blur |
tintColor |
#FFFFFF |
#0C0A14 |
The tint color |
radius |
30 |
30 |
The panel's corner radius |
rim |
0.1 |
0.14 |
How strong the panel's edge is |
textShadow |
0 |
0 |
A shadow behind text, for see-through glass |
subtext |
0.55 |
0.6 |
How strong secondary text is |
card |
0.04 |
0.06 |
How filled the cards are |
control |
0.07 |
0.1 |
How filled buttons, pills and tiles are |
strip |
0.05 |
0.4 |
How dark the record strip is |
Requires macOS 27 and the Xcode Command Line Tools (xcode-select --install).
git clone https://github.com/alicin/gremlin.git
./gremlin/install.shThis builds /Applications/Gremlin.app, signs it, starts it, and adds it as a login item. Run install.sh again after pulling changes. It needs an admin account to write to /Applications, but no password.
For meeting transcripts and the compressed video, also install whisper.cpp and ffmpeg:
brew install whisper-cpp ffmpegThe app is signed with a self-signed "Gremlin Code Signing" certificate that the installer creates in your login keychain the first time. macOS ties permissions to that certificate, so they survive rebuilds. The first build may ask to let codesign use the key; choose Always Allow.
macOS asks for each permission the first time a feature needs it:
| Permission | Needed for |
|---|---|
| Screen Recording | Grab Text, recording meetings (audio-only ones too, since the call's sound comes through screen capture) |
| Microphone | Recording your side of a meeting |
| Accessibility | Auto-Fix Lost Focus, and the paste step of Plain Paste (without it, the clipboard is still made plain and you press ⌘V) |
| Local Network | Pairing with another Mac, and drives on servers in your local network |
| Notifications | Universal Control reset results, finished transcripts |
| Calendars | Naming meeting recordings after the event |
| App data | Reading browser profiles, only when you press Find Profiles |
The shortcuts use Carbon hotkeys, so they need no permission.
Seen on macOS 27.0 (26A428). When the other Mac wakes or comes back into range, Universal Control runs an "initial sync". If the other Mac isn't ready yet, all 6 retries fail. This Mac then marks the peer valid=false and never retries on its own. The other Mac keeps opening a connection every 60 s over AWDL, gets no answer, and hangs up, forever. It only recovers when the peer disappears and comes back, or Universal Control is toggled.
It streams Universal Control's logs as the current user:
/usr/bin/log stream --style ndjson --predicate 'process == "UniversalControl" AND category == "SYNC"'- Gave up:
IDS <peer>: Initial Sync (Retry 6 of 6), thenIDS <peer>: Initial Sync Failed: …, thenIDS <peer>: available=true, valid=false - Recovered:
In-Circle Devices: [<peer>] - Peer gone:
IDS <peer>: Device Unavailable/Device Lost
<peer> is any 8-hex-digit device ID. How long the retries take depends on the failure. -6722 means the other Mac didn't answer, and each retry waits up to ~30 s. -71143 means the other Mac reset the connection during pairing verification, and all 6 retries fail within seconds. -6773 is an iPad refusing because it is busy as a Sidecar display, for this Mac or another one. No reset helps with that, so the watcher leaves it alone.
When a peer gives up, the watcher waits 10 s and flips the same setting as the System Settings toggle, off for 3 s and back on:
defaults -currentHost write com.apple.universalcontrol Disable -bool true
sleep 3
defaults -currentHost write com.apple.universalcontrol Disable -bool falseThe flip makes the peer go unavailable and available again and starts a fresh initial sync. The watcher ignores that unavailable/available pair and judges the reset by the result of the new sync: the peer joining is a recovery, and giving up again is a failed reset. Failed resets back off (10 s, 1 min, 5 min), then it tries again every 30 min while the peer stays stuck. It never resets a peer that is away, and it restarts log stream if it exits. If Gremlin quits mid-flip, Universal Control is switched back on at quit or on the next launch.
Flipping it on this Mac does not always help. When the other Mac is the one refusing the connection (-71143), resets here change nothing and it needs a toggle over there. That is what pairing is for.
Install Gremlin on both Macs and choose Pair Another Mac… on each within 2 minutes. Both show a 6-digit code. Click Pair on both if the codes match. The first time, macOS asks to allow Gremlin to find devices on the local network.
Once paired, the Macs talk over the local network (Bonjour, _gremlin._tcp, TCP port 47101), not over the AWDL link Universal Control uses. When Bonjour can't see the other Mac, Gremlin tries the addresses it last reported, which includes its Tailscale address. Only three messages exist: status, reset (flip Universal Control on the receiving Mac) and stuck (tell the other Mac what this one sees). Each is signed with a key agreed during pairing (Curve25519, HMAC-SHA256), with a timestamp and nonce so it can't be replayed. The key is kept in the login keychain.
Only one of the two Macs runs the resets, so they don't toggle each other at the same time. The other one reports what it sees to that Mac and waits. When a Mac logs -71143, the other Mac refused, so the first reset happens on the refusing Mac. Otherwise it happens on the Mac that saw the failure. The next ones go to the other Mac, then both. If the other Mac can't be reached, each Mac falls back to resetting itself.
The Universal Control page does the same by hand: on this Mac, on the other one, or on both.
Resets and their results go to the panel, to a notification, and to ~/Library/Logs/Gremlin.log.
Don't reset Universal Control any other way. killall UniversalControl is ignored, launchctl kickstart -k gui/$UID/com.apple.ensemble is refused by SIP, and kill -9 gets it relaunched but left the other Mac holding a dead session until Universal Control was toggled on that Mac.
Uninstall
Turn off Start at Login, quit Gremlin, then:
rm -rf /Applications/Gremlin.app
rm -rf ~/Movies/Meetings # only if you don't want the recordings
rm -rf ~/Library/Application\ Support/Gremlin
defaults delete com.bunniesinc.gremlin
security delete-generic-password -s com.bunniesinc.gremlin.peer ~/Library/Keychains/login.keychain-db
security delete-generic-password -s "Gremlin Drives" ~/Library/Keychains/login.keychain-db # once for each saved drive password
security delete-identity -c "Gremlin Code Signing" ~/Library/Keychains/login.keychain-db