> ## 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.

# Configuração e Geração

> Inicialize a configuração global ou gere uma nova receita de app.

O comando `init` cria arquivos iniciais para que você tenha um ponto de partida funcional sem escrever YAML do zero.

## Inicialize a configuração global

```bash theme={null}
fp-appimage-updater init --global
```

Cria `~/.config/fp-appimage-updater/config.yml` com padrões sensatos. Execute isso uma vez antes de adicionar quaisquer receitas de app.

## Gere uma receita de app

```bash theme={null}
fp-appimage-updater init --app <name> --strategy <direct|forge|script>
```

Cria um arquivo de receita em `~/.config/fp-appimage-updater/apps/` para o app nomeado, já preenchido para a estratégia de atualização escolhida.

### Flags

<ParamField query="--app <name>" type="string">
  Nome do app a ser gerado. O arquivo resultante é colocado em `~/.config/fp-appimage-updater/apps/<name>.yml`.
</ParamField>

<ParamField query="--strategy <direct|forge|script>" type="string" default="direct">
  Estratégia de atualização a ser usada para a receita gerada.

  * `direct` — URL estática verificada via cabeçalhos ETag ou Last-Modified
  * `forge` — asset de release do GitHub ou GitLab
  * `script` — script shell personalizado que produz a URL de download e a versão
</ParamField>

<ParamField query="--force" type="boolean">
  Sobrescreve um arquivo existente. Sem essa flag, `init` não substituirá um arquivo que já exista.
</ParamField>

<ParamField query="--global" type="boolean">
  Inicializa o `config.yml` global em vez de gerar uma receita de app.
</ParamField>

## Exemplos

<CodeGroup>
  ```bash forge strategy theme={null}
  fp-appimage-updater init --app hydra-launcher --strategy forge
  ```

  ```bash direct strategy theme={null}
  fp-appimage-updater init --app whatpulse --strategy direct
  ```

  ```bash script strategy theme={null}
  fp-appimage-updater init --app hayase --strategy script
  ```
</CodeGroup>

<Tip>
  O arquivo gerado é um ponto de partida. Abra-o e preencha a URL de download real, o caminho do repositório ou o padrão do asset para o seu app antes de executar `check` ou `update`.
</Tip>