Maak kennis met de Mave CLI

Soms heb je een video klaar om te uploaden en staat je terminal al open. Je hebt bijvoorbeeld net een productdemo gerenderd, of je werkt aan een website en wilt even zien welke video’s beschikbaar zijn.

Met onze API kun je zulke taken in je eigen tools inbouwen. Maar voor een snelle upload of een lijst met video’s is het schrijven van requests en regelen van authenticatie best wat voorbereiding.

Daarom hebben we de Mave CLI gebouwd. Daarmee kun je video’s uploaden, collecties beheren en je Mave-bibliotheek gebruiken, direct vanuit je terminal.

Van bestand naar afspeelbare video

Installeer de CLI met Homebrew op macOS of Linux en koppel je account:

brew install maveio/tap/mave
mave login

Bij het inloggen opent je browser en kies je de Mave-space die je wilt koppelen. De CLI slaat je login lokaal op, zodat je de volgende keer meteen verder kunt.

Een video uploaden kan met één commando:

mave videos upload ./product-demo.mp4 --wait

De CLI toont de voortgang en wacht totdat de video afspeelbaar is. Je kunt ook de URL van een videobestand opgeven.

Met mave videos list --format table bekijk je je videobibliotheek. Vanuit dezelfde terminal kun je collecties aanmaken, video’s verplaatsen en titels wijzigen.

Handig voor AI-assistenten

De CLI is ook bijzonder geschikt voor AI-assistenten die terminalcommando’s kunnen uitvoeren. In plaats van een script rond API-endpoints te schrijven, kan een assistent mave --help lezen en direct de beschikbare commando’s gebruiken.

Je kunt bijvoorbeeld vragen:

Maak een collectie met de naam “Productdemo’s” en upload de video’s uit deze map naar die collectie.

De assistent kan met de CLI de collectie aanmaken, de bestanden uploaden en de resultaten controleren. Commando’s geven standaard JSON terug, waardoor ID’s en statussen makkelijk in een volgende stap te gebruiken zijn. Wil je zelf de resultaten bekijken, dan geeft --format table een leesbaar overzicht.

Diezelfde JSON-uitvoer is natuurlijk ook handig voor je eigen scripts en geautomatiseerde workflows.

Je Vimeo-bibliotheek meenemen

We introduceren ook een Vimeo-importer die video’s overzet met behoud van hun titels en mappenstructuur.

Deze functie is experimenteel.

mave import vimeo

De CLI helpt je een Vimeo access token aan te maken en bewaart dit voor volgende imports. Video’s overzetten vereist een Vimeo-abonnement met API-toegang tot videobestanden.

Je kunt een map selecteren, een import bekijken met --dry-run of een onderbroken import hervatten met --resume. In de CLI-documentatie lees je hoe je begint.

Probeer het uit

De CLI is open source op GitHub. In onze documentatie vind je de installatie en praktische voorbeelden. Met mave --help bekijk je alle beschikbare commando’s.

We horen graag hoe je de CLI gebruikt. Deel wat je bouwt in onze Discord, of stuur ons een e-mail.