📬 AutoForwardPDF

A lightweight Windows app that automatically scans your Gmail inbox for invoice emails, downloads attached or linked PDF invoices, and forwards them to specified recipients based on subject-line instructions.

🚀 Features

• ✅ Gmail Integration with OAuth2
• 📥 Automatic PDF Extraction (from attachments or links)
• 📤 Smart Email Forwarding based on subject-line routing
• 🖥️ Simple GUI for manual control and configuration
• 📄 Logging of all actions and errors
• 🛠️ Packaged as a Windows Executable (.exe)

---

📌 How It Works

1. The app scans Gmail for emails with a subject like:

   InvoicePDF+recipient@example.com
   

2. It extracts the recipient@example.com address.

3. It then:

   • Downloads the PDF from the email (either attachment or external link)
   • Composes a new email
   • Attaches the PDF
   • Forwards it to the extracted recipient

4. A log entry is recorded for each operation (success or error).

---

🧰 Tech Stack

Component	Tool/Library
Language	Python 3.11+
GUI	Tkinter or PyQt5
Email Access	Gmail API + OAuth2
PDF Handling	requests, email
Logging	Python logging module
Packaging	PyInstaller

---

🖥️ GUI Features

• Manual scan trigger
• Status display (last scan, last forward, errors)
• Configuration for Gmail credentials, recipient rules
• Log viewer

---

⚡ Quick Start

1. Clone/download this repo and install dependencies:

   pip install -r requirements.txt
   

2. Run the app:

   python main.py
   

3. Configure your Gmail and recipient rules in the GUI.

---

📦 Packaging

To create a Windows executable:

pyinstaller --onefile main.py

---

📃 License

MIT License

---

🙋 Support

Questions or setup help? Contact you@example.com