Interface web d'administration complète
Gestion multi-plateformes (Discord opérationnel, Twitch intégré, YouTube Live en développement)
Système de notifications automatiques
Base de données intégrée pour la persistance

Fonctionnalités

Discord

Statuts dynamiques : Rotation automatique des humeurs (10 min)
Notifications Humble Bundle : Surveillance et alertes automatiques (30 min)
Commandes personnalisées : Gestion via interface web
Recherche ProtonDB : Commande !protondb <nom_du_jeu> pour vérifier la compatibilité Linux/Steam Deck
Modération : Outils intégrés

Twitch

Chat bot : Commandes et interactions automatiques
Alertes Live : Surveillance automatique des streamers (vérification toutes les 5 minutes)
- Support jusqu'à 100 chaînes simultanément
- Notifications Discord avec aperçu du stream
- Gestion via interface d'administration
- Détection automatique des débuts/fins de stream

YouTube Live (en développement)

Chat bot : Modération et commandes
Événements : Notifications de diffusion

Interface d'administration

Dashboard : Vue d'ensemble et statistiques
Configuration : Tokens, paramètres des plateformes, configuration ProtonDB
Gestion des humeurs : Création et modification des statuts
Commandes : Édition des commandes personnalisées
Modération : Outils de gestion communautaire

Installation

Prérequis

Docker Engine ou Docker Desktop
Token Discord pour le bot
Token Twitch (optionnel) pour les fonctionnalités Twitch

Création du bot Discord

Avant d'installer MamieHenriette, vous devez créer un bot Discord et obtenir son token :

Accéder au portail développeur : Rendez-vous sur Discord Developer Portal
Créer une nouvelle application :
- Cliquez sur "New Application"
- Donnez un nom à votre bot (ex: "MmeMichue")
- Acceptez les conditions et cliquez sur "Create"
Configurer le bot :
- Dans le menu latéral, cliquez sur "Bot"
- Ajoutez une photo de profil et un pseudo à votre bot
- Important : activez les intents :
  - ☑️ Presence Intent
  - ☑️ Server Members Intent
  - ☑️ Message Content Intent
- Cliquez sur "Save Changes"
Récupérer le token :
- Dans la section "Token", cliquez sur "Reset Token"
- Copiez le token généré (gardez-le secret !)
Inviter le bot sur votre serveur :
- Allez dans "OAuth2" > "URL Generator"
- Sélectionnez les scopes : bot et applications.commands
- Sélectionnez les permissions nécessaires (Administrator recommandé pour simplifier)
- Utilisez l'URL générée pour inviter le bot sur votre serveur

Démarrage rapide

# 1. Cloner le projet
git clone https://github.com/skylanix/MamieHenriette.git

cd MamieHenriette

# 2. Lancer avec Docker
docker compose up --build -d

⚠️ Important : Après configuration via l'interface web http://localhost:5000, redémarrez le conteneur pour que les changements soient pris en compte :
docker compose restart MamieHenriette

Volumes persistants

./instance/ : Base de données SQLite et configuration
./logs/ : Logs applicatifs rotatifs (50MB max par fichier)

Commandes Docker utiles

# Logs d'un conteneur en cours d'exécution
docker logs -f MamieHenriette

# Redémarrer
docker compose restart MamieHenriette

# Arrêter
docker compose down

Mise à jour

Avec Docker (recommandé)

# 1. Arrêter les conteneurs
docker compose down

# 2. Récupérer les dernières modifications
git pull origin main

# 3. Mettre à jour l'image Docker
docker compose pull

# 4. Reconstruire et relancer
docker compose up --build -d

Sans Docker (installation locale)

# 1. Arrêter l'application
# (Ctrl+C si elle tourne en premier plan)

# 2. Récupérer les modifications
git pull origin main

# 3. Mettre à jour les dépendances
pip install -r requirements.txt

# 4. Relancer
python run-web.py

Architecture du projet

Interface d'administration

Section	Fonction
Configurations	Tokens Discord/Twitch, paramètres généraux et configuration ProtonDB
Humeurs	Gestion des statuts Discord rotatifs
Commandes	Commandes personnalisées multi-plateformes (Discord/Twitch)
Alertes Live	Configuration surveillance streamers Twitch avec notifications Discord
Messages	Messages automatiques et notifications périodiques
Modération	Outils de gestion communautaire

