README.md

April 19, 2026 · View on GitHub

Smart & Private Time Tracking for macOS & Windows

Track, analyze, and own your work hours
No cloud. No registration. No paywall. Just productivity.

Download Now

🚀 About

TimeScribe is the easiest way to track your work hours — without the hassle.

It is designed for everyone who needs to keep track of their time but doesn't want to pay for a subscription, create an account, or upload their private data to the cloud. Whether you are a freelancer billing clients, a remote worker logging hours, or just want to improve your personal productivity, TimeScribe gives you full control.

Why use TimeScribe?

Completely Free: No hidden costs, no premium plans, no paywalls.
No Registration: No email required. Just download, open, and start tracking.
100% Offline & Private: Your data stays on your device. We don't track you.

Simply put: It's a professional time tracking tool that respects your privacy and your wallet.

✨ Key Features

✅ Start, pause, and stop tracking with one click
📊 Visualize your day and weekly work patterns
⏱ See app usage and categorize work vs distractions
🗓️ Plan absences like vacation, sick leave, and holidays
📋 Track time on projects with descriptions, hourly rates, and billing calculations
⚙️ Auto start/pause based on screen time and idle status
💾 Export as PDF, Excel, and CSV: Easily export your time tracking data for further analysis or reporting.
🪟 Supports macOS & Windows
⌨️ Custom keyboard shortcuts
🔗 Deep-Link support for macOS & Windows (see Deep-Link API)
🌐 Multi-language support
🔒 100% Local: No cloud, no registration, no paywall
🔄 Auto Updates: Always up-to-date

🌍 Supported Languages

🇩🇰 Danish
🇬🇧 English (UK/US)
🇫🇷 French (FR/CA)
🇩🇪 German
🇮🇹 Italian
🇧🇷 Portuguese (BR)
🇨🇳 Chinese (中文)

📦 Download & Installation

Head to the latest release and download:

🖥 Windows: TimeScribe-setup.exe 👉🏻 Direct download link Windows
🍏 macOS: TimeScribe.dmg 👉🏻 Direct download link macOS (Apple Silicon) | (Intel)

Then:

Windows: Run the .exe and follow the setup instructions.
macOS: Open the .dmg, then drag TimeScribe to your Applications folder.

Option 2: Install via Homebrew (macOS)

If you're on macOS and have Homebrew installed, you can install TimeScribe with:

brew install timescribe

After installation, you can launch TimeScribe via Spotlight or from your Applications folder.

Option 3: Install via WinGet (Windows)

If you're on Windows and have WinGet available, you can install TimeScribe with:

winget install WINBIGFOX.TimeScribe

Option 4: Build from Source (Developers)

# Clone the repo
git clone https://github.com/WINBIGFOX/timescribe.git
cd timescribe

# Install dependencies
composer install
npm install

# Copy the example environment file
cp .env.example .env

# Generate an application key
php artisan key:generate

# Build for macOS
npm run build
php artisan native:build mac

# Build for Windows (coming soon or adjust accordingly)
php artisan native:build win

🖼 Screenshots

Menu Bar

🧭 Time Tracking

Time Tracking

🧠 App Activity

App Activity

📋 Project Tracking

Project Tracking

🗓️ Absence Planning

Absence Planning

⚙️ Automatic Start/Pause

Automatic Start/Pause

🔗 Deep-Link API

You can control the timer from other tools (for example Shortcuts, Alfred, Raycast, AutoHotkey, or custom scripts) by opening a TimeScribe link:

timescribe://start/work → starts work tracking
timescribe://start/break → starts break tracking
timescribe://stop → stops the current timer

This works on macOS and Windows when TimeScribe is installed.

🛠️ Tech Stack

TimeScribe is built with a modern stack, leveraging the best of web and desktop technologies:

Core: Laravel (PHP)
Desktop Runtime: NativePHP (Electron)
Frontend: Vue.js + Tailwind CSS
Database: SQLite (Local)

👥 Community & Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If TimeScribe helps you save time or money, please consider supporting the development.

📄 License

Distributed under the GPL-3.0 License. See LICENSE for more information.