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

# Formulae Applicationum

> Define applicationes tuas cum formulis YAML quas fp-appimage-updater ad administrandum et renovare adhibet.

Formula est fasciculus YAML qui dicit fp-appimage-updater omnia quae scire debet de applicatione: quomodo nominatur, quomodo renovationes invenire et quomodo installare. Scribis unicam formulam per applicationem, facis commit eam in dotfiles tuis, et fp-appimage-updater de reliquo curat.

## Ubi formulae manent

Pone fasciculos formulae intra `~/.config/fp-appimage-updater/apps/`. Quilibet fasciculus potest esse `.yml` planus in gradu superiori, vel subdirectorium continens fasciculum formulae et quaelibet scripta auxiliaria.

```
~/.config/fp-appimage-updater/
├── config.yml
└── apps/
    ├── hydra-launcher.yml
    └── hayase/
        ├── hayase.yml
        └── resolver.sh
```

<Tip>
  Utere subdirectorio cum applicatio tua indiget scripto personali `resolver.sh` pro [strategia script](/la/configuration/update-strategies). Pone formulam et scriptum simul in subdirectorio ut `script_path` maneat via relativa munda ut `./resolver.sh`.
</Tip>

## Campi

<ParamField path="name" type="string" required>
  Identificator unicus pro applicatione. Adhibetur ut basis nominis fasciculi, nominis symlink et nominis ostentationis in exitu CLI. Debet esse unicus inter omnes formulas tuas.
</ParamField>

<ParamField path="strategy" type="object" required>
  Definit quomodo fp-appimage-updater renovationes invenit et dēscribit. Vide [strategias renovationis](/la/configuration/update-strategies) pro referentia completa et exemplis.
</ParamField>

<ParamField path="ignore" type="boolean">
  Praetermittit hanc formulam in `check` et `update`, et eam ut ignoratam in `list` ostendit. Hoc utile est cum formulam in configuratione servare vis, sed fp-appimage-updater eam tangere non vis.
</ParamField>

<ParamField path="integration" type="boolean">
  Superat configurationem globalem `manage_desktop_files` pro hac applicatione. Pone ad `false` ad omittendam extractionem fasciculorum `.desktop` et iconum pro applicationibus quae manifestum desktopi AppImage idoneum non mittunt.
</ParamField>

<ParamField path="create_symlink" type="boolean">
  Superat configurationem globalem `create_symlinks` pro hac applicatione.
</ParamField>

<ParamField path="segmented_downloads" type="boolean">
  Superat configurationem globalem `segmented_downloads` pro hac applicatione. Pone ad `false` pro servitoribus qui petitiones HTTP range non sustinent.
</ParamField>

<ParamField path="respect_rate_limits" type="boolean">
  Superat configurationem globalem `respect_rate_limits` pro hac applicatione. Cum ponitur ad `false`, fp-appimage-updater semper temptat petitionem etiamsi fenestra prior limitis rate nondum exspiraverit.
</ParamField>

<ParamField path="github_proxy" type="boolean">
  Superat configurationem globalem `github_proxy` pro hac applicatione.
</ParamField>

<ParamField path="github_proxy_prefix" type="string | string[]">
  Superat configurationem globalem `github_proxy_prefix` pro hac applicatione. Accipit unicam stringam URL, enumerationem URLium vel `all`.
</ParamField>

<ParamField path="storage_dir" type="string">
  Superat `storage_dir` globalem pro hac applicatione. Fasciculus AppImage reponitur in hoc directorio loco defaltae globalis.
</ParamField>

<ParamField path="naming_format" type="string">
  Superat `naming_format` globalem pro hac applicatione. Loca-tenentes fulti: `{name}` et `{version}`.
</ParamField>

<ParamField path="inner_asset_match" type="string">
  Formula optionalis ad inveniendam AppImage specificam intra archivum `.zip`. Si omittitur, renovator automatice invenit fasciculos in `.AppImage` desinentes aut magic bytes ELF continentes.
</ParamField>

<ParamField path="zsync" type="boolean | string">
  Habilitat downloads delta zsync pro hac applicatione. Pone ad `true` ut fp-appimage-updater URL zsync automatice detegat, vel praebe stringam URL zsync directam ad utendum endpoint specificum.

  ```yaml theme={null}
  # Auto-detecta URL zsync
  zsync: true

  # URL zsync explicita
  zsync: "https://example.com/app.AppImage.zsync"
  ```

  Adhibet backend integrum `zsync-rs`, ita nullum packetum systematis `zsync` separatum necessarium est.
</ParamField>

## Exempla

<CodeGroup>
  ```yaml hydra-launcher.yml theme={null}
  name: hydra-launcher
  strategy:
    strategy: forge
    repository: https://github.com/hydralauncher/hydra
    asset_match: "hydralauncher-*.AppImage"
  ```

  ```yaml whatpulse.yml theme={null}
  name: whatpulse
  ignore: true
  strategy:
    strategy: direct
    url: "https://releases.whatpulse.org/latest/linux/whatpulse-linux-latest_amd64.AppImage"
    check_method: etag
  segmented_downloads: true
  ```
</CodeGroup>

### Formula Provecta

Hoc exemplum ostendit formulam pluribus superationibus utentem ad personalizandum repositorium, nominationem et modum dēscribendi:

```yaml curseforge.yml theme={null}
name: curseforge
storage_dir: ~/Games/AppImages
naming_format: "CurseForge-{version}.AppImage"
create_symlink: true
segmented_downloads: false
zsync: true
strategy:
  strategy: direct
  url: "https://curseforge.overwolf.com/downloads/curseforge-latest-linux.AppImage"
  check_method: last-modified
```

Genera skeletonem formulae pro nova applicatione cum:

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

Utere `--force` ad superandum fasciculum formulae existentem.