https://github.com/fgatto13/pythonstopwatch
A PyQt5 stopwatch app with real-time clock, custom 7-segment-style font, and dynamic UI. Includes start/stop/reset controls, hover effects, and precise 10ms updates.
https://github.com/fgatto13/pythonstopwatch
beginner-project custom-font desktop-app gui pyqt5 python qt stopwatch time-tracking
Last synced: 3 days ago
JSON representation
A PyQt5 stopwatch app with real-time clock, custom 7-segment-style font, and dynamic UI. Includes start/stop/reset controls, hover effects, and precise 10ms updates.
- Host: GitHub
- URL: https://github.com/fgatto13/pythonstopwatch
- Owner: fgatto13
- Created: 2025-07-31T13:49:15.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-31T15:42:39.000Z (11 months ago)
- Last Synced: 2025-07-31T17:41:18.294Z (11 months ago)
- Topics: beginner-project, custom-font, desktop-app, gui, pyqt5, python, qt, stopwatch, time-tracking
- Language: Python
- Homepage:
- Size: 245 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🐍 PythonStopWatch ⏱️
## 🖼 App Preview
Here you can see what the app looks like:
And here are a couple of screenshots to show how the app behaves based on the operation performed:
This project is a stopwatch application built with **PyQt5**, combining a real-time digital clock with a start/stop/reset timer. It features a custom 7-segment-style font, dynamic styling, and a clean, interactive interface.
---
## 🚀 Features
- ✅ Stopwatch with Start / Stop / Reset functionality
- ✅ Real-time digital clock displayed at the top
- ✅ Updates every 10 milliseconds
- ✅ Custom font (`DS-DIGIT.TTF`) loaded safely with fallback
- ✅ Clean UI with bold styling and hover effects
- ✅ Custom cursor for buttons
- ✅ Button states change dynamically (e.g., disable Start after press)
- ✅ Designed for modularity and clarity using multiple classes
---
## 🗂 Project Structure
```
PythonStopwatch/
├── main.py # Entry point – initializes and runs the app
├── stopwatch.py # Main widget – stopwatch UI and logic
├── digitalClock.py # Reused digital clock widget with real-time display
├── fonts/
│ └── ds_digital/
│ └── DS-DIGIT.TTF # Custom digital-style font
```
---
## 🎨 Styling
The app uses Qt Style Sheets (QSS) within Python to style:
- Labels and buttons with rounded borders
- Button hover states
- Font sizes and background colors
Buttons are enhanced with a **pointing hand cursor** to signal interactivity.
---
## 🧠 How It Works
- The stopwatch uses `QTime` and `QTimer` to track elapsed time in 10ms intervals.
- The digital clock updates every second using its own `QTimer`.
- Time is formatted consistently using `f"{val:02}"` specifiers to ensure fixed-width layout.
- The custom font is loaded using `QFontDatabase.addApplicationFont(...)` with safe fallbacks and exception handling.
- Font path detection adapts for PyInstaller or `.app` bundle usage.
---
## ▶️ Running the App
```bash
pip install PyQt5
python main.py
```
---
## 💾 Font Loading
The stopwatch uses a custom font stored at:
```
fonts/ds_digital/DS-DIGIT.TTF
```
It is loaded programmatically and safely handled in case the file is missing or fails to register.
---
## 🧑💻 Author
Built by @fgatto13
This project reflects applied concepts of custom font handling,
time management, event-driven programming, and clean UI design in PyQt5.
## 🙏 Credits & Acknowledgments
This project is based on a PyQt5 digital stopwatch tutorial originally created by [BroCode](https://www.youtube.com/watch?v=ix9cRaBkVe0&t=17196s).
The original tutorial served as a foundation for building a simple stopwatch GUI.
This version adds:
- event handling of the various buttons (enabled/disabled dynamically)
- dynamic changes based on events for the text
- a custom font
- reuse of another custom widget (digital clock)