========================================================================
  TCOLLECTIF · MAILER
  Envoyer des emails personnalisés depuis TON ordinateur
------------------------------------------------------------------------
  Outil LIBRE et GRATUIT — proposé par le collectif Tcollectif.
  Pour tout le monde : tu peux l'utiliser, le modifier et le partager.
  Auteur : Yannick Mandaba · 2026 · Licence MIT (voir LICENCE.txt)
========================================================================

Ce petit programme tourne SUR TON ORDINATEUR (Windows, Mac ou Linux).
Pas de serveur, pas de site à installer. Il envoie un email personnalisé
à chaque adresse d'une liste, en espaçant les envois pour ne pas être
pris pour un spammeur.

Il fonctionne avec N'IMPORTE QUELLE adresse : ton propre domaine
(ex. contact@ruche35.fr), Gmail, Outlook, OVH, Gandi…

------------------------------------------------------------------------
  1. INSTALLER PYTHON (une seule fois, si tu ne l'as pas déjà)
------------------------------------------------------------------------
Windows :
  - Va sur https://www.python.org/downloads/
  - Télécharge et lance l'installateur.
  - IMPORTANT : coche la case « Add python.exe to PATH » en bas,
    AVANT de cliquer sur Install.
  - Pour vérifier : ouvre l'application « Invite de commandes » et tape
        python --version
    Un numéro de version (ex. Python 3.12) = c'est bon.

Mac : Python est souvent déjà là. Sinon : https://www.python.org/downloads/
Linux : déjà présent (python3).

Rien d'autre à installer : ce programme n'utilise que ce qui vient avec
Python. Aucune commande « pip install » nécessaire.

------------------------------------------------------------------------
  2. CONFIGURER (une seule fois)
------------------------------------------------------------------------
Windows : double-clique sur   Lancer-Configuration.bat
Mac/Linux : dans un terminal, dans ce dossier :   python3 configurer.py

L'assistant te demande :
  - chez qui est ton adresse (Gmail / Outlook / OVH / ton domaine…)
  - ton adresse et ton mot de passe
  - le rythme d'envoi (par défaut 120/jour, 45 à 90 secondes d'écart)

Il teste la connexion tout de suite et enregistre tout dans « config.ini ».
Ton mot de passe reste sur ton ordinateur, uniquement dans ce fichier.

  ⚠️ Cas Gmail : Google demande un « mot de passe d'application »
     (pas ton mot de passe habituel). À créer sur
     myaccount.google.com > Sécurité > Validation en deux étapes >
     Mots de passe des applications.

------------------------------------------------------------------------
  3. PRÉPARER LES 3 FICHIERS
------------------------------------------------------------------------
  • destinataires.csv : la liste. Copie destinataires.exemple.csv,
    renomme-le destinataires.csv, et mets tes adresses. Il faut au moins
    une colonne « email ». Tu peux ajouter d'autres colonnes
    (prenom, commune, …) pour personnaliser.

  • sujet.txt : l'objet de l'email.
  • corps.txt : le texte de l'email.

    Dans sujet.txt et corps.txt, tout mot entre accolades comme {commune}
    est remplacé par la colonne du même nom du CSV, pour chaque personne.
    {signature} est remplacé par ta signature (config.ini).

------------------------------------------------------------------------
  4. ENVOYER
------------------------------------------------------------------------
Windows : double-clique sur   Lancer-Envoi.bat   et choisis :
  1) Test    → tu reçois 1 email d'exemple (vérifie le rendu)
  2) Aperçu  → montre ce qui partirait, SANS rien envoyer
  3) Envoyer → envoie pour de vrai, au rythme choisi

Mac/Linux :  python3 envoyer.py --test   /   python3 envoyer.py   /
             python3 envoyer.py --envoyer

Reprise automatique : si tu as beaucoup d'adresses, le programme en
envoie « par jour » puis s'arrête. Relance-le le lendemain : il continue
tout seul et ne renvoie JAMAIS deux fois à la même adresse (grâce au
journal « envois.csv »).

------------------------------------------------------------------------
  BON À SAVOIR
------------------------------------------------------------------------
  - Un email en texte simple, sans pièce jointe ni lien, passe beaucoup
    mieux les filtres anti-spam. C'est ce que fait ce programme.
  - Ne mets pas des centaines d'adresses à envoyer d'un coup : le rythme
    par défaut est là pour ça. Depuis une adresse perso, reste raisonnable.
  - Les fichiers config.ini et envois.csv contiennent tes infos : ne les
    partage pas.
========================================================================
  Tcollectif · Mailer — un outil du collectif, offert à tou·te·s.
  Libre de modification et de partage (licence MIT). Bon envoi !
========================================================================
