Ouch!

crates.io license

ouch stands for Obvious Unified Compression Helper, it's a CLI tool to compress and decompress files.

Features

  1. Easy to use.
  2. Automatic format detection.
  3. Same syntax, various formats.
  4. Encoding and decoding streams, it's fast.
  5. No runtime dependencies (for Linux x8664_).

Usage

Decompressing

Use the decompress subcommand and pass the files.

```sh

Decompress one

ouch decompress a.zip

Decompress multiple

ouch decompress a.zip b.tar.gz c.tar

Short alternative

ouch d a.zip ```

You can redirect the decompression results to another folder with the -d/--dir flag.

```sh

Decompress 'summer_vacation.zip' inside of new folder 'pictures'

ouch decompress summer_vacation.zip -d pictures ```

Compressing

Use the compress subcommand, pass the files and the output file at the end.

```sh

Compress four files/folders

ouch compress 1 2 3 4 archive.zip

Short alternative

ouch c file.txt file.zip

Compress everything in the current folder again and again

ouch compress * everything.tar.gz.xz.bz.zst.gz.gz.gz.gz.gz ```

ouch checks for the extensions of the output file to decide which formats should be used.

Installation

Packaging status

Downloading the latest binary

Compiled for x86_64 on Linux, Mac OS and Windows, run with curl or wget.

| Method | Command | |:---------:|:-----------------------------------------------------------------------------------| | curl | curl -s https://raw.githubusercontent.com/ouch-org/ouch/master/install.sh \| sh | | wget | wget https://raw.githubusercontent.com/ouch-org/ouch/master/install.sh -O - \| sh |

The script will download the latest binary and copy it to /usr/bin.

Installing from source code

For compiling, check the wiki guide.

Supported formats

| Format | .tar | .zip | .bz, .bz2 | .gz | .xz, .lz, .lzma | .zst | |:-------------:|:----:|:----:|:---------:| --- |:---------------:| --- | | Supported | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |

And the aliases: tgz, tbz, tbz2, txz, tlz, tlzma, tzst.

Formats can be chained (ouch keeps it fast):

Contributing

ouch is 100% made out of voluntary work, any small contribution is welcome!