Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

🎬 ThumbForge Studio

Le Radar de marché YouTube : scanne un sujet dans 36 marchés, classe les vidéos dans l'ordre de pertinence de YouTube, repère les 🔥 outliers et découpe les miniatures qui marchent.

  • 💰 100 % gratuit — aucune clé API, aucun compte, aucun abonnement
  • 🔒 Tout en local — tes projets et caches restent sur ton PC (data/store.json)
  • 🪟🐧🍎 Windows, macOS et Linux

⚡ Installation rapide (30 secondes)

Option A — Windows (le plus simple)

  1. Télécharge le ZIP : bouton vert Code ▾ → Download ZIP en haut de cette page (ou ThumbForge-Studio.zip dans les fichiers ci-dessus).
  2. Extrais le dossier ThumbForge-Studio où tu veux.
  3. Double-clique sur demarrer.bat. La première fois, il installe tout seul les dépendances (~1 min) puis ouvre l'app dans ton navigateur.

Option B — macOS / Linux

# Télécharge et décompresse le ZIP ci-dessus, puis :
cd ThumbForge-Studio
chmod +x demarrer.sh
./demarrer.sh

Option C — ligne de commande (copier-coller, Windows/macOS/Linux)

git clone <URL-DU-DEPOT>
cd ThumbForge-Studio
python -m venv .venv
# Windows :
.venv\Scripts\python -m pip install -r requirements.txt
.venv\Scripts\python launch.py
# macOS / Linux :
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python launch.py

L'app s'ouvre sur http://127.0.0.1:8123 (port libre choisi automatiquement si occupé). Pour arrêter : Ctrl+C dans la fenêtre.

🎁 Un projet Démo est inclus dans le ZIP : tu peux explorer tous les onglets immédiatement, sans rien scanner.


🧭 Ce que fait l'app

Onglet Rôle
🛰 Radar Tu tapes ton sujet → il est traduit dans les marchés choisis, scanné sur YouTube avec les vraies formulations tapées (autosuggest) et classé dans l'ordre de pertinence natif de YouTube, pas par vues. Filtres : 🔥 outliers, tris, épingle.
🎨 Miniatures & palettes Décodage des miniatures des références (couleurs, éléments, composition) pour comprendre ce qui fait cliquer.
🔥 Analyser base & abonnés Compare chaque vidéo à la normale de sa chaîne (vue de base = médiane des ~80 dernières vidéos + abonnés) → repère les vrais cartons (≥ 3× la base).
🔎 Décortiquer Deep dive d'une vidéo : vélocité (vues/jour), likes, tags, chapitres, hameçon du début de vidéo.
🧪 Titres & SEO Mots-clés dominants du marché, formules gagnantes, générateur de titres.
🚀 Lancement Plan de publication + suivi J7 (CTR %) / J14 (rétention).
Export Brief HTML prêt à lire ou JSON réutilisable.

Pourquoi « comme YouTube » ? La recherche YouTube classe par pertinence (métadonnées, sens), pas par vues — et ce classement est calculé par une IA qu'on ne peut pas copier. ThumbForge réutilise donc l'ordre exact dans lequel YouTube renvoie les résultats pour la formulation tapée dans chaque marché : la liste affichée est la référence de pertinence, sans réinventer un tri maison.


🔒 Transparence & sécurité

  • Aucune clé API : tout passe par yt-dlp (recherche, abonnés, historique de vues, sous-titres), les miniatures publiques i.ytimg.com et l'autosuggest public Google.
  • Rien n'est envoyé ailleurs : tes données restent en local (data/store.json, caches dans _cache/).
  • Le ZIP est inspectable : lis demarrer.bat, launch.py, app.py, engine.py avant de lancer. Rien de masqué.
  • Internet n'est nécessaire que pour les scans (YouTube public). Le reste est 100 % local.

Vérification rapide (avant de lancer, pour les curieux)

# Windows
.venv\Scripts\python -c "import app, engine; print('modules OK')"
# macOS / Linux
.venv/bin/python -c "import app, engine; print('modules OK')"

✨ Astuce pertinence max (optionnel, gratuit)

Installe le re-rank sémantique multilingue pour que ThumbForge compare aussi le sens des titres au sujet (détecte les synonymes, 100 % local) :

# Windows
.venv\Scripts\python -m pip install -r requirements-sem.txt
# macOS / Linux
.venv/bin/python -m pip install -r requirements-sem.txt

Au 1er scan, un petit modèle (~220 Mo) est téléchargé une fois dans _cache/models. Sans lui, l'outil fonctionne aussi (repli sur mots-clés + classement YouTube).


🩺 Dépannage rapide

Problème Solution
« Python introuvable » Installe Python sur python.org ⚠️ en cochant « Add python.exe to PATH »
La 1re installation échoue Vérifie ta connexion ; supprime le dossier .venv puis relance demarrer.bat
Le scan ne renvoie rien Vérifie internet, relance le scan
YouTube a changé Mise à jour yt-dlp : .venv\Scripts\python -m pip install -U yt-dlp
Port occupé Géré automatiquement : un port libre est choisi

ThumbForge Studio — gratuit, sans clé, pensé pour les créateurs qui veulent chercher comme YouTube, pas deviner.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors