/TimeScribe

This repository offers a modern, flexible time tracking app for capturing and managing personal working hours. It operates offline, requires no sign-up, and is free and open source—ideal for anyone looking to efficiently track work hours, whether at home or in the office.

Primary LanguagePHPGNU General Public License v3.0GPL-3.0

TimeScribe Logo

TimeScribe

Smart & private time tracking for macOS & Windows
Track, analyze and own your work hours—no cloud, no registration, no paywall.

Download Now


🕒 Description

TimeScribe is a modern, flexible time clock app for accurately tracking and managing working hours. Whether you're remote, hybrid, or office-based, TimeScribe helps you stay focused and organized with minimal effort.


✨ 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 CSV and Excel: Easily export your time tracking data for further analysis or reporting.
  • 🪟 Supports macOS & Windows
  • 🔒 100% Local: No cloud, no registration, no paywall
  • 🔄 Auto Updates: Always up-to-date

💬 Supported Languages

  • 🇬🇧 English (UK/US)
  • 🇫🇷 French (FR/CA)
  • 🇩🇪 German
  • 🇨🇳 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: 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


👥 Community & Contributing


💖 Sponsor & License

Love TimeScribe?

This project is licensed under the GPL-3.0 License.