A simple, minimalistic desktop application to track working hours. The application appears as a small window in the bottom right corner of the screen and allows you to track your working time with start/stop functionality.
- 🎯 Minimalistic, always-on-top interface
▶️ Start/Stop time tracking- ⌚ Live display of elapsed time
- 💾 CSV storage of time records
- 🔽 Minimizable to taskbar
- 🖱️ Draggable window
- 🎨 Custom rounded buttons
- 🪟 Borderless window design
- Clone the repository:
git clone https://github.com/LennardGeissler/TimeTracker.git
cd time-tracker- Install dependencies:
pip install -r requirements.txtYou can run the application / the script directly via the command line:
python src/main.pyThe project includes a build script that uses PyInstaller to create a standalone executable:
python build.pyYou can find the executable in the dist/ folder in your root directory.
▶️ Click "Start" to begin tracking time- ⏹️ Click "Stop" to end the current session
- 🔽 Use the minimize button (-) to minimize to taskbar
- ❌ Use the close button (×) to exit the application
- 🖱️ Click and drag anywhere on the window to move it
Time records are stored in a CSV file with the following format:
- 📅 Date
- 🕐 Start Time
- 🕒 End Time
- ⏱️ Duration (hours)
- 🐍 Python 3.6+
- 🪟 tkinter (usually comes with Python)
- 🖼️ pillow (for icon creation)
- 📦 pyinstaller (for building executable)
I welcome contributions to the TimeTracker project. If you would like to contribute, please follow these steps:
- Fork the repository.
- Clone your fork to your local machine.
- Create a new branch:
git checkout -b feature/my-new-feature. - Make your changes and commit them:
git commit -am 'Add new feature'. - Push your branch to your fork:
git push origin feature/my-new-feature. - Open a pull request to merge your changes into the main repository.
This project is licensed under the MIT License - see the LICENSE file for details.
- Lennard Geißler (@LennardGeissler)