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

https://github.com/MayGo/tockler

An application that tracks your time by monitoring your active window title and idle time.
https://github.com/MayGo/tockler

electron electron-app osx productivity timeline timetracker windows

Last synced: 10 days ago
JSON representation

An application that tracks your time by monitoring your active window title and idle time.

Awesome Lists containing this project

README

        



Tockler logo


Tockler logo



Release


Total downloads


Latest downloads

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



Sponsor on GitHub


Support on Open Collective


Support on Patreon


Support on Ko-fi


Donate via PayPal

## Download



View all releases

### Windows



Download Windows Universal Setup


Download Windows x64 Setup


Download Windows ARM64 Setup


Download Windows 32-bit Setup




Download Windows Universal Portable


Download Windows x64 Portable


Download Windows ARM64 Portable


Download Windows 32-bit Portable

### macOS



Download macOS Universal DMG


Download macOS Apple Silicon DMG

### Linux



Download Linux AppImage

## 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 @ trimatech.dev