https://github.com/n3rdium/pytaskbar
The Ultimate python taskbar progress package!
https://github.com/n3rdium/pytaskbar
easy-to-use python python-3 python-module python-package python-packages taskbar windows
Last synced: about 1 month ago
JSON representation
The Ultimate python taskbar progress package!
- Host: GitHub
- URL: https://github.com/n3rdium/pytaskbar
- Owner: N3RDIUM
- License: mit
- Created: 2021-05-21T06:49:01.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-06-07T08:11:06.000Z (11 months ago)
- Last Synced: 2025-07-08T10:13:50.200Z (10 months ago)
- Topics: easy-to-use, python, python-3, python-module, python-package, python-packages, taskbar, windows
- Language: Python
- Homepage:
- Size: 34.2 KB
- Stars: 20
- Watchers: 1
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# PyTaskbar
The ultimate taskbar progress python package!
## About
This is a wrapper API around the TaskbarLib.tlb (Windows 7+) that makes it easy
to show progress in the taskbar icon, a great plus when it comes to UX for your
desktop/TUI application. Simple API, works with any GUI framework!
## Installation
This package is available on PyPI! For most cases, installation is as simple as:
```
pip install PyTaskbar
```
If you want to install latest git instead:
```
pip install git+https://github.com/N3RDIUM/PyTaskbar.git
```
## Usage
Here's a minimal usage example:
```python
import time
from PyTaskbar import TaskbarProgress, ProgressType
# This will target the terminal window.
progress = TaskbarProgress()
# If you're using a GUI framework, pass the target window handle like so:
# progress = TaskbarProgress(window_handle)
# No progress
progress.set_progress_type(ProgressType.NOPROGRESS)
time.sleep(3)
# Indeterminate progress state
progress.set_progress_type(ProgressType.INDETERMINATE)
time.sleep(3)
# Normal (green) progress
progress.set_progress_type(ProgressType.NORMAL)
for i in range(100):
progress.set_progress(i)
time.sleep(0.05)
# Paused (yellow) progress
progress.set_progress_type(ProgressType.PAUSED)
progress.set_progress(42)
time.sleep(2)
# Error (red) progress
progress.set_progress_type(ProgressType.ERROR)
progress.set_progress(42)
time.sleep(2)
# Flash the taskbar icon signalling that the task completed
progress.flash_done()
time.sleep(5)
```
## Thanks and citations
- [@timminator](https://github.com/timminator) for helping fix the minimize bug