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](#-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](https://github.com/WINBIGFOX/timescribe/releases/latest) and download:
- 🖥 **Windows**:
`TimeScribe-setup.exe` [👉🏻 Direct download link Windows](https://timescribe.app/download/windows)
- 🍏 **macOS**:
`TimeScribe.dmg` [👉🏻 Direct download link macOS (Apple Silicon)](https://timescribe.app/download/macos/arm64) | [(Intel)](https://timescribe.app/download/macos/x64)
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](https://brew.sh/) installed, you can install TimeScribe with:
```bash
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](https://learn.microsoft.com/windows/package-manager/winget/) available, you can install TimeScribe with:
```powershell
winget install WINBIGFOX.TimeScribe
```
---
### Option 4: Build from Source (Developers)
```bash
# 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](https://laravel.com/) (PHP)
- Desktop Runtime: [NativePHP](https://nativephp.com/) (Electron)
- Frontend: [Vue.js](https://vuejs.org/) + [Tailwind CSS](https://tailwindcss.com/)
- 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](https://github.com/WINBIGFOX/TimeScribe/discussions)
- 🐞 [GitHub Issues](https://github.com/WINBIGFOX/TimeScribe/issues)
- 🛠️ [Contributing Guide](CONTRIBUTING.md)
- ⛳️ [TimeScribe Feature-Roadmap](https://github.com/users/WINBIGFOX/projects/5)
---
## 💖 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](LICENSE) for more information.
## 📄 License
Distributed under the GPL-3.0 License. See [LICENSE](LICENSE) for more information.