# tockler

**Repository Path**: mirrors/tockler

## Basic Information

- **Project Name**: tockler
- **Description**: An application that tracks your time by monitoring your active window title and idle time.
- **Primary Language**: TypeScript
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/tockler
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-08-12
- **Last Updated**: 2026-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <a href="https://tockler.io/#gh-light-mode-only">
    <img src="https://github.com/MayGo/tockler/raw/master/screenshots/tockler-logo-light.svg" width="318px" alt="Tockler logo" />
  </a>
  <a href="https://tockler.io/#gh-dark-mode-only">
    <img src="https://github.com/MayGo/tockler/raw/master/screenshots/tockler-logo-dark.svg" width="318px" alt="Tockler logo" />
  </a>
</p>

<p align="center">
  <a href="https://github.com/MayGo/tockler/releases/latest">
    <img src="https://img.shields.io/github/v/release/MayGo/tockler" alt="Release" />
  </a>
  <a href="https://github.com/MayGo/tockler/releases">
    <img src="https://img.shields.io/github/downloads/maygo/tockler/total" alt="Total downloads" />
  </a>
  <a href="https://github.com/MayGo/tockler/releases/latest">
    <img src="https://img.shields.io/github/downloads/maygo/tockler/latest/total" alt="Latest downloads" />
  </a>
</p>

## Overview

Tockler is a free application that automatically tracks your computer usage and working time. It provides detailed insights into:

-   Application usage and window titles
-   Computer state (idle, offline, online)
-   Interactive timeline visualization
-   Daily, weekly, and monthly usage statistics
-   Calendar views and charts

## Features

-   **Time Tracking**: Go back in time and see what you were working on
-   **Application Monitoring**: Track which apps were used and their window titles
-   **Usage Analytics**: View total online time, application usage patterns, and trends
-   **Interactive Timeline**: Visualize your computer usage with an interactive chart
-   **Cross-Platform**: Available for Windows, macOS, and Linux

## Support Tockler

Tockler is free and open-source software. If you find it useful, please consider supporting its development:

<p align="center">
  <a href="https://github.com/sponsors/maygo/">
    <img src="https://img.shields.io/github/sponsors/maygo?style=for-the-badge&logo=github&logoColor=white&color=ea4aaa" alt="Sponsor on GitHub" />
  </a>
  <a href="https://opencollective.com/tockler">
    <img src="https://img.shields.io/badge/Open%20Collective-Support-7FADF2?style=for-the-badge&logo=opencollective&logoColor=white" alt="Support on Open Collective" />
  </a>
  <a href="https://www.patreon.com/Tockler">
    <img src="https://img.shields.io/badge/Patreon-Support-F96854?style=for-the-badge&logo=patreon&logoColor=white" alt="Support on Patreon" />
  </a>
  <a href="https://ko-fi.com/maigoerit">
    <img src="https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white" alt="Support on Ko-fi" />
  </a>
  <a href="https://paypal.me/maigoerit">
    <img src="https://img.shields.io/badge/PayPal-Donate-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="Donate via PayPal" />
  </a>
</p>

## Download

<p align="center">
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/All%20Versions-Release%20History-2ea44f?style=for-the-badge&logo=github&logoColor=white" alt="View all releases" />
  </a>
</p>

### Windows

<p align="center">
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/Windows%20Universal%20Setup-Download-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows Universal Setup" />
  </a>
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/Windows%20x64%20Setup-Download-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows x64 Setup" />
  </a>
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/Windows%20ARM64%20Setup-Download-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows ARM64 Setup" />
  </a>
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/Windows%2032--bit%20Setup-Download-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows 32-bit Setup" />
  </a>
</p>
<p align="center">
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/Windows%20Universal%20Portable-Download-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows Universal Portable" />
  </a>
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/Windows%20x64%20Portable-Download-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows x64 Portable" />
  </a>
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/Windows%20ARM64%20Portable-Download-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows ARM64 Portable" />
  </a>
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/Windows%2032--bit%20Portable-Download-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows 32-bit Portable" />
  </a>
