User Guide

Klaude Buddy

A small desk display for weather, your Claude usage, custom API dashboards, and one-tap shortcuts — set up in a few minutes, no app store required.

Wi-Fi setup screen
📷 Add screenshot
assets/screens/mainpicture.jpg



🛒 Buy it here!
Getting Started

Setting up Wi-Fi

The very first time you power it on — or any time after a factory reset — the device creates its own Wi-Fi network so you can connect it to your home network.

📶 First boot / setup mode

  1. Power on the device. It shows a screen with a network name and an IP address.
  2. On your phone or computer, connect to the Wi-Fi network named Klaude-Buddy-Setup.
  3. Open a browser and go to 192.168.4.1.
  4. Enter your home Wi-Fi name and password, then save.
  5. The device restarts and joins your network automatically.
Wi-Fi setup screen
📷 Add screenshot
assets/screens/wifi-setup.png
The Control Panel

The Dashboard

Once connected to your Wi-Fi, everything is configured from a web dashboard — no app to install. Open it from any browser on the same network.

🌐 Reaching the dashboard

Visit http://klaude-buddy.local, or the device's IP address shown on its Info screen. The dashboard has tabs across the top: Status, Wi-Fi, Channels, APIs, Shortcuts, Pet, You, and Device.

The Channels tab is where you turn each screen below on or off, and choose how long the display lingers on each one before rotating to the next.

Dashboard status tab
📷 Add screenshot
assets/screens/dashboard-status.png
Screen by Screen

What each screen shows

The device rotates automatically through whichever of these you've enabled. Tap the screen at any time to pause the rotation, or to jump forward.

🕐 Clock Always on

Large time display with the date, a day-progress dot strip, the current week number, and a friendly greeting that changes through the day. If you've searched for a city under Weather, its name appears here too.

Clock screen
📷 Add screenshot
assets/screens/clock.png
Clock screen
📷 Add screenshot
assets/screens/clock.png

🌤 Weather Channels tab

Search for any city in the world (powered by Open-Meteo — no account or API key needed) and pick it from the results. Shows current temperature, "feels like," humidity, wind, and conditions, in °C or °F.

Weather screen
📷 Add screenshot
assets/screens/weather.png
Weather screen
📷 Add screenshot
assets/screens/weather.png

📅 3-Day Forecast

Today plus the next two days, for the same city as the Weather screen. Each day shows a low-to-high range bar (colder on one end, warmer on the other) so you can see at a glance which of the three days is relatively hot or cold.

Forecast screen
📷 Add screenshot
assets/screens/forecast.png

ℹ️ Device Info

Diagnostics at a glance: IP address, Wi-Fi network and signal strength, uptime, free memory, CPU speed, firmware version, how many screens are active, and when data was last refreshed.

Device info screen
📷 Add screenshot
assets/screens/info.png

🔌 Custom APIs APIs tab

Connect up to 8 of your own APIs — anything that returns JSON. For each one you set a title, the endpoint URL, an optional auth header, and how often it refreshes (from every 5 minutes up to once a day). Then pick which values to show by pointing at a field inside the response, e.g. data.visits.daily.

Each API supports up to 24 fields, shown 4 per page (so up to 6 pages), automatically paging through with its own turn on screen — no scrolling or tapping needed.

Custom APIs screen
📷 Add screenshot
assets/screens/custom-apis.png
Custom APIs screen
📷 Add screenshot
assets/screens/custom-apis.png
Custom APIs screen
📷 Add screenshot
assets/screens/custom-apis.png

🔗 Shortcuts Needs companion app

Up to 45 one-tap shortcuts to your favorite links, shown 15 per page (so up to 3 pages) — swipe to move between pages. This needs a small companion app running on a computer connected to the device by USB — tapping a shortcut tells that computer to open the link in its browser.

A brand-new device comes with one shortcut already loaded — the >_< icon, which opens the device's own dashboard in your browser. Edit or delete it like any other shortcut; it's just a convenient default, not something special.

Shortcuts screen
📷 Add screenshot
assets/screens/shortcuts.png
Shortcuts screen
📷 Add screenshot
assets/screens/shortcuts.png

📋 Clipboard Needs companion app

Four buttons — Select All, Cut, Copy, Paste — that simulate the matching keyboard shortcut on the connected computer. Same companion app as Shortcuts.

Clipboard screen
📷 Add screenshot
assets/screens/clipboard.png

💻 The companion app For Shortcuts & Clipboard

A small desktop app that sits in the background on a computer connected to the device by USB. It listens for taps on the Shortcuts and Clipboard screens and acts on them — opening a link in your browser, or simulating a keyboard shortcut. It never runs arbitrary commands, only those two specific, safe actions.

The device needs to stay physically plugged into that computer by USB the whole time — Shortcuts and Clipboard talk to the app over that same USB cable, not over Wi-Fi or the network. If you unplug it, or plug it into a different computer, only that connected computer's companion app (if running) will respond to taps.

⬇️ Download for Windows  ·  🍎 Download for Mac

