Prosey

Prosey est un outil CLI pour télécharger et afficher les transcriptions vidéo de YouTube, afin que vous puissiez obtenir l'information que vous cherchez sans perdre des heures.

Les principaux cas d'utilisation sont :

• Résumer une vidéo YouTube et l'afficher dans le CLI avec une seule commande (plus rapide).
• Lire les sous-titres de la vidéo, formatés et organisés en chapitres comme la vidéo originale (nécessite souvent plus de temps).

Les deux utilisations nécessitent un assistant IA sur votre système (par défaut : opencode, utilisez prosey config pour configurer le vôtre).

Si nous détectons un surligneur de syntaxe sur votre système, vous obtiendrez un joli affichage coloré.

Prosey peut également afficher ou stocker le format JSON natif tel quel.

Fonctionnalités

Démarrage rapide

Essayez-le immédiatement avec npx :

npx @tacone/prosey 771PQEDeRmw
npx @tacone/prosey https://youtu.be/771PQEDeRmw --lang es -o transcript.txt

Installer

Installez globalement avec votre gestionnaire de paquets préféré :

npm install -g @tacone/prosey
# ou
yarn global add @tacone/prosey
# ou
pnpm add -g @tacone/prosey
# ou
bun install -g @tacone/prosey

Ensuite, utilisez-le n'importe où :

prosey 771PQEDeRmw

À partir des sources

Utilise Bun pour le développement — scripts, gestion de paquets et exécution du code source TypeScript directement.

git clone https://github.com/tacone/prosey.git
cd prosey
bun install
bun run start -- 771PQEDeRmw

Utilisation

prosey [options] <video controls-url-or-id>
prosey read [options] <video controls-url-or-id>
prosey info [options] <video controls-url-or-id>
prosey summarize [options] <video controls-url-or-id>
prosey config
prosey help

summarize est la commande par défaut, donc prosey <id> exécute le résumé IA. Utilisez prosey read <id> pour télécharger et afficher une transcription richement formatée.

La commande summarize récupère une transcription, ajoute l'invite de la section [summarize] de la configuration, et envoie le résultat à la commande IA configurée.

La commande read télécharge la transcription et l'affiche sur stdout (texte brut, markdown ou JSON). Utile lorsque vous n'avez pas besoin de traitement IA.

La commande info affiche les métadonnées de la vidéo (titre, chaîne, durée, vues).

La commande config ouvre votre fichier de configuration dans $EDITOR pour modification. Si $EDITOR n'est pas défini, le chemin du fichier de configuration est affiché.

La commande help affiche le message d'aide, identique à --help.

Exemples

# Résumé (résumé IA + formatage + surlignage syntaxique)
prosey 771PQEDeRmw

# Résumé (identique ci-dessus)
prosey summarize 771PQEDeRmw

# Transcription (résumé IA + formatage + surlignage syntaxique)
prosey read 771PQEDeRmw

# Afficher les métadonnées de la vidéo
prosey info 771PQEDeRmw

# Modifier la configuration dans $EDITOR
prosey config

# Lister les langues disponibles
prosey read https://youtu.be/771PQEDeRmw --list

# Spécifier la langue
prosey read https://youtu.be/771PQEDeRmw --lang es

# Afficher au format JSON (pas de transcription IA)
prosey read 771PQEDeRmw

# Afficher en texte brut (pas de transcription IA)
prosey read 771PQEDeRmw

# Sauvegarder la transcription dans un fichier
prosey read 771PQEDeRmw -o transcript.txt

Options

Format JSON

Avec --json, la sortie est un tableau d'objets :

[
  {
    "text": "♪ We're no strangers to love ♪",
    "offset": 18.64,
    "duration": 3.24,
    "timestamp": "00:18"
  }
]

timestamp est toujours présent en mode JSON. Les détails de la vidéo sont supprimés (silencieusement) car JSON est des données structurées.

Développement

Ce projet utilise Bun pour le développement.

bun run typecheck   # Vérification TypeScript
bun run start       # Exécute le CLI à partir des sources
bun run test        # Exécute les tests unitaires
bun run build       # Compile le bundle Node dans bin/prosey

Avant la publication sur npm, bun run build s'exécute automatiquement via le hook prepack, produisant un bundle JS compatible Node dans bin/prosey.

Configuration

Prosey lit la configuration depuis un fichier TOML. L'emplacement suit la spécification XDG Base Directory (~/.config/prosey/config.toml), ou vous pouvez définir la variable d'environnement PROSEY_CONFIG_PATH pour utiliser un chemin personnalisé.

Le fichier de configuration est créé automatiquement au premier lancement avec des valeurs par défaut. Utilisez --reset-config pour restaurer les valeurs par défaut à tout moment.

pager

Commande du pagineur pour l'affichage des transcriptions et résumés. Par défaut "auto", qui détecte le premier disponible parmi : bat -lmd --style plain → glow -p → mdcat -l -p → less. Définissez une commande personnalisée (ex. "less -R") pour remplacer. La variable d'environnement PROSEY_PAGER a priorité sur ce paramètre.

[summarize]

La section [summarize] configure la commande summarize :

PROSEY_PAGER

Variable d'environnement pour définir la commande du pagineur. A priorité sur la valeur de configuration pager. Définissez sur "auto" ou vide pour utiliser la détection automatique.

Cache

Les transcriptions et résumés sont mis en cache dans /tmp/prosey/. Les appels répétés pour une même vidéo et les mêmes options sont instantanés et fonctionnent hors ligne. Utilisez --no-cache pour ignorer le cache et forcer un nouveau téléchargement.

Lorsque vous exécutez prosey summarize, la commande s'exécute dans le répertoire de cache de cette vidéo. Cela empêche l'agent IA de prendre en compte des fichiers spécifiques au projet comme AGENTS.md ou CLAUDE.md du dossier actuel, et limite sa capacité à modifier des fichiers en dehors de ce répertoire.

Codes de sortie

Comment ça fonctionne

Prosey utilise l'API Innertube de YouTube via la bibliothèque youtube-transcript-plus. Aucune clé API ou automatisation de navigateur requise.

L'outil fonctionne à la fois avec les sous-titres créés manuellement et les transcriptions générées automatiquement (reconnaissance vocale de YouTube). La détection automatique parcourt les langues dans l'ordre fourni par la réponse du lecteur YouTube.