Nameplate adds customizable, click-through overlays (frame, name tag, watermark, splash, menu bar) to macOS, Windows, and Linux machines to distinguish them during remote desktop sessions.

Stars

60

7-day growth

No data

Forks

3

Open issues

0

License

MIT

Last updated

2026-07-16

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It solves a common frustration for remote workers and fleet managers by providing persistent visual identity per machine, with cross-platform support, scriptable attention alerts, and a fleet-wide configuration file.

Who it is for

  • Remote workers managing multiple machines
  • IT administrators with heterogenous fleets
  • Developers or operators using AI agents that need human intervention
  • Jump Desktop / Screen Sharing users

Use cases

  • Identifying which machine you've remoted into by a colored frame and name tag
  • Alerting a user via attention alerts when an automated script needs input
  • Managing fleet identities via a shared JSON file synced across machines
  • Quickly glancing at system info (uptime, IP, CPU, RAM) from the menu bar

Strengths

  • Cross-platform support (macOS, Windows, Linux) with consistent features
  • Non-intrusive overlays that don't consume workspace and are click-through
  • Fleet file for centralized configuration across machines
  • CLI and Darwin notifications for scripting attention alerts and splash

Considerations

  • Splash triggers are heuristic-based due to lack of public remote session API on macOS
  • Linux version requires GTK4 runtime and is best-effort on Wayland
  • No official package manager for Windows (only zip release)

README quick start

Nameplate

Brand every machine in your fleet — macOS, Windows, and Linux — so you always know which one you just remoted into.

If you drive a herd of Macs over Jump Desktop, Screen Sharing, or any other remote desktop, the screens all look the same. Nameplate gives each Mac an unmistakable identity — like an aircraft livery — rendered as click-through overlays that float above everything:

  • Frame — a colored border around every display, with rounded corners that follow the screen's curve. Always visible, costs zero pixels of workspace, survives fullscreen apps.
  • Name tag — a small pill with the Mac's name (and an optional emoji glyph) pinned to a corner.
  • Watermark — a big translucent name across the screen, readable from across the room.
  • Connect splash — the machine's identity locks into focus with a traced perimeter and animated nameplate when a remote session likely just started, then dissolves.
  • Menu bar plate — a colored mini-nameplate (plus the name) in the menu bar. Its menu doubles as a glanceable dashboard: uptime, IP address (click to copy), CPU load, RAM, and free disk, plus layer toggles.
  • Attention alerts — a bundled CLI lets agents and scripts summon a topmost message card with pulsating screen borders when they need the human (e.g. right before a 1Password auth prompt).

Your wallpaper stays untouched — everything is a transparent overlay, so you can keep any background you like.

Each Mac gets a stable default color derived from its hostname, so even an unconfigured fleet is instantly tellable-apart.

Install

macOS — download the DMG (drag to install), or:

brew install --cask steipete/tap/nameplate

Windows — grab Nameplate-Windows-x64.zip (or arm64) from the latest release: a single self-contained nameplate.exe (tray app + CLI in one binary). Source lives in windows/.

Linux — install with Homebrew:

brew install steipete/tap/nameplate

Or grab Nameplate-Linux-x86_64.tar.gz (or arm64) from the latest release; the tarball requires the system GTK4 runtime. B

Description

Brand every Mac in your fleet — colored frame, name tag, watermark, and connect splash as click-through overlays. Never wonder which Mac you remoted into again.

Related repositories

Similar projects matched by category, topics, and programming language.

Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985
uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941
simonw
Featured
simonw GitHub avatar

speech-analyzer-cli

A macOS command-line tool that uses Apple's on-device speech APIs to transcribe prerecorded audio into plain text, JSON, JSONL, SRT, or WebVTT.

Developer ToolsCLI & Terminal
20