Automatically decompress uploaded archives
Perhaps you would like your users to upload any file and, if it is an archive, automatically extract it first.
As documented on our formats page, there are many different archive mime-types that Transloadit can extract. In this demo, we will show you how to filter archives, extract them first, and then pass the extracted files through normal encoding steps (converting to optimized for iPad and webm formats in this case).
Finally, we export both the original files and the encoded videos to an S3 bucket.
Step 1:
Handle uploads
We can handle uploads of your users directly.Learn more
application/zip – 32 MB
":original": {
"robot": "/upload/handle"
}This bot receives uploads that your users throw at you from browser or apps, or that you throw at us programmatically
Step 2:
Filter files
We let you reject, or direct files against different encoding Steps.Learn more
application/zip – 32 MB
"archives_filtered": {
"use": ":original",
"robot": "/file/filter",
"result": true,
"accepts": [
[
"${file.mime}",
"regex",
"application/(rar|x-7z-compressed|x-cab|x-cpio|x-debian-package|x-gtar-compressed|x-gzip|x-lzh|x-redhat-package-manager|x-tar|zip)"
]
],
"error_on_decline": false
}This bot directs files to different encoding Steps based on your conditions
Step 3:
Decompress archives
We can both archive and extract entire media libraries.Learn more
"extracted": {
"use": "archives_filtered",
"robot": "/file/decompress",
"result": true
}This bot extracts entire archives of files to be consumed by other Robots or exported as individual files
Step 4:
Transcode, resize, or watermark videos
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
"ipad_encoded": {
"use": "extracted",
"robot": "/video/encode",
"result": true,
"ffmpeg_stack": "v7",
"preset": "ipad-high",
"turbo": false
}This bot encodes, resizes, applies watermarks to videos and animated GIFs
Step 5:
Transcode, resize, or watermark videos
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
"web_encoded": {
"use": "extracted",
"robot": "/video/encode",
"result": true,
"ffmpeg_stack": "v7",
"preset": "webm",
"turbo": false
}This bot encodes, resizes, applies watermarks to videos and animated GIFs
Step 6:
Export files to Amazon S3
We export to the storage platform of your choice.Learn more
:originalarchives_filteredextractedipad_encodedweb_encoded"exported": {
"use": [
"archives_filtered",
"extracted",
"ipad_encoded",
"web_encoded",
":original"
],
"robot": "/s3/store",
"credentials": "demo_s3_credentials",
"url_prefix": "https://demos.transloadit.com/"
}This bot exports encoding results to Amazon S3
Live Demo. See for yourself
Loading Uppy demo…
This live demo is powered by
Uppy, our open source file uploader that you can also use without Transloadit, and
tus, 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',
},
archives_filtered: {
use: ':original',
robot: '/file/filter',
result: true,
accepts: [
[
'${file.mime}',
, 'regex',
, 'application/(rar|x-7z-compressed|x-cab|x-cpio|x-debian-package|x-gtar-compressed|x-gzip|x-lzh|x-redhat-package-manager|x-tar|zip)',
],
],
error_on_decline: false,
},
extracted: {
use: 'archives_filtered',
robot: '/file/decompress',
result: true,
},
ipad_encoded: {
use: 'extracted',
robot: '/video/encode',
result: true,
ffmpeg_stack: 'v7',
preset: 'ipad-high',
turbo: false,
},
web_encoded: {
use: 'extracted',
robot: '/video/encode',
result: true,
ffmpeg_stack: 'v7',
preset: 'webm',
turbo: false,
},
exported: {
use: ['archives_filtered', 'extracted', 'ipad_encoded', 'web_encoded', ':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>
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 to acquire and transcode massive media libraries.
Handling uploads
We are the experts at reliably handling uploads. We wrote the protocol for it.
Front-end integration
We integrate with web browsers via our next-gen file uploader Uppy and SDKs for Android and iOS.
Back-end integration
Send us batch jobs in any server language using one of our SDKs or directly interfacing with our REST API.
Pingbacks
Configure a notify_url to let your server receive transcoding results JSON in the transloadit POST field.
On-demand
Use our Smart CDN to adapt files on-demand and stream them directly to your users.