personnal-accounting/README.md

Comptabilité Scripts

This repository contains Python scripts to process financial statements from various banks and financial institutions, extract transaction data, and categorize expenses.

Features

• Processes PDF and CSV financial statements from multiple sources
• Categorizes transactions automatically based on descriptions
• Generates expense summaries with percentages
• Optional CSV output for all transactions (new feature)
• Support for Boursobank, American Express, Monabanq, Revolut, SNCF, and La Poste

Scripts Overview

Main Scripts

1. process_bourso.py - Processes Boursobank account statements
2. process_amex.py - Processes American Express credit card statements
3. process_monabanq.py - Processes Monabanq account statements
4. process_expenses.py - Processes Revolut account statements (CSV format)
5. process_sncf.py - Processes SNCF salary statements
6. process_laposte.py - Processes La Poste (CCP) account statements

Master Script

• process_all.py - Master script that runs all processing scripts with unified options

Usage

Individual Scripts

Each script can be run with optional CSV output:

# Process without CSV output
python process_bourso.py

# Process with CSV output
python process_bourso.py --csv

# Process all PDFs in a specific directory
python process_bourso.py --pdf-dir /path/to/pdfs --csv

Master Script

The master script can process all statements at once:

# Process all statements
python process_all.py

# Process all statements with CSV output
python process_all.py --csv

# Process only specific accounts
python process_all.py --bourso --amex --csv

Output

When run with --csv flag, each script generates:

• Individual CSV files for each input file (when applicable)
• A consolidated CSV file containing all transactions

The CSV files include:

• Date
• Description
• Category
• Amount/Debit/Credit
• Source file

Requirements

• Python 3.6+
• pdftotext utility (for PDF processing)
• Required Python packages: csv, subprocess, re, os, glob, collections

Installation

1. Install pdftotext:

   # Ubuntu/Debian
   sudo apt-get install poppler-utils
   
   # macOS
   brew install poppler
   
   # Windows
   # Download from https://github.com/xfftt/poppler-windows/releases/
   

2. Clone or download this repository

CSV Export Feature (New)

The scripts now support exporting all transaction data to CSV format. This allows for:

• Further analysis in spreadsheet applications
• Data archiving
• Integration with other financial tools
• Transaction-level review and editing

To enable CSV export, add the --csv flag when running any script.

Git Repository

This is now a Git repository. To start tracking changes:

git add .
git commit -m "Initial commit with CSV export functionality"

File Structure

comptabilite/
├── .gitignore
├── process_bourso.py
├── process_amex.py
├── process_monabanq.py
├── process_expenses.py
├── process_sncf.py
├── process_laposte.py
├── process_all.py
├── README.md
├── 1-sncf/
├── 2-la.poste/
├── american.express/
├── boursobank/
├── monabanq/
└── revolut/