# Generate a slideshow from a series of images

Slideshows are a great way for you to show off your images with a personal flare. Letting your users show holidays, special events or pictures of the family has never been so easy and customizable using the services we offer. In this demo, we use a combination of Robots to create a slideshow from a series of images, then apply a backing audio track.

When using [🤖/video/encode](/docs/robots/video-encode.md) to generate a slideshow, the images used are merged in the order of their filenames. You could, for example, call them `1.jpg`, `2.jpg`, etc. and they will be used in the correct order.

From here we will upload a backing track for the slideshow, which in this case is provided by importing an audio track from a URL, but could also be uploaded by the user.

With `duration: null`, the slideshow will repeat the photos until the song is finished. You could also set `duration: 9`, so that it stops after the 3 photos display for 3 seconds each.

You can read more about [advanced use cases in the Assembly Instructions docs\</a](/docs/topics/assembly-instructions.md)

[ . ](/docs/topics/assembly-instructions.md)

Step 1

### Handle uploads

We can handle uploads of your users directly. [Learn more ›](/services/handling-uploads.md)

![desert.jpg](https://demos.transloadit.com/e3/bcda791c28418b9d3a36acbc782cd4/desert.jpg)

[desert.jpg](https://demos.transloadit.com/e3/bcda791c28418b9d3a36acbc782cd4/desert.jpg)

Image · 1.5 MB · 2560 × 2048

![chameleon.jpg](https://demos.transloadit.com/11/94b0472aa248c7bc8a6a453a163ac7/chameleon.jpg)

[chameleon.jpg](https://demos.transloadit.com/11/94b0472aa248c7bc8a6a453a163ac7/chameleon.jpg)

Image · 8.9 MB · 4799 × 3199

![prinsengracht.jpg](https://demos.transloadit.com/fb/22a35887ee4e04961ad3c5405d5954/prinsengracht.jpg)

[prinsengracht.jpg](https://demos.transloadit.com/fb/22a35887ee4e04961ad3c5405d5954/prinsengracht.jpg)

Image · 14 MB · 5195 × 3457

```
":original": {
  "robot": "/upload/handle"
}
```

🤖 [/upload/handle](/docs/robots/upload-handle.md)

This bot receives uploads that your users throw at you from browser or apps, or that you throw at us programmatically

Step 2

### Import files from web servers

We are happy to import from whatever storage solution suits you best. [Learn more ›](/services/file-importing.md)

[joakim\_karud-rock\_angel.mp3](https://demos.transloadit.com/83/eb1a28d94e40e1bd914ae41fcb7d14/joakim%5Fkarud-rock%5Fangel.mp3)

Audio · 8.9 MB · 233s

```
"imported_audio": {
  "robot": "/http/import",
  "result": true,
  "url": "https://demos.transloadit.com/inputs/joakim_karud-rock_angel.mp3"
}
```

🤖 [/http/import](/docs/robots/http-import.md)

This bot imports any file that is publicly available via a web URL into Transloadit

Step 3

### Convert, resize, or watermark images

We can resize, crop, and (auto-)rotate images, or apply watermarks and other effects, and much more. [Learn more ›](/services/image-processing.md)

![desert.jpg](https://demos.transloadit.com/eb/23adf0ef0a4abbae95060a032017c6/desert.jpg)

[desert.jpg](https://demos.transloadit.com/eb/23adf0ef0a4abbae95060a032017c6/desert.jpg)

Image · 281 KB · 1024 × 768

![chameleon.jpg](https://demos.transloadit.com/f7/f055b31ac94e2c84a43db0f66a96a0/chameleon.jpg)

[chameleon.jpg](https://demos.transloadit.com/f7/f055b31ac94e2c84a43db0f66a96a0/chameleon.jpg)

Image · 207 KB · 1024 × 768

![prinsengracht.jpg](https://demos.transloadit.com/9d/189cce98e446a7adca374cf59e0377/prinsengracht.jpg)

[prinsengracht.jpg](https://demos.transloadit.com/9d/189cce98e446a7adca374cf59e0377/prinsengracht.jpg)

Image · 329 KB · 1024 × 768

```
"resized": {
  "use": ":original",
  "robot": "/image/resize",
  "result": true,
  "height": 768,
  "resize_strategy": "fillcrop",
  "width": 1024
}
```

🤖 [/image/resize](/docs/robots/image-resize.md)

This bot resizes, crops, changes colorization, rotation, and applies text and watermarks to images

Step 4

### Merge video, audio, images into one video

We offer a variety of video encoding features like optimizing for different devices, merging, injecting ads, changing audio tracks, or adding company logos. [Learn more ›](/services/video-encoding.md)

[joakim\_karud-rock\_angel.mp4](https://demos.transloadit.com/4b/08cfc4badb4c88ac82e4cbd260b09d/joakim%5Fkarud-rock%5Fangel.mp4)

Video · 29 MB · 234s · 1024 × 768

```
"merged": {
  "use": {
    "steps": [
      {
        "name": "imported_audio",
        "as": "audio"
      },
      {
        "name": "resized",
        "as": "image"
      }
    ],
    "bundle_steps": true
  },
  "robot": "/video/merge",
  "result": true,
  "ffmpeg_stack": "v7",
  "framerate": "1/3",
  "preset": "ipad-high",
  "resize_strategy": "fillcrop"
}
```

🤖 [/video/merge](/docs/robots/video-merge.md)

This bot composes a new video by adding an audio track to existing still image(s) or video

Step 5

### Export files to Amazon S3

We export to the storage platform of your choice. [Learn more ›](/services/file-exporting.md)

`:original`

* [https://demos.transloadit.com/e3/bcda791c28418b9d3a36acbc782cd4/desert.jpg⁠](https://demos.transloadit.com/e3/bcda791c28418b9d3a36acbc782cd4/desert.jpg)
* [https://demos.transloadit.com/11/94b0472aa248c7bc8a6a453a163ac7/chameleon.jpg⁠](https://demos.transloadit.com/11/94b0472aa248c7bc8a6a453a163ac7/chameleon.jpg)
* [https://demos.transloadit.com/fb/22a35887ee4e04961ad3c5405d5954/prinsengracht.jpg⁠](https://demos.transloadit.com/fb/22a35887ee4e04961ad3c5405d5954/prinsengracht.jpg)

`imported_audio`

* [https://demos.transloadit.com/83/eb1a28d94e40e1bd914ae41fcb7d14/joakim\_karud-rock\_angel.mp3⁠](https://demos.transloadit.com/83/eb1a28d94e40e1bd914ae41fcb7d14/joakim%5Fkarud-rock%5Fangel.mp3)

`resized`

* [https://demos.transloadit.com/eb/23adf0ef0a4abbae95060a032017c6/desert.jpg⁠](https://demos.transloadit.com/eb/23adf0ef0a4abbae95060a032017c6/desert.jpg)
* [https://demos.transloadit.com/f7/f055b31ac94e2c84a43db0f66a96a0/chameleon.jpg⁠](https://demos.transloadit.com/f7/f055b31ac94e2c84a43db0f66a96a0/chameleon.jpg)
* [https://demos.transloadit.com/9d/189cce98e446a7adca374cf59e0377/prinsengracht.jpg⁠](https://demos.transloadit.com/9d/189cce98e446a7adca374cf59e0377/prinsengracht.jpg)

`merged`

* [https://demos.transloadit.com/4b/08cfc4badb4c88ac82e4cbd260b09d/joakim\_karud-rock\_angel.mp4⁠](https://demos.transloadit.com/4b/08cfc4badb4c88ac82e4cbd260b09d/joakim%5Fkarud-rock%5Fangel.mp4)

```
"exported": {
  "use": [
    "imported_audio",
    "resized",
    "merged",
    ":original"
  ],
  "robot": "/s3/store",
  "credentials": "demo_s3_credentials",
  "url_prefix": "https://demos.transloadit.com/"
}
```

🤖 [/s3/store](/docs/robots/s3-store.md)

This bot exports encoding results to Amazon S3

## Live Demo. See for yourself

Loading Uppy demo…

This live demo is powered by [Uppy⁠](https://uppy.io/docs/guides/uppy-transloadit/), our open source file uploader that you can also use without Transloadit, and [tus⁠](https://tus.io), our open protocol for resumable file uploads that is making uploading more reliable across the world.

## Build this in your own language

```
<!-- This pulls Uppy from our CDN -->
<!-- For smaller self-hosted bundles, install Uppy and plugins manually: -->
<!-- npm i --save @uppy/core @uppy/dashboard @uppy/remote-sources @uppy/transloadit ... -->
<link
  href="https://releases.transloadit.com/uppy/v3.10.0/uppy.min.css"
  rel="stylesheet"
/>
<button id="browse">Select Files</button>
<script type="module">
  import {
    Uppy,
    Dashboard,
    ImageEditor,
    RemoteSources,
    Transloadit,
  } from 'https://releases.transloadit.com/uppy/v3.10.0/uppy.min.mjs'
  const uppy = new Uppy()
    .use(Transloadit, {
      waitForEncoding: true,
      alwaysRunAssembly: true,
      assemblyOptions: {
        params: {
          // It's often better store encoding instructions in your account
          // and use a `template_id` instead of adding these steps inline
          steps: {
            ':original': {
              robot: '/upload/handle',
            },
            imported_audio: {
              robot: '/http/import',
              result: true,
              url: 'https://demos.transloadit.com/inputs/joakim_karud-rock_angel.mp3',
            },
            resized: {
              use: ':original',
              robot: '/image/resize',
              result: true,
              height: 768,
              resize_strategy: 'fillcrop',
              width: 1024,
            },
            merged: {
              use: {
                steps: [
                  {
                    name: 'imported_audio',
                    as: 'audio',
                  },
                  {
                    name: 'resized',
                    as: 'image',
                  },
                ],
                bundle_steps: true,
              },
              robot: '/video/merge',
              result: true,
              ffmpeg_stack: 'v7',
              framerate: '1/3',
              preset: 'ipad-high',
              resize_strategy: 'fillcrop',
            },
            exported: {
              use: ['imported_audio', 'resized', 'merged', ':original'],
              robot: '/s3/store',
              credentials: 'demo_s3_credentials',
              url_prefix: 'https://demos.transloadit.com/',
            },
          },
        },
      },
    })
    .use(Dashboard, { trigger: '#browse' })
    .use(ImageEditor, { target: Dashboard })
    .use(RemoteSources, {
      companionUrl: 'https://api2.transloadit.com/companion',
    })
    .on('complete', ({ transloadit }) => {
      // Due to `waitForEncoding:true` this is fired after encoding is done.
      // Alternatively, set `waitForEncoding` to `false` and provide a `notify_url`
      console.log(transloadit) // Array of Assembly Statuses
      for (const assembly of transloadit) {
        console.log(assembly.results) // Array of all encoding results
      }
    })
    .on('error', (error) => {
      console.error(error)
    })
</script>

```

[Read docs: Browsers](/docs/sdks/uppy.md)

## So many ways to integrate

Transloadit is a service for companies with developers. And there are many ways developers can put Transloadit to good use inside your company to automate media processing.

#### Bulk imports

Add one of our [import Robots](/services/file-importing.md) to acquire and transcode massive media libraries.

#### Handling uploads

We are *the* experts at reliably [handling uploads](/services/handling-uploads.md). We wrote the [protocol⁠](https://tus.io/) for it.

#### Front-end integration

We integrate with web browsers via our next-gen file uploader [Uppy⁠](https://uppy.io/docs/guides/uppy-transloadit/) and SDKs for Android and iOS.

#### Back-end integration

Send us batch jobs in any server language using one of our [SDKs](/docs/sdks.md) or directly interfacing with our [REST API](/docs/api.md).

#### Pingbacks

Configure a [notify\_url](/services/content-delivery.md) to let your server receive transcoding results JSON in the `transloadit` POST field.

#### On-demand

Use our [Smart CDN](/services/file-importing.md) to adapt files on-demand and stream them directly to your users.

[Browsers](/docs/sdks/uppy.md)[TransloaditKit](/docs/sdks/transloaditkit.md)[Ruby SDK](/docs/sdks/ruby-sdk.md)[HTTP REST API](/docs/api.md)[Python SDK](/docs/sdks/python-sdk.md)[PHP SDK](/docs/sdks/php-sdk.md)[Node.js SDK](/docs/sdks/node-sdk.md)[Java SDK](/docs/sdks/java-sdk.md)[Go SDK](/docs/sdks/go-sdk.md)[cURL](/docs/sdks/curl.md)[Convex](/docs/sdks/convex.md)

[Browsers](/docs/sdks/uppy.md)[TransloaditKit](/docs/sdks/transloaditkit.md)[Ruby SDK](/docs/sdks/ruby-sdk.md)[HTTP REST API](/docs/api.md)[Python SDK](/docs/sdks/python-sdk.md)[PHP SDK](/docs/sdks/php-sdk.md)[Node.js SDK](/docs/sdks/node-sdk.md)[Java SDK](/docs/sdks/java-sdk.md)[Go SDK](/docs/sdks/go-sdk.md)[cURL](/docs/sdks/curl.md)[Convex](/docs/sdks/convex.md)

[Browsers](/docs/sdks/uppy.md)[TransloaditKit](/docs/sdks/transloaditkit.md)[Ruby SDK](/docs/sdks/ruby-sdk.md)[HTTP REST API](/docs/api.md)[Python SDK](/docs/sdks/python-sdk.md)[PHP SDK](/docs/sdks/php-sdk.md)[Node.js SDK](/docs/sdks/node-sdk.md)[Java SDK](/docs/sdks/java-sdk.md)[Go SDK](/docs/sdks/go-sdk.md)[cURL](/docs/sdks/curl.md)[Convex](/docs/sdks/convex.md)

## Other cool demos

* [View demo→Video EncodingAdd an audio track to video footage](/demos/video-encoding/add-audio-track-to-video-footage.md)
* [View demo→Video EncodingAdd an empty audio track to still video](/demos/video-encoding/add-empty-audio-track-to-still-video.md)
* [View demo→Document ProcessingAdd a header or footer to a PDF](/demos/document-processing/add-header-or-footer-to-pdf.md)

Try Transloadit

## Ready to get started?

Join thousands of developers who trust Transloadit for their file processing needs.

Building file processing from scratch

Ready-to-use API & SDKs

Scaling infrastructure headaches

Auto-scaling global infrastructure

Managing codec updates

Always up-to-date processing

Handling file security

Enterprise-grade security

Supporting all file formats

1000+ formats & codecs supported

Unpredictable costs

Transparent pricing

GDPR

GDPR

HIPAA

HIPAA

ISO 27001ISO27001

ISO 27001

AES-256

AES-256

SOC 2 Type II

SOC 2 Type II

[Try Transloadit for Free](/c/signup/)

[Try Transloadit for Free](/c/signup/)

No credit card needed · 5 GB included in the free plan · Cancel anytime