# gt: General Translation CLI tool: Lottie
URL: https://generaltranslation.com/es/docs/cli/reference/formats/lottie-files.mdx
---

title: Lottie
description: Traduce archivos de animación dotLottie con la CLI de General Translation. Referencia de la API para el formato de archivo Lottie.

---

La CLI traduce el texto de archivos de animación binarios dotLottie (`.lottie`) y guarda cada resultado como un archivo `.lottie` completo. Los trabajos de Lottie incluyen una fase asíncrona de Procesamiento de diseño, por lo que utilizan el flujo de trabajo dividido de preparación y descarga.

## Configuración [#config]

Agrega una entrada `lottie` en `files` con un array `include` de patrones glob. Usa el marcador de posición `[locale]` para que la CLI pueda encontrar las animaciones de origen y guardar los archivos traducidos en cada configuración regional de destino.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "files": {
    "lottie": {
      "include": ["animations/[locale]/**/*.lottie"],
      "exclude": ["animations/[locale]/drafts/**"]
    }
  }
}
```

Con esta configuración, las animaciones de origen se obtienen de `animations/en/` y las traducidas se guardan en `animations/es/` y `animations/fr/`. Consulta la [referencia de configuración](/docs/cli/reference/config#files) para ver las claves de archivo compartidas.

## Flujo de trabajo de traducción [#workflow]

Ejecuta [`gt stage`](/docs/cli/reference/commands/stage) para enviar las animaciones y luego ejecuta [`gt download`](/docs/cli/reference/commands/download) hasta que todas las configuraciones regionales estén listas:

```bash
npx gt stage
npx gt download
```

Las traducciones que aún se están procesando se omiten. Vuelve a ejecutar [`gt download`](/docs/cli/reference/commands/download) más tarde para descargarlas; la entrada preparada permanece en `gt-lock.json` hasta que se descarguen todas las configuraciones regionales configuradas.

[`gt translate`](/docs/cli/reference/commands/translate) no puede completar un trabajo de Lottie no preparado en una sola ejecución. Cuando `stageTranslations` es `false` y la configuración incluye archivos Lottie, finaliza indicando que uses [`gt stage`](/docs/cli/reference/commands/stage) y [`gt download`](/docs/cli/reference/commands/download).

## Expresiones [#expressions]

Los archivos Lottie con expresiones de After Effects se rechazan porque contienen JavaScript ejecutable. Vuelve a exportar la animación con las expresiones eliminadas o convertidas en fotogramas clave y luego vuelve a prepararla.

## Fuentes [#fonts]

Agrega una configuración [`fonts`](/docs/cli/reference/config#fonts) de nivel superior cuando una animación use fuentes que podrían no estar disponibles durante el Procesamiento de diseño:

```json title="gt.config.json"
{
  "fonts": {
    "include": ["public/fonts/**/*.{ttf,otf}"]
  }
}
```

La CLI carga las fuentes compatibles antes de poner en cola los trabajos de traducción. Si no se puede sincronizar una fuente, la traducción continúa con fuentes alternativas y se muestra una advertencia.

## Salida binaria [#binary]

La CLI gestiona internamente los archivos `.lottie` como base64 y, después, decodifica los resultados descargados para convertirlos de nuevo en archivos binarios. No trates el contenido descargado como texto UTF-8 ni edites manualmente los datos base64 intermedios.