EVCC Charging Report Generator

This project automates the generation of PDF charging reports from your EVCC instance. It fetches charging session data for the previous month, formats it into a PDF report, and optionally sends it via email.

This project is designed primarily as a Dockerized solution.

Features

• 📊 Automated Reporting: Fetches charging sessions from the EVCC API for the previous month.
• 📄 PDF Generation: Creates formatted PDF reports including session details, total energy, and total cost.
• 📧 Email Delivery: Automatically emails the generated PDF to a specified recipient.
• 🐳 Docker Support: Simple deployment using Docker Compose.
• 🌍 Localization: Supports locale settings for date and number formatting.

Quick Start (Docker)

1. Clone the repository:

   git clone https://github.com/MaizeShark/evcc-to-PDF
   cd evcc-to-PDF

2. Configure the environment: Copy the example configuration file and edit it with your details.

   cp .env.example .env
   nano .env

   Configuration Variables:

   Variable	Description	Default
   EVCC_URL	URL of your EVCC instance	http://localhost:7070
   EVCC_PASSWORD	Password for EVCC (if authentication is enabled)	(empty)
   SMTP_SERVER	SMTP Server address	(Required for email)
   SMTP_PORT	SMTP Server port	587
   SENDER_EMAIL	Email address sending the report	(Required for email)
   SENDER_PASSWORD	Password for the sender email	(Required for email)
   RECIPIENT_EMAIL	Recipient email address	(Required for email)
   SENDER_NAME	Name displayed in the PDF header	John Doe
   SENDER_STREET	Street address in PDF header	Sample Street 123
   SENDER_CITY	City/Zip in PDF header	12345 Sample City
   LOCALE	Locale for date/number formatting	de_DE.UTF-8

3. Run with Docker Compose:

   docker-compose up --build

   The generated PDF will be available in the ./pdfs directory.

Local Development (Optional)

If you wish to run the script without Docker (e.g., for development):

1. Install dependencies:

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt

   Note: WeasyPrint requires system dependencies (like libpango-1.0-0) which are automatically handled in the Docker image.

2. Run the script: Ensure your environment variables are set (or use a .env loader) and run:

   python3 generate_pdf_report.py

   You can also manually specify a year and month:

   python3 generate_pdf_report.py --year 2023 --month 12

Customization

• Templates: The script uses template_de.html (or template_en.html) by default depending on locale. You can edit these files to change the PDF layout.

Automation

You can set up this tool to run automatically on the 1st of every month to generate the report for the previous month.

Option 1: Automatic Setup (Recommended)

Run the included setup script to automatically add a cron job to your system:

./setup_cron.sh

This will configure a job to run at 02:00 AM on the 1st of every month.

Option 2: Manual Cron Setup

1. Open your crontab:

   crontab -e

2. Add the following line (adjust the path to your installation):

   0 2 1 * * cd /path/to/evcc-to-PDF && docker-compose up >> cron.log 2>&1