Windows setup:

  1. Run KlaudeShortcutsSetup.exe and follow the installer (Next → Install → Finish).
  2. It starts automatically once installed, and sets itself to launch every time you log in — no need to open anything by hand afterward.
  3. Already have an older version installed? Just run the new installer over it — it upgrades in place, no need to uninstall first.
  4. To remove it later: Settings → Apps (or Control Panel → Programs), find Klaude Shortcuts, and uninstall — it's a proper entry, not just a loose file.

Mac setup: unzip the download first — you'll get KlaudeShortcutsInstaller.pkg and a separate uninstaller. The .pkg isn't signed by a registered Apple developer yet, so macOS blocks it the first time; this is a one-time step.

  1. Double-click KlaudeShortcutsInstaller.pkg.
  2. If you see "cannot be opened because it is from an unidentified developer": open System Settings → Privacy & Security, scroll down, and click Open Anyway next to the message about the blocked installer (confirm with your password or Touch ID). Then double-click the .pkg again.
  3. If instead it says the installer "is damaged and can't be opened", that's Gatekeeper reacting to the browser's download quarantine flag, not an actual broken file — open Terminal and run xattr -cr ~/Downloads/KlaudeShortcutsInstaller.pkg (adjust the path if you saved it elsewhere), then open it normally.
  4. Follow the installer (it'll ask for your Mac password since it installs into Applications). It installs the app, sets it to launch on login, and opens it once automatically.
  5. Separately from the step above, it needs one more permission for Copy/Paste to work: go to System Settings → Privacy & Security → Accessibility (a different tab from the one used to unblock the installer) and enable the checkbox next to KlaudeShortcuts. Shortcuts — opening links — works without this; only Clipboard needs it.
  6. To remove it later, double-click "Uninstall KlaudeShortcuts.command" (included in the same zip) — no Terminal commands needed.

Either platform, once installed: plug the device in by USB-C, open the Shortcuts screen on it, and tap one — a browser tab should open with that link, coming to the front even if you were doing something else on the computer.

📊 Claude Usage Channels tab

Paste your claude.ai session key once, and the device fetches your usage directly over Wi-Fi — no computer needs to stay on. Shows your current 5-hour window and weekly usage side by side, each with a countdown to when it resets.

Claude usage screen
📷 Add screenshot
assets/screens/claude-usage.png
Claude usage screen
📷 Add screenshot
assets/screens/claude-usage.png

🔥 Max Tracker Channels tab

A GitHub-style heatmap of your daily Claude usage peaks over the last 8 weeks, plus your current streak. Rides the same session key as Claude Usage above — if that's already set up, there's nothing else to configure.

Max Tracker screen
📷 Add screenshot
assets/screens/max-tracker.png

🙋 Needs You Channels tab · Needs companion app once

Answer a blocked Claude Code permission prompt with a tap on the device — over Wi-Fi, no USB cable needed at the moment it happens. When a PreToolUse hook fires, the display interrupts whatever screen was showing with the tool name and a short summary, plus a quick brightness flash so it's hard to miss.

Tap Approve or Deny to answer directly. The in the corner dismisses the popup without deciding — the device goes back to normal, and Claude Code falls back to asking you in the terminal as usual.

Setup is one-time and mostly automatic: if you already have Claude Code configured on the same computer running the companion app (see Shortcuts below), the app registers the hook by itself the first time it opens — no separate script to run. Then just turn on Needs You in the dashboard's Channels tab.

Needs You screen
📷 Add screenshot
assets/screens/needs-you.png

☀️ Brightness Channels tab

A grid of buttons to change the screen's brightness by tapping the device directly, without opening the dashboard — same options as the brightness dropdown in Device settings.

Brightness screen
📷 Add screenshot
assets/screens/brightness.png

🦞 Pet Channels tab

Your device's own mascot. In Automatic mode it reacts to how fast you're using up your Claude quota; in Manual mode you pick a fixed expression yourself.

Pet Manual Mode
📷 Add screenshot
assets/screens/pet-manual.png
Pet screen
📷 Add screenshot
assets/screens/pet.png
Pet Automatic Mode
📷 Add screenshot
assets/screens/pet-automatic.png
Pet Manual Mode
📷 Add screenshot
assets/screens/pet-manual.png
Pet Manual Mode
📷 Add screenshot
assets/screens/pet-manual.png
Pet Manual Mode
📷 Add screenshot
assets/screens/pet-manual.png
Pet Manual Mode
📷 Add screenshot
assets/screens/pet-manual.png
Pet Manual Mode
📷 Add screenshot
assets/screens/pet-manual.png
Pet Manual Mode
📷 Add screenshot
assets/screens/pet-manual.png
Dashboard Tabs

Personalizing your device

A couple of dashboard tabs shape the whole device rather than a single screen.

🙋 You

Your name and birthday (used in on-screen greetings), display brightness, and your timezone — picked from a list of world cities, with automatic Daylight Saving handling where it applies.

Personalization tab
📷 Add screenshot
assets/screens/personalization.png

⚙️ Device

Check for and install software updates, restart the device, or use Factory Reset to erase Wi-Fi and all saved settings — handy if you're passing the device on to someone else.

Device tab
📷 Add screenshot
assets/screens/device-tab.png