TermELO

TermELO is a minimal terminal-based time tracker that gamifies your coding sessions. It tracks your time across different projects and assigns you ranks based on your total hours.

Features

• Time tracking by project tags
• Gamified ranking system
• Daily goals and progress tracking
• Weekly stats and activity heatmap
• Automatic Cloud Sync to private GitHub repositories
• Import and export session history via CSV

Screenshots

Installation

Download the pre-compiled executable for your operating system from the Releases page.

Alternatively, to build from source:

1. Ensure you have Go installed.
2. Clone this repository.
3. Run go build -o termelo ./cmd/termelo

Usage

Run the executable in your terminal: ./termelo

Controls:

• s: Start or stop the timer
• i: Toggle stats view
• g: Set a daily goal
• t: Change project tag
• q / Esc: Quit

To import or export your history:

./termelo -import data.csv

./termelo -export output.csv

Cloud Sync

TermELO supports automatic, seamless cloud syncing using a private GitHub repository. This ensures your progress is safely backed up and can be shared across multiple devices.

1. Setup: When you first run TermELO and go through the onboarding wizard, you will be prompted to setup Cloud Sync.
2. GitHub PAT: You will need to provide a GitHub Personal Access Token (PAT). You can generate one in your GitHub Developer Settings. Make sure it has "repo" permissions.
3. Automatic Syncing: TermELO will automatically create a private repository named termelo-sync-data on your GitHub account.
4. How it works:
   • Every time you start the app, TermELO will instantly pull your latest data from GitHub and intelligently merge it.
   • When you press q or ctrl+c to quit the application, TermELO will gracefully pause your timer, save your session, and securely push your updated stats back to GitHub before closing!

Inspiration

This program was inspired by ESCPOINT.