InstruçõesDocumentation

Da instalação ao primeiro vídeo publicado. Dúvidas no caminho? Veja a Ajuda.

From install to your first published video. Questions along the way? See the Help.

Início rápidoQuick start

Baixe o instalador (Windows, macOS ou Linux), instale e abra o BuildAndPublish. Na primeira vez ele baixa as ferramentas de vídeo, então precisa de internet e leva um ou dois minutos.Download the installer (Windows, macOS or Linux), install it and open BuildAndPublish. The first time it downloads the video tools, so it needs internet and takes a minute or two.
Em Primeiros passos, copie o código deste computador (fingerprint), peça a licença e cole o token que aparecer na página do pedido.In Getting started, copy this computer’s code (fingerprint), ask for the license and paste the token shown on the request page.
Ali mesmo, conecte a IA e as contas. Depois registre no agente e peça o primeiro vídeo.Right there, connect the AI and your accounts. Then register with your agent and ask for your first video.

Configuração (.env)Configuration (.env)

Opcional: tudo abaixo pode ser preenchido no painel, em Primeiros passos e Configuração. O arquivo .env na pasta de dados do app (%LOCALAPPDATA%\BuildAndPublish no Windows, ~/Library/Application Support/BuildAndPublish no macOS, ~/.local/share/buildandpublish no Linux) serve para quem prefere arquivo, e o que vem nele vence o que foi salvo no painel.

Optional: everything below can be filled in on the panel, under Getting started and Settings. The .env file in the app’s data folder (%LOCALAPPDATA%\BuildAndPublish on Windows, ~/Library/Application Support/BuildAndPublish on macOS, ~/.local/share/buildandpublish on Linux) is for those who prefer a file, and what it sets wins over what was saved in the panel.

VariávelVariable	Para quêWhat for
`OPENROUTER_API_KEY`	Chave do OpenRouter (provedor padrão)OpenRouter key (default provider)
`YOUTUBE_CLIENT_ID` / `YOUTUBE_CLIENT_SECRET`	OAuth2 do YouTube (ou use `/bnp-youtube-auth`)YouTube OAuth2 (or use `/bnp-youtube-auth`)
`INSTAGRAM_APP_ID` / `INSTAGRAM_APP_SECRET`	App do Meta for Developers (ou `/bnp-instagram-auth`)Meta for Developers app (or `/bnp-instagram-auth`)
`TELEGRAM_BOT_TOKEN` / `TELEGRAM_CHAT_ID`	Avisos opcionais ao fim do pipelineOptional notices when the pipeline ends
`BNP_MAX_CONCURRENT_JOBS`	Jobs ao mesmo tempo; os demais esperam na filaSimultaneous jobs; the rest wait in the queue
`BNP_FFMPEG_MAX_CONCURRENT`	Limita o FFmpeg paralelo em máquinas pequenasCaps parallel FFmpeg on small machines
`BNP_LICENSE_KEY`	Token da licença (ou salve em `data/license.key` na pasta de dados do app)License token (or save it at `data/license.key` in the app’s data folder)

Registrar no agenteRegister with your agent

Abra o app uma vez antes: é ele que baixa as ferramentas de vídeo. O instalador põe no PATH o comando bnp, que instala os comandos /bnp-* e registra o servidor MCP no seu agente. Num terminal novo:

Open the app once first: it downloads the video tools. The installer puts the bnp command on your PATH, which installs the /bnp-* commands and registers the MCP server with your agent. In a new terminal:

bnp --install claude

Troque claude por copilot, opencode, hermes ou antigravity (ou passe vários). Para remover, bnp --uninstall claude; para ver as opções, bnp --help.

Swap claude for copilot, opencode, hermes or antigravity (or pass several). To remove, bnp --uninstall claude; to see the options, bnp --help.

Reabra o agente para as ferramentas aparecerem. Outro cliente MCP que execute um comando por STDIO? Registre bnp --mcp.

Reopen the agent so the tools show up. Another MCP client that runs a command over STDIO? Register bnp --mcp.

Comandos /bnp-/bnp- commands

A execução é assíncrona: o disparo devolve um jobId e você acompanha com /bnp-status. Sem os atalhos instalados, peça ao agente em linguagem natural: ele usa as mesmas ferramentas MCP.

Execution is asynchronous: starting returns a jobId and you follow it with /bnp-status. Without the shortcuts installed, ask the agent in plain language: it uses the same MCP tools.

