Configurações Globais - fp-appimage-updater

O arquivo de configuração global aplica padrões a todos os apps gerenciados. Você pode sobrescrever qualquer uma dessas configurações por app dentro de uma receita de app.

Localização do arquivo

~/.config/fp-appimage-updater/config.yml

Gere um arquivo inicial com:

fp-appimage-updater init --global

Exemplo

storage_dir: ~/.local/bin/AppImages
symlink_dir: ~/.local/bin
naming_format: '{name}.AppImage'
manage_desktop_files: true
create_symlinks: false
segmented_downloads: true
show_all: false
respect_rate_limits: true
github_proxy: true
github_proxy_prefix: https://gh-proxy.com/

Campos

storage_dir

string

padrão:"~/.local/bin/AppImages"

Diretório onde os arquivos AppImage baixados são armazenados.

symlink_dir

string

padrão:"~/.local/bin"

Diretório onde symlinks para AppImages instalados são criados. Usado apenas quando create_symlinks é true.

naming_format

string

padrão:"{name}.AppImage"

Modelo de nome de arquivo para AppImages armazenados. Marcadores suportados:

{name}: Substituído pelo campo name do app em sua receita.
{version}: Substituído pela versão resolvida do app (ex: 1.2.3).

manage_desktop_files

boolean

padrão:"true"

Quando habilitado, fp-appimage-updater extrai automaticamente manifests .desktop e ícones do AppImage e os instala em ~/.local/share/applications e ~/.local/share/icons.

create_symlinks

boolean

padrão:"false"

Quando habilitado, cria um symlink em symlink_dir apontando para o AppImage instalado. Útil para colocar AppImages no seu PATH sem modificar storage_dir.

segmented_downloads

boolean

padrão:"true"

Divide downloads em requisições HTTP range paralelas quando o servidor oferece suporte. Acelera downloads grandes de AppImage em servidores capazes.

show_all

boolean

padrão:"false"

Quando habilitado, update inclui no resultado os apps que já estavam atualizados. Por padrão, só aparecem os apps que foram atualizados, ficaram em rate limit ou falharam.

respect_rate_limits

boolean

padrão:"true"

Quando habilitado, apps que atingem um limite de taxa do provedor são ignorados em execuções subsequentes até que a janela de nova tentativa expire. Defina como false para sempre tentar a requisição independentemente de um limite de taxa anterior.

github_proxy

boolean

padrão:"true"

Habilita o fallback de proxy da API do GitHub. Quando uma requisição da API de releases do GitHub é limitada por taxa, fp-appimage-updater tenta novamente por meio das bases de proxy configuradas. O download real do AppImage sempre usa a URL direta do asset do GitHub - apenas as consultas de metadados são proxificadas.

github_proxy_prefix

string | string[]

padrão:"all"

URL(s) base de proxy a usar quando github_proxy está habilitado. Aceita uma única string de URL, uma lista YAML de URLs, ou a string all para tentar cada proxy embutido em ordem.

# Proxy único
github_proxy_prefix: "https://gh-proxy.com/"

# Vários proxies tentados em ordem
github_proxy_prefix:
  - "https://gh-proxy.com/"
  - "https://corsproxy.io/?"
  - "https://api.allorigins.win/raw?url="

# Tentar todos os proxies embutidos
github_proxy_prefix: all

Sobrescritas de URL forge auto-hospedadas

Esses campos opcionais permitem apontar fp-appimage-updater para uma instância GitHub ou GitLab auto-hospedada em vez das APIs públicas.

github_release_api_url

string

Sobrescreve a URL base da API REST do GitHub. Útil quando seus apps estão hospedados no GitHub Enterprise Server.

github_release_web_url

string

Sobrescreve a URL base web do GitHub usada para construir links de página de release.

gitlab_release_api_url

string

Sobrescreve a URL base da API do GitLab. Defina isso quando seus apps estiverem em uma instância GitLab autogerenciada.

gitlab_release_web_url

string

Sobrescreve a URL base web do GitLab usada para construir links de página de release.

Cada campo em config.yml pode ser sobrescrito para um app específico dentro do arquivo de receita dele. As configurações no nível do app sempre têm precedência sobre a configuração global. Veja receitas de app para a lista completa de sobrescritas por app.

Documentation Index

​Localização do arquivo

​Exemplo

​Campos

​Sobrescritas de URL forge auto-hospedadas

Localização do arquivo

Exemplo

Campos

Sobrescritas de URL forge auto-hospedadas