The /file/decompress Robot

Transloadit can both archive and extract entire media libraries.

The /file/decompress Robot extracts entire archives of files to be consumed by other Robots or exported as individual files.

Parameters

Name	Type	Default	Description
`ignore_errors`	Boolean	`false`	There might be an error coming up when trying to extract meta data from the files inside your archive. This happens for files that are zero bytes big for example. Setting this to `true` will cause the Robot to not stop the file decompression (and the entire Assembly) when that happens.

See full docs

Live demos

Our /file/decompress Robot can be used in combination with other Robots, to create powerful workflows unique to your use case.
Here are a few example scenarios, and the required the Assembly Instructions to implement them.
You can also try demos of these examples right here, live on our website.

Extract all images from an archive and resize them

{
  "steps": {
    "extracted": {
      "use": [":original"],
      "robot": "/file/decompress"
    },
    "resized": {
      "use": ["extracted"],
      "robot": "/image/resize",
      "result": true,
      "height": 200,
      "imagemagick_stack": "v1.0.0",
      "resize_strategy": "pad",
      "width": 200,
      "zoom": false
    },
    "exported": {
      "use": ["extracted", "resized", ":original"],
      "robot": "/s3/store",
      "credentials": "demo_s3_credentials"
    }
  }
}

Try the live demo

Automatically extract all files from an archive

{
  "steps": {
    "extracted": {
      "use": [":original"],
      "robot": "/file/decompress",
      "result": true
    },
    "exported": {
      "use": ["extracted", ":original"],
      "robot": "/s3/store",
      "credentials": "demo_s3_credentials"
    }
  }
}

Try the live demo

Transparently extract uploaded archives

{
  "steps": {
    "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
    },
    "nonarchives_filtered": {
      "use": [":original"],
      "robot": "/file/filter",
      "result": true,
      "declines": [["${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": ["nonarchives_filtered", "extracted"],
      "robot": "/video/encode",
      "result": true,
      "ffmpeg_stack": "v2.2.3",
      "preset": "ipad-high"
    },
    "web_encoded": {
      "use": ["nonarchives_filtered", "extracted"],
      "robot": "/video/encode",
      "result": true,
      "ffmpeg_stack": "v2.2.3",
      "preset": "webm"
    },
    "exported": {
      "use": ["nonarchives_filtered", "archives_filtered", "extracted", "ipad_encoded", "web_encoded", ":original"],
      "robot": "/s3/store",
      "credentials": "demo_s3_credentials"
    }
  }
}

Try the live demo

our /file/decompress Robot blog posts

Over the years we wrote the following posts about our /file/decompress Robot on our blog:

Kicking Transloadit Into Gear for the New Year February 1, 2015
Two New Robots and More Features March 30, 2012

Did you know?

You can easily combine Robots to create powerful workflows, unique to your business.
This is the power of Transloadit.