SimpleMail

🇫🇷 FR · 🇬🇧 EN

Client mail IMAP immersif — backend Python FastAPI + interface HTML/JS vanilla. Packagé en application native (macOS · Windows · Linux).

Fonctionnalités

• Vue liste + conversation avec colonne redimensionnable (largeur responsives en % sur grands écrans)
• Newsletters : carrousel multicartes (grille adaptative 4→8 colonnes selon la place), dock animé, détail hero avec vraies images
• Catégories Gmail (icônes + badges)
• Raccourcis clavier entièrement configurables
• Page Paramètres plein écran (polices, thème, format date, newsletters, langues, comptes, à propos)
• Thème light/dark/fond photo
• Mode sélection avec actions groupées
• Recherche centrée avec compteur
• Favicon expéditeur avec fallback initiales
• Mode lecture immersive
• Composeur plein écran
• Import/export des comptes (JSON : config + mots de passe + base SQLite + réglages localStorage)
• Flux RSS intégré
• Données de démo intégrées avec images réelles (Unsplash)
• Export/import sauvegarde tout : comptes, mots de passe, cache emails, réglages UI, largeurs colonnes, raccourcis

Utilisation

Mode développement

cd src/desktop
source secrets/mail.env  # ou export des variables
python3 main.py
# http://0.0.0.0:8000

Mode application

./SimpleMail.command                          # macOS (dev)
# releases/macos/SimpleMail.app               # macOS (packagé)
# releases/windows/SimpleMail/SimpleMail.exe  # Windows
# releases/linux/SimpleMail/SimpleMail        # Linux

Raccourcis clavier

Touche	Action
⌘, / Ctrl+,	Ouvrir les Paramètres
Escape (1×)	Recul progressif (sélection → recherche → vue liste)
Escape (suppl.)	Ouvrir/fermer le menu latéral (drawer)
G puis I	Boîte de réception
G puis S	Messages suivis
G puis T	Corbeille
G puis D	Brouillons
G puis A	Archives
G puis N	Envoyés
C	Nouveau message
J / ↓	Message suivant
K / ↑	Message précédent
Enter / Espace	Ouvrir le message
/	Rechercher

Tous les raccourcis sont configurables dans Paramètres → Raccourcis.

Configuration

Les fichiers de configuration sont stockés par plateforme :

• macOS : ~/Library/Application Support/SimpleMail/
• Windows : %APPDATA%/SimpleMail/
• Linux : ~/.local/share/SimpleMail/

Contenu :

• config.json : comptes IMAP/SMTP
• secrets/mail.env : mots de passe (jamais dans le dépôt)
• simplemail.db : cache des messages, réglages, labels

Performances

Le backend maîtrise sa consommation mémoire :

• Caches en RAM bornés (LRU) : threads (40 entrées), corps de messages (150 entrées, TTL 5 min)
• Plafond de 6000 en-têtes par filtrage (catégorie/recherche) — évite de charger toute la boîte en RAM
• Thread de purge automatique des caches SQLite toutes les 10 min (response_cache, msg_detail_cache, newsletter_msg_cache)

Installation

1. Cloner le projet
2. cd src/desktop
3. Copier config.example.json → config.json, renseigner vos comptes
4. Créer secrets/mail.env avec les mots de passe
5. Lancer python3 main.py

Pour tout transférer vers une autre machine : Réglages → Comptes → Exporter, puis Importer sur l'autre machine.

Déploiement web (o2switch / PWA)

L'application peut être déployée sur un hébergement mutualisé o2switch via cPanel → Setup Python App. Le backend FastAPI tourne en Python, le frontend est servi comme PWA (installable sur iPhone/Android sans App Store).

https://mail.mondary.design/

Documentation complète : src/desktop/DEPLOIEMENT_O2SWITCH.md

Prérequis déploiement

• Sous-domaine dédié (ex. mail.votredomaine.fr)
• SSL Let's Encrypt (gratuit, activé via cPanel)
• Setup Python App : Python 3.11, passenger_wsgi.py, entry point application

Fichiers à déployer

• App root (Python) : passenger_wsgi.py, main.py, config.json, secrets/, .htaccess
• Document root (statique) : index.html, manifest.webmanifest, sw.js, icon.png, bg.jpg

Sécurité

Authentification web (déploiement public)

Quand l'app est exposée sur Internet, l'authentification est obligatoire et activée par défaut (SIMPLEMAIL_AUTH=1). Configurez un mot de passe :

# Variable d'environnement (cPanel → Setup Python App → Environment variables)
SIMPLEMAIL_PASSWORD=votre_mot_de_passe

Le mot de passe est vérifié via une session cookie (sm_session) :

• Cookie httponly + secure + samesite=lax (30 jours)
• Token généré via secrets.token_urlsafe(32) (256 bits)
• Rate limiting : 5 tentatives/minute par IP
• Nettoyage automatique des sessions expirées

Protection des fichiers sensibles

Fichier	Protégé par
config.json (identifiants en ${VAR})	.htaccess + hors du document root
secrets/mail.env (mots de passe)	.htaccess + hors du document root
*.db (cache email)	.htaccess
Variables d'environnement	cPanel (pas dans le webroot)

Headers de sécurité

• Content-Security-Policy (CSP) : limite les sources autorisées
• X-Content-Type-Options: nosniff
• X-Frame-Options: DENY
• Referrer-Policy: strict-origin-when-cross-origin

Recommandations

1. Ne stockez jamais les mots de passe directement dans config.json — utilisez les variables d'environnement (${MAIL_PASSWORD})
2. Activez l'authentification sur tout déploiement public (SIMPLEMAIL_AUTH=1)
3. Utilisez HTTPS (Let's Encrypt dans cPanel)
4. Surveillez les logs cPanel pour détecter les tentatives suspectes
5. Faites tourner les mots de passe IMAP régulièrement, surtout après un déploiement

Build

macOS

cd src/desktop
./build_macos.sh
# → releases/macos/SimpleMail.app

Windows

cd src\desktop
.\build_windows.ps1
# → releases\windows\SimpleMail\

Linux

cd src/desktop
sudo apt install libwebkit2gtk-4.0-dev  # système requis
./build_linux.sh
# → releases/linux/SimpleMail

Prérequis build (toutes plateformes)

python3 -m pip install --user -r src/desktop/build-requirements.txt

Les bundles sont nettoyés : aucun compte, aucun mot de passe, aucune donnée personnelle embarquée. La première ouverture crée automatiquement les dossiers de données utilisateur.

Structure du projet

├── src/desktop/              ← Application principale
│   ├── main.py               ← Backend FastAPI
│   ├── app.py                ← Lanceur pywebview (multi-plateforme)
│   ├── index.html            ← Interface complète
│   ├── config.example.json
│   ├── build_macos.sh
│   ├── build_linux.sh
│   ├── build_windows.ps1
│   └── icon.png
├── releases/macos            ← Builds macOS (.app)
├── releases/windows          ← Builds Windows (.exe)
├── releases/linux            ← Builds Linux
├── archives/                 ← Anciennes versions
├── SimpleMail.command        ← Lanceur développement (macOS)
└── README.md