Personal Invoice Generator
A beautiful, modern desktop app for generating professional invoices with automated scheduling, AI-powered document analysis, and integrated e-mail delivery.

Features • Installation • Usage • Configuration • Placeholders • License

• Modern UI — Beautiful light and dark themes with a responsive design
• ODT Template System — Use LibreOffice/OpenOffice templates with placeholder substitution
• Automated Scheduling — Define billing rules with flexible periodicity (monthly, quarterly, yearly, custom)
• AI-Powered Analysis — Automatically extract amounts from receipts/invoices using Claude, GPT-4, or Gemini
• E-mail Integration — Compose and send invoices directly via SMTP with rich HTML templates
• Multi-Currency — Support for CZK, EUR, and USD with automatic exchange rate conversion
• File Management — Track and manage "proplatit" (to-reimburse) files with automatic processing
• Secure Storage — SMTP credentials and API keys are encrypted on disk

• Node.js 18+
• Rust (for Tauri)
• LibreOffice (for ODT → PDF conversion)

# Clone the repository
git clone https://github.com/lofcz/pig.git
cd pig

# Install dependencies
npm i

# Run in development mode
npm run tauri dev

# Build for production
npm run tauri build

1. Configure your settings — Set up your company details, customers, and bank account
2. Create a ruleset — Define billing periodicity, salary rules, and invoice templates
3. Add extra items — Drop receipts/invoices into the "proplatit" folder for reimbursement tracking
4. Generate invoices — Review pending invoices and generate them all at once
5. Send s — Compose and send invoices to customers with attached PDFs

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Configure      │ ──► │  Generate       │ ──► │  Send via       │
│  Rulesets       │     │  Invoices       │     │            │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │                       │
        ▼                       ▼                       ▼
   Salary rules          ODT → PDF             SMTP integration
   Periodicity           Preview mode          HTML templates
   Customer mapping      Batch generation      Attachments

your-invoice-root/
├── 24/                    # Year folder (invoices by year)
│   ├── faktura_*.odt
│   └── faktura_*.pdf
├── 25/
├── proplaceni/
│   └── proplatit/         # Files to reimburse
│   └── proplaceno/        # Processed files (auto-moved)
└── pig_template.odt       # Your invoice template

Rulesets define when and how invoices are generated:

• Periodicity: Monthly, Quarterly, Yearly, or Custom intervals
• Entitlement Day: Day of month when billing period closes
• Salary Rules: Date ranges with base value and deductions
• Invoice Splitting: Automatically split large invoices (e.g., max 80,000 CZK)
• Customer Rules: Map customers based on odd/even months or default

PIG uses two types of placeholders: Invoice Placeholders for ODT templates and ** Placeholders** for templates.

Use these in your LibreOffice/OpenOffice invoice templates:

Use these in subjects and bodies. Supports both {{placeholder}} syntax and full Eta template syntax for advanced logic.

templates support full Eta templating for complex scenarios:

<!-- Loop through invoices -->
<% it.invoices.list.forEach(function(inv) { %>
  <p>Invoice #<%= inv.number %> - <%= it.formatAmount(inv.amount, inv.currency) %></p>
<% }) %>

<!-- Conditional content -->
<% if (it.invoices.count > 1) { %>
  <p>Please find <%= it.invoices.count %> invoices attached.</p>
<% } else { %>
  <p>Please find the invoice attached.</p>
<% } %>

<!-- Czech pluralization -->
<p>
  Posílám <%= it.invoices.count %> 
  <%= it.plural(it.invoices.count, 'fakturu', 'faktury', 'faktur') %>
</p>

<!-- Format amounts -->
<p>Total: <%= it.formatAmount(it.invoices.totalAmount, 'CZK') %></p>

PIG can automatically extract amounts from receipts and invoices using AI vision models.

Configure API keys in Settings → General → API Keys:

• PDF documents
• Images: PNG, JPG, JPEG, GIF, WebP

1. Place receipts in the proplatit folder
2. Click the Analyze button in the Extra Items section
3. AI extracts amounts and currencies automatically
4. Review and adjust values as needed
5. Generate invoice — files are moved to proplaceno

• Frontend: React, TypeScript, Tailwind CSS
• Backend: Rust, Tauri

This library is licensed under the MIT license. 💜