Pytimer

Lightweight Python-based timer overlay packaged as a standalone executable.

Requirements

• Python 3.9+
• pip
• Git
• pyinstaller 6.18.0
• PySide6 6.10.2

Installation

Clone the repository and install dependencies:

git clone https://github.com/JassonCordones/pytimer
cd pytimer
pip install -r requirements.txt

Usage (Development)

Run directly with Python:

python timer_overlay.py

Build (Standalone Executable)

Uses PyInstaller to produce a single-file binary without a console window.

pyinstaller --onefile --noconsole --add-data "timer.ico;." --add-data "logo.png;." --icon=timer.ico timer_overlay.py

Output

The compiled executable is generated in:

dist/

Notes

• The --noconsole flag is intended for GUI/overlay applications.
• For reproducible builds, consider pinning Python and PyInstaller versions (e.g., via pyenv + pip-tools).

License

MIT