An open API service indexing awesome lists of open source software.

https://github.com/winbigfox/timescribe

Dieses Repository bietet eine moderne und flexible Stempeluhr-App zur präzisen Erfassung und Verwaltung persönlicher Arbeitszeiten. Perfekt für jeden, der seine Arbeitsstunden genau im Blick behalten möchte – ob im Homeoffice oder im Büro.
https://github.com/winbigfox/timescribe

arbeitszeit arbeitszeiterfassung automation electron free kostenlos laravel macos nativephp open-source stempelkartensystem stempeluhr timemanagement timer windows worktime zeiterfassung

Last synced: 2 months ago
JSON representation

Dieses Repository bietet eine moderne und flexible Stempeluhr-App zur präzisen Erfassung und Verwaltung persönlicher Arbeitszeiten. Perfekt für jeden, der seine Arbeitsstunden genau im Blick behalten möchte – ob im Homeoffice oder im Büro.

Awesome Lists containing this project

README

          




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](#-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](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




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:

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