Product
Introducing License Enforcement in Socket
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
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 track.toggl.com 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.
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.
This repo follows a pretty standard layout with main.py
being the GUI front-end + database composed together to make the stopwatch app itself.
clockpuncher/
- contains all code required to run Clock Puncher
main.py
- The main file that combines GUI, database, and application logic to make the above imagesdatabase.py
- Contains the Database class that does CRUD operations for main.pymodels.py
- Dataclasses that represent rows in the Entries and Projects tableplatform_local_storage.py
- Local storage location constants fordata/
- Contains local data storage. In production it stores data in data/timer.db
gui/
- All reusable GUI components
base_gui.py
- Base GUI class with loggers and basic development/production switchers.dev_gui.py
- This holds quick GUI screens tossed together for development.entry_visualization.py
- Contains task_chart and entry_table components and their class definitionstimer.py
- Contains Timer and Number GUI components that make up the clock displaytests
- Test suite using Pytest + HypothesisFAQs
A hackable GUI time tracker designed to be easily modified for user-centric automation.
We found that clockpuncher demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
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.
Product
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
Product
We're launching a new set of license analysis and compliance features for analyzing, managing, and complying with licenses across a range of supported languages and ecosystems.
Product
We're excited to introduce Socket Optimize, a powerful CLI command to secure open source dependencies with tested, optimized package overrides.