</p>

### macOS

<p align="center">
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/macOS%20Universal%20(DMG)-Download-999999?style=for-the-badge&logo=apple&logoColor=white" alt="Download macOS Universal DMG" />
  </a>
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/macOS%20Apple%20Silicon%20(DMG)-Download-999999?style=for-the-badge&logo=apple&logoColor=white" alt="Download macOS Apple Silicon DMG" />
  </a>
</p>

### Linux

<p align="center">
  <a href='https://github.com/MayGo/tockler/releases/latest'>
    <img src="https://img.shields.io/badge/Linux%20AppImage-Download-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Download Linux AppImage" />
  </a>
</p>

## Screenshots

### Light Theme

![Timeline](https://github.com/MayGo/tockler/raw/master/screenshots/light/tockler-timeline.png 'Timeline')
![Settings](https://github.com/MayGo/tockler/raw/master/screenshots/light/tockler-settings.png 'Settings')
![Summary](https://github.com/MayGo/tockler/raw/master/screenshots/light/tockler-summary-calendar.png 'Summary')
![Summary](https://github.com/MayGo/tockler/raw/master/screenshots/light/tockler-summary-chart.png 'Summary')
![Search](https://github.com/MayGo/tockler/raw/master/screenshots/light/tockler-search.png 'Search')
![Tray window](https://github.com/MayGo/tockler/raw/master/screenshots/light/tockler-tray.png 'Tray window')

### Dark Theme

![Timeline](https://github.com/MayGo/tockler/raw/master/screenshots/dark/tockler-timeline.png 'Timeline')
![Settings](https://github.com/MayGo/tockler/raw/master/screenshots/dark/tockler-settings.png 'Settings')
![Summary](https://github.com/MayGo/tockler/raw/master/screenshots/dark/tockler-summary-calendar.png 'Summary')
![Summary](https://github.com/MayGo/tockler/raw/master/screenshots/dark/tockler-summary-chart.png 'Summary')
![Search](https://github.com/MayGo/tockler/raw/master/screenshots/dark/tockler-search.png 'Search')
![Tray window](https://github.com/MayGo/tockler/raw/master/screenshots/dark/tockler-tray.png 'Tray window')

## Technologies

Tockler is built with modern web technologies:

-   **Framework**: [Electron](https://electron.atom.io/) with [Webpack](https://webpack.github.io/) and [TypeScript](https://www.typescriptlang.org/)
-   **Frontend**: [React](https://reactjs.org/) with [Chakra UI](https://chakra-ui.com/)
-   **Data Visualization**: [D3.js](https://d3js.org/) and [Victory Chart](http://formidable.com/open-source/victory/docs/victory-chart/)
-   **Package Manager**: [pnpm](https://pnpm.io/)

## Development

### Prerequisites

-   Node.js
-   Git
-   pnpm

### Quick Start

1. Clone the repository:

```bash
git clone https://github.com/Maygo/tockler.git
cd tockler
```

2. Enable pnpm:

```bash
corepack enable pnpm
```

3. Install dependencies and start the application:

For the React client (renderer):

```bash
cd client/
pnpm install
pnpm start
```

For the Electron main process:

```bash
cd electron/
pnpm install
pnpm start
```

### Logs

Logs are stored in the following locations:

-   Linux: `~/.config/tockler/logs/main.log`
-   macOS: `~/Library/Logs/tockler/main.log`
-   Windows: `%USERPROFILE%\AppData\Roaming\tockler\logs\main.log`

## Feedback

Feel free to:

-   Create issues for feature requests
-   Star this project
-   Share your feedback

## License

Tockler is licensed under the GNU General Public License v2.0. See the [LICENSE](LICENSE) file for details.

MayGo (https://github.com/MayGo)

Created by Maigo Erit @ <a href="https://trimatech.dev" target="_blank">trimatech.dev</a>