Structure des modules

├── database/          # Couche données
│   ├── models.py      # Modèles ORM
│   ├── helpers.py     # Utilitaires BDD
│   └── schema.sql     # Structure initiale
│
├── discordbot/        # Module Discord
│   ├── __init__.py    # Bot et handlers principaux
│   └── humblebundle.py # Surveillance Humble Bundle
│
├── twitchbot/         # Module Twitch  
│   ├── __init__.py    # Bot Twitch et handlers
│   └── live_alert.py  # Surveillance des streams live
│
├── protondb/          # Module ProtonDB
│   └── __init__.py    # API Algolia et recherche compatibilité
│
└── webapp/            # Interface d'administration
    ├── static/        # Assets statiques (CSS, JS, images)
    ├── templates/     # Vues HTML Jinja2
    ├── live_alert.py  # Gestion des alertes Twitch
    ├── twitch_auth.py # Authentification Twitch OAuth
    └── *.py           # Autres contrôleurs par section

Composants principaux

Fichier	Rôle
`run-web.py`	Point d'entrée principal
`start.sh`	Script de démarrage Docker
`docker-compose.yml`	Configuration des services
`requirements.txt`	Dépendances Python

Spécifications techniques

Base de données (SQLite)

Configuration : Paramètres et tokens des plateformes
Humeur : Statuts Discord rotatifs avec gestion automatique
Commande : Commandes personnalisées multi-plateformes (Discord/Twitch)
LiveAlert : Configuration surveillance streamers Twitch (nom, canal Discord, statut)
GameAlias : Alias pour améliorer les recherches ProtonDB
GameBundle : Historique et notifications Humble Bundle
Message : Messages automatiques périodiques (implémenté)

Architecture multi-thread

Thread 1 : Interface web Flask (port 5000) avec logging rotatif
Thread 2 : Bot Discord et tâches automatisées (humeurs, Humble Bundle)
Thread 3 : Bot Twitch et surveillance live streams (vérification 5min)

Monitoring et logging

Healthcheck Docker : Surveillance processus Python + détection erreurs logs
Logs rotatifs : Fichiers limités à 50MB avec rotation automatique
Persistance : Logs sauvegardés sur l'hôte dans ./logs/

Dépendances principales

discord.py==2.3.2         # API Discord avec support async
flask>=2.3.2              # Interface web et API REST
flask-sqlalchemy>=3.0.3   # ORM SQLAlchemy pour base de données
flask[async]              # Extensions async pour Flask
requests>=2.32.4          # Client HTTP pour APIs externes
waitress>=3.0.2           # Serveur WSGI de production
algoliasearch>=4,<5       # API ProtonDB via Algolia
twitchAPI>=4.5.0          # API Twitch pour streams et chat
python-dotenv==1.0.0      # Gestion variables d'environnement
aiohttp>=3.7.4,<4         # Client HTTP async (requis par discord.py)
audioop-lts               # Compatibilité audio Python 3.13+

Développement

Installation locale

python3 -m venv venv

source venv/bin/activate

pip install -r requirements.txt

python run-web.py

Contribution

Fork du projet
Branche feature
Pull Request

Licence

MamieHenriette - Bot multi-plateformes pour Discord, Twitch et YouTube Live
Copyright (C) 2025 Philippe Favre

Ce programme est un logiciel libre : vous pouvez le redistribuer et/ou le modifier
selon les termes de la Licence Publique Générale GNU Affero telle que publiée
par la Free Software Foundation, soit la version 3 de la Licence, ou
(à votre choix) toute version ultérieure.

Ce programme est distribué dans l'espoir qu'il sera utile,
mais SANS AUCUNE GARANTIE ; sans même la garantie implicite de
COMMERCIALISATION ou d'ADÉQUATION À UN USAGE PARTICULIER. Voir la
Licence Publique Générale GNU Affero pour plus de détails.

Vous devriez avoir reçu une copie de la Licence Publique Générale GNU Affero
avec ce programme. Si ce n'est pas le cas, voir <https://www.gnu.org/licenses/>.

Mamie Henriette vous surveille ! 👵👀