Repolode
Submit
WINBIGFOX

WINBIGFOX/TimeScribe

Offline time tracker for macOS and Windows that logs work hours, projects, and billing without cloud accounts or registration.

Open-source alternative to:Toggl TrackClockify

View on GitHubWebsite
Stars
933
Forks
92
Open issues
25
Last commit
4 days ago

What is it?

TimeScribe is a desktop time tracker for macOS and Windows. You start, pause, and stop a timer for work or breaks, and the app stores everything in a local SQLite database on your device. There is no account, no sign-up, and no cloud sync.

Beyond basic timing, it shows daily and weekly work patterns, breaks down app usage into work and distraction categories, and can start or pause the timer automatically based on screen time and idle status. Projects can carry descriptions and hourly rates, and billing amounts are calculated from them. Absences such as vacation, sick leave, and holidays can be planned alongside work hours.

Data can be exported as PDF, Excel, or CSV. The app supports a deep-link API (timescribe://start/work, timescribe://start/break, timescribe://stop) so tools like Shortcuts, Alfred, Raycast, or AutoHotkey can control the timer. It is built with Laravel and NativePHP on Electron, with Vue.js and Tailwind CSS for the interface.

Key features

  • 01One-click start, pause, and stop for work and break timers
  • 02Daily and weekly work pattern visualizations
  • 03App usage tracking with work vs distraction categories
  • 04Automatic start and pause based on screen time and idle status
  • 05Project tracking with hourly rates and billing calculations
  • 06Absence planning for vacation, sick leave, and holidays
  • 07Export to PDF, Excel, and CSV

Use cases

  • Freelancers who need to track hours per client and calculate invoices
  • Remote workers who want a private log of their working hours
  • Individuals who want to review how their time is spent across apps
  • Users who want to control a timer from Raycast, Alfred, or scripts

Quick start

  1. 1

    Install via Homebrew (macOS)

    brew install timescribe
  2. 2

    Install via WinGet (Windows)

    winget install WINBIGFOX.TimeScribe
  3. 3

    Or download the app installer from the latest release page

Things to know

  • Only available for macOS and Windows.
  • Distributed under GPL-3.0, a copyleft license.
  • Building from source requires PHP, Composer and Node.js setup.

In collections

Windows apps and utilitiesOpen-source Mac appsPrivacy & local-first toolsDesktop GUI apps & toolkits

Topics

#time-tracking#timesheet#offline-first#privacy-focused#desktop-app#macos#windows#freelancer-tools#billing#electron

FAQ

What is TimeScribe?
Offline time tracker for macOS and Windows that logs work hours, projects, and billing without cloud accounts or registration. TimeScribe is a desktop time tracker for macOS and Windows. You start, pause, and stop a timer for work or breaks, and the app stores everything in a local SQLite database on your device. There is no account, no sign-up, and no cloud sync.
Is TimeScribe free to use? What license does it have?
TimeScribe is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is TimeScribe still maintained?
Actively maintained. The last commit to TimeScribe was on Nov 3, 2026.
What can I use TimeScribe for?
Freelancers who need to track hours per client and calculate invoices Remote workers who want a private log of their working hours Individuals who want to review how their time is spent across apps Users who want to control a timer from Raycast, Alfred, or scripts
How do I install TimeScribe?
Install via Homebrew (macOS): brew install timescribe Install via WinGet (Windows): winget install WINBIGFOX.TimeScribe Or download the app installer from the latest release page
Where can I get TimeScribe?
The source code and installation instructions are on GitHub: https://github.com/WINBIGFOX/TimeScribe

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects