> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fau.fpt.icu/llms.txt
> Use this file to discover all available pages before exploring further.

# Comandos Principais

> Verifique se há atualizações disponíveis e instale-as.

## validate

```bash theme={null}
fp-appimage-updater validate [app-name]
```

Analisa todos os arquivos de receita (ou um único nomeado) e reporta quais arquivos são válidos e quais contêm erros. Execute isso depois de editar uma receita para pegar erros de YAML antes que afetem `check` ou `update`.

```bash theme={null}
# Validar todas as receitas
fp-appimage-updater validate

# Validar uma única receita
fp-appimage-updater validate whatpulse
```

## check

```bash theme={null}
fp-appimage-updater check [app-name]
```

Conecta-se à fonte de atualização configurada de cada app e a compara com a versão registrada localmente. Nenhum arquivo é baixado ou alterado.

A saída inclui:

* Se uma nova versão está disponível
* A versão, ETag ou metadados Last-Modified usados para comparação
* Dicas de suporte, como suporte a HTTP range para downloads segmentados

### Exemplos

<CodeGroup>
  ```bash Todos os apps theme={null}
  # Verificar todos os apps configurados
  fp-appimage-updater check
  ```

  ```bash App único theme={null}
  # Verificar um único app
  fp-appimage-updater check whatpulse
  ```

  ```bash Saída JSON theme={null}
  # Verificar todos os apps e formatar a saída com jq
  fp-appimage-updater --json check | jq
  ```
</CodeGroup>

## update

```bash theme={null}
fp-appimage-updater update [app-name]
```

Baixa e instala atualizações para todos os apps configurados, ou para um único app nomeado. Por padrão, a saída mostra apenas os apps que foram realmente atualizados, ficaram limitados por rate limit ou falharam. Use `--show-all` ou defina `show_all: true` no `config.yml` para voltar ao comportamento antigo e verboso, que também lista os apps que já estavam atualizados. Cada atualização bem-sucedida reporta o tempo decorrido para que você possa ver quanto tempo cada app levou.

Se um rate-limit foi atingido em uma execução anterior, o app afetado é pulado até a janela de retry expirar - a menos que `respect_rate_limits` esteja desativado globalmente ou para esse app.

### Exemplos

<CodeGroup>
  ```bash Todos os apps theme={null}
  # Atualizar todos os apps
  fp-appimage-updater update
  ```

  ```bash App único theme={null}
  # Atualizar um único app
  fp-appimage-updater update hydra-launcher
  ```

  ```bash Com self-update theme={null}
  # Atualizar todos os apps e depois atualizar o próprio atualizador
  fp-appimage-updater update --self-update
  ```

  ```bash JSON e jq theme={null}
  # Atualizar um app e verificar se ele foi realmente atualizado
  fp-appimage-updater --json update whatpulse | jq '.[0].is_updated'
  ```
</CodeGroup>

### Flags

<ParamField query="--self-update" type="boolean">
  Atualiza também o binário `fp-appimage-updater` em si depois de terminar as atualizações dos apps.
</ParamField>

<ParamField query="--debug-download-url <URL>" type="string">
  **Apenas debug**: Força uma URL de download específica para a atualização, ignorando o resolvedor. Requer `app-name`.
</ParamField>

<ParamField query="--debug-version <VER>" type="string">
  **Apenas debug**: Força uma string de versão específica para a atualização, ignorando o resolvedor. Requer `app-name`.
</ParamField>

<ParamField query="--show-all" type="boolean">
  Mostra todos os apps nos resultados da atualização, incluindo os que já estavam atualizados.
</ParamField>

<Note>
  Tanto `check` quanto `update` executam vários apps concorrentemente. Um limite ciente do provedor limita quantas requisições vão para o mesmo host ao mesmo tempo, para que um lote grande permaneça rápido sem sobrecarregar um único servidor.
</Note>

## doctor

```bash theme={null}
fp-appimage-updater doctor
```

Executa uma verificação de saúde local sem contatar nenhum servidor remoto. Ele verifica:

* Se o diretório de configuração existe e é legível
* Se o diretório de apps está presente
* Se o `config.yml` global pode ser analisado
* Se o diretório de estado está acessível
* Se o lock de processo está ausente, ativo ou obsoleto
* Se os arquivos de receita podem ser analisados com sucesso
* Se os pré-requisitos locais de atualização parecem corretos

Use `doctor` quando `check` ou `update` se comportarem de forma inesperada para descartar problemas de configuração local.
