MERCI DE COTRE COMPRENSSION

Une application desktop moderne pour gérer tous vos bots Discord depuis une interface graphique intuitive.

Interface graphique intuitive - Gestion facile de tous vos bots Démarrage/Arrêt instantané - Contrôlez vos bots en un clic Logs en temps réel - Suivez l'activité de vos bots Multi-plateforme - Windows, macOS, Linux

• Node.js 16+
• npm ou yarn

1. Installez les dépendances :

npm install

2. Installez également les dépendances supplémentaires pour Electron :

npm install --save-dev concurrently wait-on

Pour lancer l'application en mode développement :

npm start

Cela va lancer à la fois le serveur React et l'application Electron.

npm run build-win

npm run build-mac

npm run build-linux

npm run build

Les exécutables seront générés dans le dossier dist/.

host-bot-discord/
├── src/                    
│   ├── App.jsx
│   ├── App.css
│   ├── index.jsx
│   └── index.css
├── public/                
│   └── index.html
├── Bots/                  
├── electron-main.js       
├── preload.js             
├── package.json          
└── README.md

• Electron - Framework pour applications desktop
• React - Bibliothèque UI
• Node.js - Runtime JavaScript
• electron-builder - Builder pour les exécutables

MIT

Pour toute question ou problème, veuillez ouvrir une issue sur le repository.

Pour lancer à la fois l'API backend et l'interface graphique Electron :

cd .. # depuis ce dossier, remontez à la racine du projet
./start-all.sh

• Le script démarre l'API (host-bot-discord) et la GUI (bot-manager-gui) en parallèle.
• Faites Ctrl+C pour tout arrêter proprement.
• Les dépendances sont installées automatiquement si besoin.

Prérequis : Node.js >= 18, npm

À chaque démarrage de l’API de gestion (api-bot-manage.js), un bot de test est créé automatiquement si aucun bot n’existe dans le dossier Bots/.

• Nom du bot : bot-test
• Config générée : Bots/bot-test/config.json
• Vous pouvez le supprimer ou le modifier depuis l’interface graphique.

Cela permet de toujours avoir un exemple visible dans la GUI dès le premier lancement.

Chaque bot créé (automatiquement ou via l’interface) possède un fichier config.json avec la structure suivante :

{
  "name": "bot-test",
  "auto": true,
  "token": "VOTRE_TOKEN_ICI",
  "prefix": "!",
  "description": "Bot Discord de test généré automatiquement.",
  "owner": "VotreNom",
  "created": "2025-12-05T21:00:00.000Z",
  "commands": [
    { "name": "ping", "description": "Répond pong", "usage": "!ping" },
    { "name": "help", "description": "Affiche l’aide", "usage": "!help" }
  ]
}

• Modifiez ces champs dans l’interface graphique ou directement dans le fichier.
• Chaque nouveau bot créé via l’API ou l’interface aura cette structure de base.

Tout est regroupé dans le dossier host-bot-discord :

• API backend : gestion des bots, logs, configuration
• Interface graphique (GUI) : host-bot-discord/bot-manager-gui/
• Bots : host-bot-discord/Bots/
• Script global : start-all.sh (lance tout depuis la racine)

Pour lancer l’ensemble :

./start-all.sh

1. Ouvrez un terminal dans le dossier racine du projet.
2. Exécutez la commande :

   ./start-all.sh

   Cela lance l’API backend et l’interface graphique Electron.

• Ajouter un bot : Entrez un nom et cliquez sur « Ajouter un bot ».
• Démarrer/Arrêter un bot : Utilisez les boutons à côté de chaque bot.
• Voir les logs : Cliquez sur « Voir logs » pour afficher les logs du bot.
• Éditer la config : Cliquez sur « Éditer config » pour modifier le fichier config.json du bot.
• Supprimer un bot : Cliquez sur « Supprimer ».

• Les bots sont dans host-bot-discord/Bots/
• Chaque bot possède un config.json et un package.json générés automatiquement.
• L’interface graphique est dans host-bot-discord/bot-manager-gui/

• Node.js ≥ 18
• npm

Q : Je n’ai pas de bots affichés dans la GUI, que faire ?
R : Un bot de test est créé automatiquement au premier lancement. Vous pouvez en ajouter d’autres via l’interface.

Q : Comment modifier la configuration d’un bot ?
R : Cliquez sur « Éditer config » dans la GUI pour modifier le fichier config.json du bot.

Q : Comment voir les logs d’un bot ?
R : Cliquez sur « Voir logs » à côté du bot dans l’interface.

Q : Comment supprimer un bot ?
R : Cliquez sur « Supprimer » dans la GUI. Le dossier du bot sera effacé.

Q : Que faire si la GUI ne se lance pas ?
R : Vérifiez que Node.js et npm sont installés, puis lancez npm install et npm start dans host-bot-discord/bot-manager-gui.

Q : Comment ajouter des commandes personnalisées à un bot ?
R : Ajoutez-les dans le tableau commands du fichier config.json du bot.