TimeScribe

About TimeScribe

<a href="https://timescribe.app?utm_source=github&utm_medium=banner" target="_blank"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/WINBIGFOX/TimeScribe/blob/main/.github/images/banner_dark.png?raw=true"> <img alt="Banner TimeScribe" src="https://github.com/WINBIGFOX/TimeScribe/blob/main/.github/images/banner_light.png?raw=true"> </picture> </a> Smart & Private Time Tracking for macOS & Windows Track, analyze, and own your work hours No cloud. No registration. No paywall. Just productivity. <a href="https://github.com/WINBIGFOX/timescribe/releases/latest"> <img src="https://img.shields.io/github/v/release/WINBIGFOX/timescribe?label=Download&logo=github" /> </a> <a href="https://formulae.brew.sh/cask/timescribe"> <img src="https://img.shields.io/homebrew/cask/v/timescribe?logo=homebrew&logoColor=white&label=Homebrew" /> </a> <a href="https://winstall.ap ...

w

Published by

winbigfox

Visit View Profile

README.md

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
🇵🇱 Polish
🇧🇷 Portuguese (BR)
🇨🇳 Chinese (中文)

📦 Download & Installation

Option 1: Download the App

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

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.

💖 Sponsor & License

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.