ComandoCommand	FazDoes
`/bnp-youtube-video <url> <accountId>`	Gera e publica um vídeoBuilds and publishes a video
`/bnp-youtube-shorts <url> <accountId>`	Gera e publica um Shorts (vertical)Builds and publishes a Short (vertical)
`/bnp-instagram-reel <url> <accountId>`	Gera e publica um ReelBuilds and publishes a Reel
`/bnp-instagram-post <accountId> <title>`	Gera e publica um post de imagemBuilds and publishes an image post
`/bnp-multi-publish`	Gera uma vez e publica em vários destinosBuilds once, publishes to several destinations
`/bnp-status <jobId>` · `/bnp-jobs`	Andamento de um job · lista de jobsA job’s progress · list of jobs
`/bnp-youtube-auth` · `/bnp-instagram-auth`	Autenticação OAuthOAuth sign-in
`/bnp-youtube-channels` · `/bnp-youtube-cookies`	Canais disponíveis · renova os cookies do yt-dlpAvailable channels · refreshes yt-dlp cookies

Exemplo de pedidoExample request

/bnp-youtube-shorts
- Formato vertical, 10 trechos de até 90 segundos
- Smart reframe seguindo o locutor
- Thumbnail chamativa com a marca do canal
- Publicar amanhã às 12:00 no fuso do sistema
- Se faltar algum dado obrigatório, peça só o mínimo

/bnp-youtube-shorts
- Vertical format, 10 clips of up to 90 seconds
- Smart reframe following the speaker
- Eye-catching thumbnail with the channel's branding
- Publish tomorrow at 12:00 in the system time zone
- If any required info is missing, ask only for the minimum

Quando a conta tem acesso ao Analytics, o pipeline olha os conteúdos de maior audiência dos últimos 90 dias e usa os padrões nos cortes, títulos e roteiros. Se aparecer “sem acesso”, reautentique.

When the account has Analytics access, the pipeline looks at your top content from the last 90 days and uses the patterns in cuts, titles and scripts. If you see “no access”, sign in again.

Painel webWeb panel

Sobe sozinho junto com o servidor MCP em http://localhost:7420. Crie o login em Primeiro acesso e siga Primeiros passos: licença, IA (chave de um provedor ou um CLI já logado no computador, como Claude Code, OpenCode ou Antigravity) e contas. Ali você dispara pipelines em Novo pipeline, acompanha jobs em tempo real, configura contas e armazenamento, e usa Clonar e editar para repetir um job mudando só o necessário.

It starts with the MCP server at http://localhost:7420. Create your login under First access and follow Getting started: license, AI (a provider key or a CLI already logged in on the computer, such as Claude Code, OpenCode or Antigravity) and accounts. There you start pipelines in New pipeline, follow jobs live, configure accounts and storage, and use Clone and edit to repeat a job changing only what you need.

Sem login configurado, o painel recusa acessos que não sejam do próprio computador. Crie o login no próprio computador e depois acesse de outros aparelhos.

With no login configured, the panel refuses any access that doesn’t come from the machine itself. Create the login on the machine itself, then access it from other devices.

No celularOn mobile

No painel do computador, abra o botão Celular e leia o QR code (HTTPS local, com certificado próprio).On the desktop panel, open the Phone button and scan the QR code (local HTTPS, with its own certificate).
Instale o certificado como CA no aparelho e abra o endereço HTTPS.Install the certificate as a CA on the device and open the HTTPS address.
Use Instalar app para ter o painel na tela inicial (PWA).Use Install app to put the panel on your home screen (PWA).
No YouTube, toque em Compartilhar → BuildAndPublish (Android/Chrome) para criar um job a partir do link.In YouTube, tap Share → BuildAndPublish (Android/Chrome) to create a job from the link.
Ative as notificações em Mais → Notificações.Turn on notifications in More → Notifications.

Não funcionou? Veja Ajuda → celular.

Didn’t work? See Help → mobile.

LicençaLicense

Sem licença válida, o app abre só com o painel: nenhum vídeo é gerado. O fingerprint da instalação aparece em Primeiros passos (e no log). Cole o token ali, ou informe por BNP_LICENSE_KEY, ou salve em data/license.key na pasta de dados do app. O token colado no painel vale sem reiniciar.

Without a valid license, the app opens with the panel only: no video is generated. The installation fingerprint shows in Getting started (and in the log). Paste the token there, or provide it through BNP_LICENSE_KEY, or save it at data/license.key in the app’s data folder. A token pasted in the panel works without a restart.

A licença vale só nesta instalação (reinstalar mantém a licença se a pasta de dados do app for preservada). O app precisa alcançar a internet ao menos uma vez a cada 14 dias para renovar o status da licença. O painel mostra o estado atual da licença.

The license only works on this installation (reinstalling keeps the license as long as the app’s data folder is kept). The app needs internet access at least once every 14 days to renew the license status. The panel shows the current license state.