Clockspan

Clockspan is a self-hosted, single-day focus sheet for getting through a workday with ADHD.

  • Productivity
  • Tools & Utilities
Clockspan is a self-hosted, single-day focus sheet for getting through a workday with ADHD. One page: a punch-style timeclock that works out when lunch is due and when the day ends, the few things that would make today a win, a focus timer that logs what you did, and a retrospective that puts the plan next to what happened. Every day is saved, and alarms fire as deadlines approach. It works on phones and installs to the Home Screen.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

49/100 Fair

Maintained
81last commit 40 days ago
Popular
102 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 23 days ago

GitHub stars
2
Open issues
5
Last commit
2026-10-12
Latest release
v2.16.0
License
MIT
Activity
stale

Checked 7 days ago - source: GitHub (geransmith/clockspan)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Sign-in and public exposure The default sign-in mode is none, so keep Clockspan on a trusted LAN or behind your reverse proxy's authentication, and choose local or OpenID Connect (OIDC) sign-in before exposing it to the internet. source
  • Runtime Clockspan runs as one Docker container with a SQLite file, and works on phones or Home Screen installs. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How should I secure Clockspan if it is reachable from the internet?

The default sign-in mode is none, so keep it on a trusted LAN or behind your reverse proxy's authentication. Choose local or OpenID Connect (OIDC) sign-in before exposing it publicly.

Where is Clockspan data stored?

It runs as one Docker container with a SQLite file. Every day is saved in that deployment.

Does the focus timer survive a page reload or a sleeping phone?

Yes, the timer's start time lives on the server. Breaks also live on the server and survive reloads.

Can I manually enter a time if I forget to punch?

Yes, if you forgot to punch you can type the time. Extra out/in pairs can also cover appointments before or after lunch.

How does Clockspan plan lunch and the end of the day?

By default lunch is due within 5 hours and the day ends after 8 hours worked plus a 30-minute lunch. It re-plans if lunch runs long, and a day shorter than the lunch window needs no lunch.

Answers sourced from github.com

Community

Collected 43 days ago - public community threads