Référence

CLI, MCP et Raccourcis

Pilotez ZumCast depuis Terminal, un assistant IA comme Claude, Siri ou l’app Raccourcis.

Installer la commande

Dans Réglages › Général › Ligne de commande et agents IA, cliquez sur Installer la commande zumcast… et saisissez le mot de passe de votre Mac. Puis, dans Terminal :

zumcast list --json

Commandes

zumcast record start [--window <app>] [--camera] [--mic]
zumcast record stop | pause | resume | discard
zumcast list [--json]
zumcast info <project>
zumcast export <project> [--format mp4|mov|gif] [--codec h264|hevc]
               [--height 1080] [--fps 60] [--aspect 16:9|9:16|1:1|4:5|4:3]
               [--version <name>|--all] [--brand <kit|default>] [--out <path>]
zumcast guide <project> [--format markdown|html|pdf|interactive]
zumcast captions <project> [--vtt]
zumcast zoom regenerate <project>
zumcast zumi <project|shot> "cut the pauses" [--apply] [--json]
zumcast polish <project> [--apply]
zumcast brand list
zumcast shot take [--mode area|window|display|scrolling]
zumcast shot export <shot> [--format png|jpeg|pdf] [--scale 1|2]
zumcast shot web <url> [--width mobile|tablet|desktop|1440] [--dark] [--full]
zumcast search "pricing page" [--kind shot|recording] [--limit 10]
zumcast run <script.json>

Ajoutez --json pour obtenir une sortie lisible par des scripts. Les limites de l’offre gratuite s’appliquent aussi en ligne de commande.

Connecter un assistant IA (MCP)

ZumCast inclut un serveur MCP : des assistants comme Claude peuvent enregistrer, monter avec Zumi, prendre des captures et exporter, le tout sur votre Mac.

  1. Dans Réglages › Général, cliquez sur Copier la configuration MCP.
  2. Collez-la dans les réglages MCP de votre assistant (par exemple le fichier de configuration de Claude Desktop). Elle ressemble à ceci :
{
  "mcpServers": {
    "zumcast": {
      "command": "/Applications/Zumcast.app/Contents/SharedSupport/zumcast",
      "args": ["mcp"]
    }
  }
}

Les outils couvrent les projets et l’enregistrement (list_projects, search, start_recording, stop_recording), Zumi (zumi_plan, zumi_apply), les exportations (export_video, export_all, polish, export_captions), les guides et transcriptions, les zooms, les captures (shot_take, shot_web, shot_render) et les préréglages.

Vous gardez le contrôle

  • Chaque fois que la ligne de commande, un assistant, Raccourcis ou un lien prend une capture ou lance un enregistrement, un avis s’affiche à l’écran, comme « Capture d’écran prise par Claude (MCP) ». Il n’apparaît jamais dans la capture. Désactivez-le dans Réglages › Général.
  • Les liens zumcast:// non signés demandent d’abord « Autoriser cette demande ? ».
  • Les assistants ne peuvent faire des recherches dans votre bibliothèque que si vous l’autorisez dans Réglages › Organiser.

Scripts d’enregistrement

Un script d’enregistrement est un fichier JSON d’étapes (open, wait, click, hover, type, key, scroll) que ZumCast exécute pendant l’enregistrement, pour qu’une démo soit identique à chaque fois. Lancez-en un avec Fichier › Exécuter un script…, zumcast run ou l’outil MCP run_script.

Siri et Raccourcis

ZumCast ajoute des actions à l’app Raccourcis : Prendre une capture d’écran (zone, fenêtre ou écran), Capturer du texte, Démarrer l’enregistrement, Arrêter l’enregistrement et Ouvrir le Hub. Vous pouvez aussi dire à Siri « Prendre une capture d’écran avec ZumCast » ou « Démarrer l’enregistrement avec ZumCast ».