# Videos for social networks

> Turn every tutorial into vertical, portrait and square videos for Reels, TikTok, Shorts, Instagram and LinkedIn, from the same shoot.

The tutorial you film for your help pages can also become a Reel, a TikTok, a
LinkedIn post. Ondaclip makes every shape from **the same shoot**: no new
recording, and each format stays as current as the original.

## The formats

| Format | Shape | Where it goes |
|---|---|---|
| `landscape` | 16:9 | Your help pages, YouTube, your site. Always made. |
| `vertical` | 9:16 | Reels, Stories, TikTok, YouTube Shorts |
| `portrait` | 4:5 | The Instagram and LinkedIn feeds |
| `square` | 1:1 | LinkedIn, Facebook |

## Which one for which network

You don't need to know the shapes: the **Share** panel of a tutorial has a
button per network, and the published list (`networks` in the manifest) points
each network to its file. No file is copied.

| Network | Format |
|---|---|
| LinkedIn post | square (portrait if you have it, else landscape) |
| Instagram and Facebook feeds | portrait, else square |
| Reels, TikTok, YouTube Shorts | vertical |
| X | landscape, else square |
| YouTube | landscape |

## Turn them on

Add the formats you want to `.ondaclip/config.yaml`:

```yaml
formats: [landscape, vertical, square]
```

The next shoot renders every format, in every language. A tutorial that is too
long for the social networks can stay out of them:

```yaml
# .ondaclip/tutorials/advanced-settings.yaml
formats: [landscape]
```

## Film on a phone

By default, Ondaclip films your app on a desktop screen, and the social formats
follow the action in a narrower frame. If your app is responsive or built for
mobile, film it on a phone instead:

```yaml
# .ondaclip/tutorials/check-board.yaml (or in config.yaml for every tutorial)
device: phone
```

Ondaclip films the tutorial once, at phone size, with touch, so viewers see your
real mobile layout: the menu behind its button, the columns stacked, the
buttons where a thumb finds them. Every format comes from that one shoot:

| Format | What it shows |
|---|---|
| `vertical` | The phone screen, large, between the title and the captions |
| `square`, `portrait` | The phone in its frame, the captions below |
| `landscape` | The phone in its frame, for your help pages |

Pick `phone` when most of your users are on mobile, or when you want Reels and
TikToks that look native. Keep `desktop` for screens that need room, like wide
tables or dashboards.

## What makes them look right

- **The camera follows the action.** In a narrow frame, Ondaclip zooms in on
  what is clicked or typed, so the app reads well on a phone. It never cuts the
  element you act on, or the row it sits in.
- **Captions are always on.** Most people watch without sound, so every
  sentence of the narration shows in large type.
- **Nothing hides behind the app's buttons.** The title, the app and the
  captions stay inside the zones Reels, TikTok and Shorts leave clear.
- **The title hooks.** Vertical and portrait videos open with the tutorial
  title and the step, so viewers know what they're about to learn.

## Two ways to frame them

By default the camera **follows the action** in the narrow frame. If you'd
rather show the whole screen, choose the composed layout: the landscape video
sits in the middle, with the title above and large captions below.

```yaml
social:
  framing: composed   # or follow (the default)
```

## Review

A clip and its formats are reviewed together: the studio shows each format
next to the landscape clip, and one approval covers all of them. Look at the
vertical one closely: it's the shape that changes the most.

Your AI agent can look first: `look_at_tutorial` with `format: "vertical"`
shows the frames of the vertical clip, so it can tell you about a cut label
before you review.

## Publish and share

Published formats appear in your list of videos, with a filter by format. Each
format is also published as one video of the whole tutorial, ready to post.

On a published tutorial, the **Share** panel gives you, for each format and
language:

- the video to download,
- its captions as an `.srt` file, for the networks that take one,
- a post to start from: a hook, the first steps, and a spot for your link.

## A looping GIF of a step

For a README, a changelog or a quick post, turn on `gif: true` in
`.ondaclip/config.yaml`. Each time you publish, Ondaclip turns every step into a
looping GIF from the video it already made, with no new shoot: silent, 800 px
wide, and 20 seconds at most (a longer step plays a little faster). Pick the
step in the **Share** panel and download its GIF.

Your AI agent can prepare a post too: `social_cut` picks the first steps that
fit in 30 to 60 seconds and writes the post in the language of the video.

The [delivery list](/docs/show-videos/) also gives each step's video and poster
in each format, for your own app or site.

Source: https://ondaclip.com/docs/social-videos/
