Documentation

Per-source integration guides

For setting up a specific source — Home Assistant, Kopia, Uptime Kuma, UniFi (Network and Protect), GitHub Actions, Synology, Pi-hole, Proxmox, Hazel, Jellyfin, Vaultwarden, and more — open the score's catalogue page. Each one documents the source-side configuration, the payload contract Tempo expects, and what the bundled severity rules and actions look for.

• Browse the scores catalogue →

  Bundled and community scores. Double-click a .tempo-score to install, or read the page for the integration walkthrough.

Reference

• Troubleshooting networking

  When the score is installed and the source is configured, but events never reach Tempo. Five patterns that cover almost every reported case: firewall, Little Snitch, VLAN isolation, hostname resolution, port collision.

Tips

• Tips & tricks →

  Short, practical things you can do with Tempo, beyond the reference. The user guide tells you how a feature works; the tips tell you how to use it well: clever uses, small habits, and the gotchas worth knowing.

Tempo user guide

The full guide covers Tempo end-to-end — what it is, how to set it up, every panel and setting, the Score Editor, troubleshooting, and a glossary. Start with chapter 1 if you're new, or jump straight to the chapter you need.

1. 01 Introduction Tempo is a native macOS event hub for homelab operators, sysadmins, and Mac power users. What Tempo is, who it's for, what isn't in scope, and where to start reading.
2. 02 Concepts The vocabulary Tempo uses — events, sources, providers, scores, severity, acknowledgment, dismissal — what each one means and how they relate.
3. 03 Getting started This chapter takes you from a downloaded DMG to a Mac with Tempo running, ingestion ready to receive events, and a clear picture of what the three panels do.
4. 04 Source panel The source panel — the leftmost column in the Tempo window — lists every source Tempo knows about and gives you the controls for showing, hiding, filtering, and re-colouring each one.
5. 05 Event panel The event panel — the centre column — is where the timeline lives.
6. 06 Action panel The action panel — the rightmost column — is where you do something about what you see in the feed.
7. 07 Score Editor The Score Editor is where you teach Tempo about a source.
8. 08 Settings reference Reference for every option in Tempo's Settings window across the five tabs: Interface, Agenda, Ingestion, Maintenance, and Help.
9. 09 Backup and restore This chapter covers what's worth backing up, how Tempo's built-in backup tools work, what they include and exclude, and how to move your Tempo state to a new Mac.
10. 10 Sources reference This chapter is the per-source manual: every bundled source gets its own section covering setup, what payload fields the bundled score expects, and what to expect in the timeline.
11. 11 Score authoring This chapter is the developer reference for writing Tempo scores from scratch.
12. 12 Troubleshooting Tempo has only a few moving parts: the macOS app, the SQLite database, the HTTP ingestion server, EventKit for calendars, score JSON files.
13. 13 FAQ Answers to the questions that come up most often about Tempo: pricing, privacy, sandboxing, integrations, V2 plans, and the difference between bundled and community scores.
14. 14 Glossary Definitions for every Tempo-specific term: event, source, provider, score, severity, ack, dismiss, ingestion, heatmap, and more. Cross-linked to the chapters that introduce each one.
15. 15 Appendix Reference material that didn't fit cleanly into the chapter flow but is worth having as a single page.

Got stuck?

Email [email protected]. A community Discord and a public issue tracker open with the v1 release; both will be linked here and on the homepage when they go live.