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, 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 it is, who it's for, and where to start reading.
2. 02 Concepts The vocabulary Tempo uses (events, sources, providers, scores, severity, acknowledgment, dismissal) and 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 Tempo, lists every source and gives you the controls to show, hide, filter, and recolor each one.
5. 05 Event panel The event panel, the center 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 seven tabs: Interface, Agenda, Ingestion, Security, Notifications, Maintenance, and Help.
9. 09 Backup and restore 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 The per-source manual: a curated subset of the bundled sources, each with setup, the payload fields its 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 most common questions about Tempo: pricing, privacy, sandboxing, integrations, V2 plans, and bundled versus 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 each chapter.
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 hello@tempoapp.app. 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.