# ♻️ Pfandrechner Application Suite

**Version:** V.7.04.301  
**License:** [MIT](LICENSE)

Welcome to the **Pfandrechner Application - Package** – a sleek and powerful tool for tracking and calculating container deposits ("Pfand") in Austria 🇦🇹. Whether you're returning a few bottles or managing full bags, this app has you covered!

This is a copy of [Pfand](https://github.com/ZockerKatze/pfand), but this is in Package Form which can be **imported** and integrated!

---

## ✨ Features

🔢 **Deposit Calculator** – Instantly compute the total value of your returned bottles and cans.

🏆 **Achievements** – Track your progress and unlock fun rewards for your deposit milestones.

📜 **History & Exports** – View your past returns and export the data for safekeeping or bragging rights.

📦 **TGTG Integration** – Check on your "Too Good To Go" orders directly within the app. ( You need to setup your API Key first! )

⚙️ **Smart Updater** – Keeps the app fresh with the latest features and fixes.

---

## 🚀 Getting Started

### 1. Clone the Repository

```bash
git clone https://github.com/ZockerKatze/pfand.git
cd pfand
```

### 2. Install Dependencies

Make sure you’re using Python 3, then run:

```bash
pip install -r requirements.txt
```

### 3. Launch the App

```bash
python run.py
```

---

## 🧮 How to Count

You can either:

- ✍️ **Manually** count and enter your container numbers  
  _OR_  
- 🔬 Use **µScan** – the improved scanner for fast and accurate counting with barcode recognition using _pyzbar_!

---

## 🤝 Contributing

Want to improve the app or add new features? Awesome!  
Fork the repo, make your changes, and send a pull request. 💡

---

## 📄 License

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

---

Made with 💚 for recycling and a cleaner future.