Ir para o conteúdo

Primeiros passos

Instalação

Onde obter o Vukem Video, o que é cada download e como conferi-lo antes de executar.

Última atualização:

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#

  1. Abra a página de versões e baixe o instalador do seu sistema, ou o arquivo compactado da sua plataforma.
  2. Instale. O instalador adiciona o vukem-video ao seu path.
  3. Execute vukem-video version. Ele imprime a versão, o que mostra que o programa está instalado.
  4. Execute vukem-video serve. Ele escuta em 127.0.0.1:7878 e 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:

Terminal
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.Z

O 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_FFMPEG e VUKEM_VIDEO_FFPROBE indicam os binários explicitamente. Veja as variáveis de configuração.

Próximos passos#