O que você vai aprender#
- qual arquivo baixar para o seu sistema, ou como executar a imagem de contêiner;
- como iniciar o servidor e onde ele escuta;
- como conferir um download antes de executá-lo.
A ideia#
O Vukem Video roda apenas no seu computador. Você instala um único programa, o vukem-video. Ele serve o editor no navegador, o servidor MCP, a CLI e a API HTTP a partir do mesmo processo e do mesmo espaço de trabalho.
Início rápido#
- Abra a página de versões e baixe o instalador do seu sistema, ou o arquivo compactado da sua plataforma.
- Instale. O instalador adiciona o
vukem-videoao seu path. - Execute
vukem-video version. Ele imprime a versão, o que mostra que o programa está instalado. - Execute
vukem-video serve. Ele escuta em127.0.0.1:7878e em nenhum outro lugar.
A imagem de contêiner#
Toda versão estável também publica uma imagem multiarquitetura com o FFmpeg LGPL fixado dentro, em dois registros com o mesmo digest: ghcr.io/alexgalhardo/vukem-video e alexgalhardo/vukem-video no Docker Hub. As tags são X.Y.Z, X.Y e latest. O espaço de trabalho fica no volume /data, então mantenha-o em um volume nomeado ou em uma pasta de sua escolha:
docker run --rm -p 127.0.0.1:7878:7878 -v vukem-video:/data \
-e APP_KEY="$(openssl rand -base64 32)" \
ghcr.io/alexgalhardo/vukem-video:X.Y.ZO contêiner roda como o usuário app (uid 10001) e, por padrão, não envia dados para lugar nenhum. docker run --rm ghcr.io/alexgalhardo/vukem-video:X.Y.Z version imprime a versão.
Para compilar a partir do código-fonte, você precisa do Go (a versão do go.mod) e do Bun para o front-end.
O aplicativo desktop#
Uma versão que traz o aplicativo desktop lista um arquivo por sistema ao lado dos outros instaladores: vukem-video-desktop_X.Y.Z_windows_amd64_setup.exe para o Windows 11, vukem-video-desktop_X.Y.Z_darwin_arm64.dmg (Apple silicon) ou ..._darwin_amd64.dmg (Intel) para o macOS e vukem-video-desktop_X.Y.Z_linux_amd64.deb para Debian e Ubuntu. Cada um contém a janela e o servidor que ela inicia. A página do aplicativo desktop explica o que ele faz.
Os instaladores do BETA sem assinatura#
Nenhum instalador é assinado com um certificado pago: no BETA não há Apple Developer ID, nem notarização, nem certificado de assinatura de código do Windows. Por isso o Windows e o macOS avisam antes da primeira execução. Isso é esperado; o que prova que o arquivo é genuíno é o checksum e a assinatura da versão, que você pode verificar.
- Windows. O SmartScreen mostra "O Windows protegeu seu PC". Escolha Mais informações e depois Executar assim mesmo.
- macOS. O Gatekeeper diz que o app não pode ser aberto porque a Apple não consegue verificá-lo. Clique com o botão direito (ou com Control) no app, escolha Abrir e depois Abrir de novo. Ou remova a marca de quarentena em um terminal:
xattr -d com.apple.quarantine "/Applications/Vukem Video.app". - Debian e Ubuntu. Sem aviso. Instale com
sudo apt install ./vukem-video-desktop_X.Y.Z_linux_amd64.deb.
Erros comuns#
- O sistema avisa antes da primeira execução. Os instaladores não são assinados com um certificado pago; veja Os instaladores do BETA sem assinatura acima para as etapas do SmartScreen e do Gatekeeper e, se quiser uma prova, verifique o download antes.
- O FFmpeg não é encontrado. O editor usa o seu FFmpeg, e
VUKEM_VIDEO_FFMPEGeVUKEM_VIDEO_FFPROBEindicam os binários explicitamente. Veja as variáveis de configuração.