Pular para o conteúdo principal
Este guia mostra como configurar fp-appimage-updater do zero: inicializar sua configuração global, escrever uma receita de app e instalar seu primeiro AppImage.
1

Inicialize a configuração global

Execute o comando init --global para criar o arquivo padrão de configuração global:
Isso cria ~/.config/fp-appimage-updater/config.yml com padrões sensatos para caminhos de armazenamento, integração de desktop, downloads segmentados e mais. Abra o arquivo para revisar ou ajustar as configurações antes de continuar.
2

Crie sua primeira receita de app

Use init --app para gerar um arquivo de receita para um app. Passe --strategy para escolher a estratégia de atualização. Este exemplo usa a estratégia forge para um app hospedado no GitHub:
Isso cria ~/.config/fp-appimage-updater/apps/hydra-launcher.yml. Edite-o para corresponder ao seu repositório de destino e ao padrão do nome do arquivo do asset:
O campo asset_match é um padrão curinga correspondido contra os nomes de arquivo dos assets da release. Ajuste-o para selecionar o AppImage correto para sua arquitetura.
3

Valide a receita

Antes de buscar qualquer coisa, confirme que a receita é analisada corretamente:
Se o arquivo tiver quaisquer erros de sintaxe ou campos obrigatórios ausentes, o comando os reporta para que você possa corrigi-los antes de executar uma atualização.
4

Verifique se há atualizações

Consulte a release upstream para ver se uma nova versão está disponível:
O comando lê primeiro seu estado local, depois consulta a fonte upstream pelos metadados e compara os dois. A saída mostra a versão resolvida, se um download é necessário e quaisquer dicas de suporte, como disponibilidade de download por range.
5

Instale ou atualize o app

Baixe e instale o AppImage (e sua integração de desktop, se habilitada):
O comando segue o mesmo fluxo de verificar primeiro, depois baixa o novo AppImage apenas se necessário. Ele prefere o caminho delta integrado zsync-rs quando você tem um AppImage local e a receita o habilita, recua para HTTP segmentado ou um download normal, então marca o arquivo como executável, atualiza o symlink se habilitado, reescreve a entrada de desktop e o ícone se habilitados e, por fim, salva o novo estado.
Para exemplos de receitas do mundo real para apps populares como Obsidian, CurseForge e Sioyek, confira a pasta de exemplos oficiais no GitLab.
Para explorar todos os campos de receita e opções de estratégia disponíveis - incluindo direct (ETag/Last-Modified) e script (resolvedor personalizado) - veja a página Estratégias de atualização.
Última modificação em 17 de abril de 2026