Sign inDemoInstall


Package Overview
File Explorer

Install Socket

Detect and block malicious and high-risk dependencies



A hackable GUI time tracker designed to be easily modified for user-centric automation.





This is a small python utility app that is being designed for time-tracking. As the name suggests, this is trying to replace for tracking my own work.

The end-goal is a local, open-source timer that is hackable and can automate specific tasks like uploading/submitting billable hours.


'Production' GUI for usage

Productions View

Development GUI with logger and debugger windows

Development View


The best way is to use pipx and run pipx install clockpuncher or pipx run clockpuncher.

On install a folder will be created in ~/.local/Clockpuncher to contain local data storage. It should contain a sqlite db called timer.db and possibly wal files. It's literally just a sqlite database, you can access, query, and adjust as you would with any other database. This might be slightly different depending on your OS.

You can delete this folder without issue, but you will lose all your stored data.

Current Next Steps:

  • Integrate sqlite DB of timer sessions
  • Add inputs for specific task descriptions (text box)
  • Add on-the-fly graph representations
    • Task Breakdown
    • Total Hours (per task and total)
    • Total Billed (per task and total)
  • Add report CSV output
  • Add tests for + gui module
  • Put on PyPI
  • Setup with pipx for app deployment
  • Add user settings with persistent storage
  • Add database back-up/cold-storage option

Repo Structure

This repo follows a pretty standard layout with being the GUI front-end + database composed together to make the stopwatch app itself.


  • clockpuncher/ - contains all code required to run Clock Puncher
    • - The main file that combines GUI, database, and application logic to make the above images
    • - Contains the Database class that does CRUD operations for
    • - Dataclasses that represent rows in the Entries and Projects table
    • - Local storage location constants for
    • data/ - Contains local data storage. In production it stores data in data/timer.db
    • gui/ - All reusable GUI components
      • - Base GUI class with loggers and basic development/production switchers.
      • - This holds quick GUI screens tossed together for development.
      • - Contains task_chart and entry_table components and their class definitions
      • - Contains Timer and Number GUI components that make up the clock display
    • tests - Test suite using Pytest + Hypothesis


Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.


Related posts

SocketSocket SOC 2 Logo


  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc