# Tórculo en diez minutos

> Una guía para escribir y rodar el primer pliego en diez minutos.

URL: https://torculo.joseluissaorin.com/diez-minutos · Revisado: 2026-10-15 · English: https://torculo.joseluissaorin.com/en/ten-minutes.md

Al final de esta guía tendrás un vídeo de un minuto con voz, música, ambiente y efectos,
escrito en un pliego que se lee como la película. Necesitas la implementación de referencia
(manim-saorín, con su orden `mesa`), el motor de Tórculo para `--motor gx` y este repositorio.
En el Mac de la casa: `mesa` es `/opt/homebrew/Cellar/manim/0.20.1/libexec/bin/python -m
manim_saorin.formato.cli`, y todo lo pesado va delante de `~/Developer/torculo/tools/pesado`.

## Minuto 1: la carpeta y su sonido

```sh
mkdir -p ~/peliculas/faro && cd ~/peliculas/faro        # fuera de Dropbox
python3 ~/Developer/torculo/conformance/tools/sonido.py --salida sonido
```

`sonido/banda/` tiene tres cues (`1M1`, `1M2`, `cortinilla`) y `sonido/efectos/` tres
ambientes (`amb sala bucle`, `amb lluvia bucle`, `amb taller bucle`) y cuatro efectos
(`pagina`, `campanilla`, `sello`, `tijera`), todos sintetizados y libres (CC0). Cambiarlos por
los tuyos es dejar otros ficheros en esas carpetas.

## Minuto 2: la servilleta

Escribe `faro.mesa`, solo prosa y su banda:

```text
MESA «El faro»
BANDA sonido/banda
EFECTOS sonido/efectos
MEZCLA para la web · sin stems
MÚSICA 1M2
AMBIENTE amb lluvia bucle

Cada noche, el farero subía los ciento doce escalones de la torre.
Nadie le había pedido que lo hiciera.
Aun así, encendía la luz.
```

```sh
mesa lee faro.mesa      # «LIMPIO»: ya es un pliego
```

Cada frase es un clip; el motor elige el plano y la pieza. Esto ya se puede rodar.

## Minutos 3 a 5: dirigir

Parte la prosa en un capítulo y en clips, con una función y un afecto cada uno, y pon cosas
sobre la mesa:

```text
MESA «El faro»
formato 16:9 · sala crema · tirada borrador
BANDA sonido/banda
EFECTOS sonido/efectos
MEZCLA para la web · sin stems
REPARTO MARTA: ultramar, cita_f, seca, a la izquierda

== CAPÍTULO 1 · LA TORRE ============== tensión sube · tambor ultramar
MÚSICA 1M2
AMBIENTE amb lluvia bucle
ESPACIO patio

* apertura · sereno
di: Cada noche, el farero subía los ciento doce escalones de la torre.
pon: rescate «EL FARO»

* ilustración · nervioso
MARTA: —¿Por qué nunca se cansa?
pon: cartulina «ESCALÓN»
el escalón sube hasta el borde · despacio
al decir «cansa»: sonido: campanilla

* remate · solemne
di: Aun así, encendía la luz.
pon: sello «LUZ»
al decir «luz»: sonido: sello
> deja posar

== FIN ===
> silencio 2
```

`mesa lee` te dice cada error con lo más parecido que sí vale («¿quisiste decir…?»). Si te
ves escribiendo una cifra, busca la palabra: una manera (`despacio`), una lejanía (`lejos`),
una talla (`primer`), una intensidad (`tensa`).

## Minutos 6 y 7: la voz

```sh
tools/pesado mesa graba faro.mesa        # Supertonic en local; escribe faro.tiempos.json
```

El sidecar guarda cuánto dura cada beat y cuándo se dice cada palabra: de ahí salen los
`al decir`. Es una entrada del vídeo como el pliego mismo.

## Minuto 8: mirar antes de rodar

```sh
tools/pesado mesa animatica faro.mesa --motor gx --sonido
```

Un fotograma por beat con los tiempos y el sonido de verdad. Mira que cada cosa llega cuando
se dice y que nada tapa a nada. Las cosas se arreglan aquí, no en el render.

## Minuto 9: rodar

```sh
tools/pesado mesa toca faro.mesa --motor gx --sonido -o /tmp/faro.mp4
```

Junto al vídeo quedan el máster (`/tmp/faro.master.wav`) y el informe de la banda
(`/tmp/faro.banda.json`): la sonoridad tiene que andar por −14 LUFS y los cues tienen que ser
los que pediste.

## Minuto 10: llevártelo

```sh
mesa empaqueta faro.mesa                 # faro.mesapack: pliego, voz, sonido y manifiesto
mesa desempaqueta faro.mesapack /otra/carpeta
```

El paquete guarda las rutas relativas y el hash de cada fichero: en otra máquina sale el
mismo vídeo.

## Y después

- La [chuleta](chuleta.md): toda la lengua en una página.
- Las capas siguientes: la escena (`EJE`, `LUZ`, planos de cine), el movimiento con sus
  maneras, el aspecto (`MATERIA`, `BOBINA`, `FORMATO`, transiciones, río tipográfico), el
  cartel (`PALETA`, `LETRA`), la imagen que oye (`INTENSIDAD`, `SOPORTE`) y la cámara
  (`CÁMARA`, lentes, profundidad).
- La [especificación](../spec/SPEC.es.md), cuando quieras saber por qué.