Skip to content

v3.0.0 — First Stable Release

Choose a tag to compare

@kartikbansode kartikbansode released this 13 Aug 18:57
· 14 commits to main since this release
dce1c3d

QuickBill logo

QuickBill

Professional Desktop Billing & POS Management System

Fast billing · Barcode scanning · Product management · Payments · Invoices

Releases v3.0.0 Customer Display Barcode Scanner Repository

Version 3.0.0 Python 3.11+ Windows Proprietary License

QuickBill is a professional desktop billing and point-of-sale system designed for retail shops and small businesses. It provides a complete billing workflow with barcode scanning, product management, inventory handling, payments, customer-facing display synchronization, invoice generation, and billing history.


v3.0.0 — First Stable Release

QuickBill v3.0.0 marks the first stable release of the QuickBill desktop application.

This release consolidates the core billing, product management, invoice, payment, customer display, and POS functionality into a stable desktop application with a consistent professional interface and production-focused architecture.

Release Highlights

  • Stable QuickBill Pro desktop billing application
  • Professional POS-oriented billing interface
  • Improved application startup and splash screen workflow
  • Consistent application-wide UI components and styling
  • Barcode scanning and manual item entry
  • Product and inventory management
  • Professional invoice generation
  • Bill history and reprinting
  • Hold and resume billing workflow
  • Multiple payment modes
  • Dynamic UPI QR payment support
  • Real-time customer display integration
  • Improved customer display synchronization and reconnect handling
  • Improved error handling and application stability
  • Responsive desktop UI for different screen sizes
  • Updated release documentation and project structure
  • Versioned as the first stable v3.0.0 release

Screenshots

Customer Billing Window

image

Product Management

image

Invoice

80 mm -

image

A4 -

image

QuickBill Ecosystem

QuickBill Desktop is the core billing application and authoritative source of billing data.

It manages:

  • Products
  • Inventory
  • Cart state
  • Bills
  • Transactions
  • Payment state
  • Customer information
  • Invoice generation

The companion applications connect to QuickBill Desktop to provide additional POS functionality.

Customer Display App

Provides a real-time customer-facing display for:

  • Current bill items
  • Quantities
  • Prices
  • Bill totals
  • Payment information
  • UPI QR display
  • Payment success state

Barcode Scanner App

Provides companion barcode-scanning functionality for QuickBill Desktop.


Core Features

Billing & POS

  • Fast point-of-sale billing workflow
  • Manual item entry
  • Barcode-based item entry
  • Automatic quantity handling
  • Item-level quantity controls
  • Item deletion
  • Automatic subtotal and total calculation
  • Tax and discount handling
  • Automatic bill numbering
  • Customer information capture
  • Bill confirmation workflow
  • Hold and resume bills

Product Management

  • Add products
  • Edit products
  • Delete products
  • Search products
  • Barcode-based product identification
  • Product pricing
  • Inventory and stock management

Barcode Scanning

  • USB barcode scanner support
  • IP/webcam-based scanning support
  • Continuous scanning
  • Duplicate barcode handling
  • Automatic product lookup
  • Manual barcode entry

Payments

Supported payment workflows include:

  • Cash
  • UPI
  • Card
  • Credit

Features include:

  • Dynamic UPI QR generation
  • Bill amount linked to payment QR
  • Payment confirmation workflow
  • Customer display payment state
  • Transaction completion handling

Invoice Generation

  • Professional PDF invoices
  • A4 invoice format
  • 80 mm receipt format
  • Printable billing documents
  • Bill reprinting
  • Automatic bill numbering

Billing History

  • View previous bills
  • Search billing records
  • Review transaction information
  • Reprint invoices

Customer Display

  • Real-time bill synchronization
  • Customer-facing item display
  • Live totals
  • Payment QR display
  • Payment status
  • Success screen
  • Automatic reconnection
  • Graceful disconnected state

Technology Stack

Component Technology
Desktop Application Python
GUI Tkinter
Runtime Python 3.11+
Invoice Generation PDF generation
Product/Billing Data Local application storage
Barcode Scanning USB / Camera / Companion Scanner
Customer Display Network communication
Platform Windows 10 / Windows 11
Packaging PyInstaller

Requirements

  • Windows 10 or Windows 11
  • Python 3.11 or newer
  • Required Python packages listed in requirements.txt

Installation

Clone the repository:

git clone https://github.com/kartikbansode/quickbill.git

Go to the project directory:

cd quickbill

Install dependencies:

pip install -r requirements.txt

Run the application:

python app.py

Building the Executable

pyinstaller QuickBill.spec

The executable will be generated inside the dist folder.


UPI Payment Configuration

QuickBill Pro supports dynamic UPI QR payments.

Before using UPI payments, configure your UPI ID in the following two files.

1. Configure UPI ID

Open:

logic/upi_payment.py

Find:

DEFAULT_UPI_ID = "PUT-YOUR-UPI-ID-HERE"

Replace it with your own UPI ID.

Example:

DEFAULT_UPI_ID = "yourupi@bank"

2. Configure Payment Dialog

Open:

gui/payment/payment_dialog.py

Find:

self.upi_id = "PUT-YOUR-UPI-ID-HERE"

Replace it with the same UPI ID.

Example:

self.upi_id = "yourupi@bank"

Make sure the UPI ID is identical in both files.

3. Dynamic UPI QR

When UPI payment is selected, QuickBill generates a dynamic payment QR containing:

  • UPI ID
  • Merchant name
  • Current bill amount
  • Bill number
  • Currency (INR)

The QR code is generated automatically for each bill and displayed through the customer display system.

Important

  • Use a valid UPI ID belonging to the business or merchant.
  • Use the same UPI ID in both configuration locations.
  • Do not add your UPI PIN, password, bank credentials, or other sensitive information to the source code.
  • Test the generated QR code with a small transaction before using QuickBill for real billing.

License

This project is proprietary software.

Copyright © 2026 Kartik Bansode. All Rights Reserved.

The source code is publicly available for viewing, educational, portfolio, and evaluation purposes only.

No permission is granted to copy, reproduce, modify, redistribute, republish, commercially use, sublicense, sell, or create derivative works from this software or its source code without prior written permission from the copyright holder.

For complete terms and restrictions, see the LICENSE file.


Contact

LinkedIn
https://www.linkedin.com/in/kartikbansode

GitHub
https://github.com/kartikbansode