techceo/expiry-notifier repository overview

⁠Expiry Notification System

A desktop-based inventory management system that notifies small business owners of products nearing expiry. Built with Python, PyQt5, and SQLite, this tool provides a simple GUI to manage and monitor product inventory.

⁠📦 Features

• Add, search, and delete product entries
• Tracks product expiry dates
• Desktop notification alerts (cross-platform via plyer)
• Simple and intuitive PyQt5 interface
• SQLite-powered data persistence

⁠🚀 How to Run

⁠🐳 Docker (Recommended)

To run the app in a Docker container with GUI forwarding:

⁠✅ Windows (with VcXsrv running):

docker pull techceo/expiry-notifier:latest
$env:DISPLAY="host.docker.internal:0.0"
docker run -it --rm -e DISPLAY=$env:DISPLAY techceo/expiry-notifier

⁠📁 Inside the App

• Main.py: Launches the GUI and worker thread

• SQLite database: database.db

• GUI notifications for products expiring in ≤10 days

• Preloaded product categories and intuitive search/delete dialogs

⁠🛠 Tech Stack

• Python 3.11

• PyQt5

• SQLite

• Plyer (for cross-platform notifications)

• Docker (for containerization)

⁠👤 Author

Yusuf Adamu (TechCeo)