TimeScribe

🚀 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

• 🇸🇦 Arabic (العربية)
• 🇩🇰 Danish
• 🇬🇧 English (UK/US)
• 🇫🇷 French (FR/CA)
• 🇩🇪 German
• 🇮🇱 Hebrew (עברית)
• 🇮🇹 Italian
• 🇵🇱 Polish
• 🇧🇷 Portuguese (BR)
• 🇨🇳 Chinese (中文)

Arabic and Hebrew support right-to-left application layouts. PDF exports still use Dompdf, whose complex text layout support is incomplete; RTL text in PDFs requires a separate rendering solution.

📦 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

🧭 Time Tracking

🧠 App Activity

📋 Project Tracking

🗓️ Absence Planning

⚙️ 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.

• 👉 GitHub Discussions
• 🐞 GitHub Issues
• 🛠️ Contributing Guide
• ⛳️ TimeScribe Feature-Roadmap

💖 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.