https://github.com/spignelon/clocky
Clocky: a simple Python/Tkinter clock widget that displays the current time as an overlay.
https://github.com/spignelon/clocky
clock desktop-widget productivity python time-tracking tkinter windows
Last synced: about 1 month ago
JSON representation
Clocky: a simple Python/Tkinter clock widget that displays the current time as an overlay.
- Host: GitHub
- URL: https://github.com/spignelon/clocky
- Owner: spignelon
- License: gpl-3.0
- Created: 2023-03-30T08:39:10.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-04-01T09:21:29.000Z (about 2 years ago)
- Last Synced: 2025-03-24T02:11:37.370Z (about 2 months ago)
- Topics: clock, desktop-widget, productivity, python, time-tracking, tkinter, windows
- Language: Python
- Homepage:
- Size: 21.5 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Clocky - An Overlay Clock Widget
Clocky is a dead simple clock application developed using Python and Tkinter. I created it to have an overlay clock widget on my computer that displays the current time so I don't lose track of it. It displays the current time in hours, minutes, and seconds with an AM/PM indicator. The clock updates itself every second and is positioned at the top-right corner of the screen as an overlay widget.
## Requirements
Clocky requires Python 3.x and the Tkinter module to be installed. If you don't have Python or Tkinter installed, you can download the pre-built executables for Windows and Linux from the [latest release](https://github.com/spignelon/Clocky/releases/latest) and use it standalone without installing anything else.
## Usage
Running as a Python script
To run Clocky as a Python script, open a terminal or command prompt and navigate to the folder where clocky.py is located. Then run the following command:
```
python Clocky.py
```
## Using the standalone executable
To use the standalone executable on Windows, download the Clocky.exe file from the [latest release](https://github.com/spignelon/Clocky/releases/latest). You can then run it by double-clicking on the file. The standalone executable doesn't require you to have Python or Tkinter installed on your computer.
To use the standalone executable on Linux, download the Clocky binary file from the [latest release](https://github.com/spignelon/Clocky/releases/latest) and make it executable using the following command:
```
chmod +x Clocky
```
You can then run it by double-clicking on the file or running it from the terminal using the following command:
```
./Clocky
```
The standalone executable on Linux is built on Arch Linux and should work on most modern Linux distributions.
## Release
The latest release of Clocky includes pre-built executable files for Windows (Clocky.exe) and Linux (Clocky). You can download the latest release from the [releases page](https://github.com/spignelon/Clocky/releases).
## Contributing
If you want to contribute to this project, feel free to submit a pull request.
## License
[](https://www.gnu.org/licenses/gpl-3.0.en.html)
Clocky is licensed under the [GNU General Public License v3.0](https://github.com/spignelon/Clocky/blob/main/LICENSE).