BLEEP v2.2.0 - VERSION PORTABLE
============================================================

DEMARRAGE
---------
Double-cliquez sur "Lancer Bleep.bat".

C'est tout. Au premier lancement, Setup.exe va :
  1. Telecharger et installer Ollama (~700 Mo - 1 Go).
  2. Telecharger le modele IA gemma3:4b (~3.3 Go).
  3. Telecharger les modeles vocaux Vosk FR + EN (~80 Mo, ~40 Mo chacun).
  Total : ~4 Go, connexion internet requise, une seule fois.

La progression s'affiche en console. Laissez tourner, ca peut etre long
selon votre connexion. Aux lancements suivants, Setup.exe verifie que tout
est en place en quelques secondes et enchaine sur Bleep.

WINDOWS DEFENDER / ANTIVIRUS
----------------------------
Defender peut bloquer les deux executables au premier lancement (faux
positif sur les binaires PyInstaller qui telechargent depuis Internet,
profil renforce par Vosk + sounddevice + acces micro de VoiceServer.exe).
Les deux executables a autoriser sont :

  - Setup.exe       (bootstrap Ollama + Gemma + Vosk)
  - VoiceServer.exe (serveur vocal local, dans Bleep\)

Si Defender intervient :

  - Sur la popup "Windows a protege votre PC" :
        "Informations complementaires" -> "Executer quand meme"

  - OU clic droit sur le .exe -> Proprietes -> cocher "Debloquer" -> OK

Setup.exe appelle l'installeur officiel Ollama
(https://ollama.com/download/OllamaSetup.exe) et telecharge les modeles
Vosk depuis https://alphacephei.com/vosk/models. VoiceServer.exe ecoute
votre micro en LOCAL uniquement, rien n'est envoye dehors.

DEUX FENETRES CONSOLES RESTENT OUVERTES
---------------------------------------
Pendant l'utilisation de Bleep, vous verrez deux consoles supplementaires :

  - "ollama serve" : le serveur IA local.
  - "VoiceServer"  : le serveur de reconnaissance vocale local (Vosk).

NE LES FERMEZ PAS pendant que vous utilisez Bleep. Vous pouvez les reduire.
Elles se ferment quand vous quittez Bleep.

CONFIGURATION TWITCH
--------------------
Au premier lancement de Bleep, va dans le menu de gauche :
    "Mes Chaines Twitch" -> bouton vert "+ Ajouter une chaine"
puis clique sur le bouton violet "Connecter Twitch".

Bleep va t'afficher un code court (ex. ABCD-1234) et un bouton
"Ouvrir Twitch". Le bouton ouvre la page officielle Twitch, tu
y tapes le code, tu valides les permissions demandees, et c'est
fini. Aucun token a generer, aucun mot de passe a coller.

Permissions demandees par Bleep (Twitch les affiche au moment de
la validation) :
  - lecture / ecriture dans ton chat   (le bot parle aux viewers)
  - infos de ton compte                (identification au login)
  - liste des abonnes                  (annonces de subs)
  - lecture des actions de moderation  (ignore les bannis)
  - creation de clips                  (commande vocale -> clip)

Important : utilise le compte Twitch avec lequel tu STREAMS. C'est
ce compte que Bleep utilisera a la fois pour ecouter ton chat et
pour y poster les reponses du bot.

Si Twitch revoque le token (changement de mot de passe, expiration,
deconnexion forcee), Bleep te demandera simplement de refaire le
"Connecter Twitch". Aucune perte de config, juste une re-validation.

IMPORTANT — REDEMARRAGE APRES "CONNECTER TWITCH"
------------------------------------------------
Apres avoir connecte ou reconnecte ton compte Twitch, ferme
completement Bleep et relance-le. Ca permet au bot de charger tes
permissions a jour (notamment la moderation).

Sans ce redemarrage, le bot continue avec l'ancien token et
certaines actions peuvent ne pas s'appliquer (par exemple les
bans/timeouts qui semblent partir dans le chat mais ne sanctionnent
personne reellement).

Concretement : fenetre console "ollama serve" + "VoiceServer" +
Bleep -> tout fermer, puis double-clic sur "Lancer Bleep.bat".

MISE A JOUR
-----------
Quand Bleep vous propose une mise a jour (fenetre "Mise a jour disponible"),
telechargez le ZIP, fermez Bleep, puis extrayez le ZIP PAR-DESSUS ce dossier
en remplacant les fichiers existants. Relancez avec "Lancer Bleep.bat".

Vos donnees (compte, chaines, commandes, clips) ne sont PAS dans ce dossier :
elles sont conservees automatiquement dans votre profil Windows (voir NOTES).
N'extrayez PAS la mise a jour dans un autre dossier : vous auriez deux
installations et l'impression d'avoir perdu vos donnees.

LOGS (en cas de pepin)
----------------------
Les logs de Bleep sont ecrits dans :
    %APPDATA%\Howlgrid\Bleep\logs\
(tapez ce chemin dans la barre d'adresse de l'Explorateur Windows)

Si vous rencontrez un probleme, zippez ce dossier et envoyez-le au support.

NOTES
-----
- Aucune installation systeme. Le dossier est portable, deplacez-le ou
  vous voulez : vos donnees ne bougent pas.
- Vos donnees (compte, configs bot, licence, clips) sont stockees dans
      %APPDATA%\Howlgrid\Bleep\
- Les modeles vocaux Vosk (~80 Mo, telecharges au 1er setup) sont dans
      %LOCALAPPDATA%\Howlgrid\Bleep\vosk-models\
  Ils ne sont pas re-telecharges lors des mises a jour.
- Module vocal ACTIF dans cette version : commandes vocales (ex : "Bleep,
  clip ca") disponibles apres le 1er setup.

SUPPORT
-------
support@howlgrid.com
