Metadata-Version: 2.4
Name: bulkinvoicer
Version: 0.1.0a0
Summary: A simple python script to quickly create bulk invoices.
Project-URL: Homepage, http://github.com/yashovardhan99/bulkinvoicer
Project-URL: Repository, https://github.com/yashovardhan99/bulkinvoicer.git
Project-URL: Changelog, http://github.com/yashovardhan99/bulkinvoicer/blob/master/CHANGELOG.md
Project-URL: Issues, http://github.com/yashovardhan99/bulkinvoicer/issues
Project-URL: funding, https://github.com/yashovardhan99/bulkinvoicer
Project-URL: releasenotes, https://github.com/yashovardhan99/bulkinvoicer/releases
Author-email: Yashovardhan Dhanania <yashovardhandhanania@gmail.com>
Maintainer-email: Yashovardhan Dhanania <yashovardhandhanania@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: bill,finance,invoice,pdf,receipts
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: fpdf2<3.0.0,>=2.8.3
Requires-Dist: polars[calamine]<2.0.0,>=1.29.0
Requires-Dist: pydantic<3.0.0,>=2.11.7
Requires-Dist: qrcode<9.0,>=8.2
Requires-Dist: tqdm<5.0.0,>=4.67.1
Requires-Dist: uharfbuzz
Description-Content-Type: text/markdown

# BulkInvoicer

BulkInvoicer is a simple, offline-friendly CLI tool that helps freelancers and small businesses manage invoices and receipts in bulk using Excel. It generates professional-looking invoices, client summaries, and account statements—all from a single spreadsheet.

## ✨ Features

- 📁 **Excel-Based Workflow** – Use your existing spreadsheet to manage invoices.
- 🖨️ **Beautiful Invoice Generation** – Create printable invoices with custom styling.
- 🎨 **Fully Customisable Templates** – Modify colours, headers, footers, and fields.
- 📱 **UPI QR Code Support** – Automatically embed UPI QR codes for instant payments.
- 📊 **Summary Pages** – Generate overall and client-specific summaries.
- 📄 **PDF Output Options** – Export combined, client-wise, or individual invoice PDFs.
- 🔄 **Auto-Matching Receipts** – Match invoices with receipts and track advance payments.
- ⚙️ **Simple TOML Configuration** – Customise output types and preferences easily.
- 🔒 **Offline & Open Source** – Works entirely offline and is fully open-source.

## 📦 Installation

You can get BulkInvoicer from both [PyPi](https://pypi.org/project/bulkinvoicer/) and GitHub:

### PyPi

Just run:
```bash
pip install bulkinvoicer
```

### GitHub

You can also get BulkInvoicer directly from GitHub:
```bash
pip install git+https://github.com/yashovardhan99/bulkinvoicer.git#egg=bulkinvoicer
```

## 🛠️ Usage

1. Prepare your invoice data in an Excel file (use the same format as given in `sample.xlsx`).
2. Create a `config.toml` file to define your preferences.
3. Run the CLI command `incoiver` to generate invoices and summaries.

Alternatively, you can run it directly using pipx:

```bash
pipx run bulkinvoicer
```

You can find a sample `config.toml` file at [sample.config.toml](sample.config.toml)

## ⚒️ Changes

All changes to this project are tracked in our [CHANGELOG](CHANGELOG.md). If you create a pull request, please include a summary of your changes in this file.

## 📜 License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
