Skip to content

WINBIGFOX/TimeScribe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

367 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Banner TimeScribe

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

Option 1: Download the App

Head to the latest release and download:

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 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:


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

Sponsor this project

  •  

Contributors