5 releases

new 0.3.2 Nov 22, 2024
0.3.1 Sep 8, 2024
0.3.0 Aug 29, 2024
0.2.1 Feb 20, 2024
0.2.0 Feb 6, 2024

#123 in Compression

Download history 101/week @ 2024-08-24 25/week @ 2024-08-31 202/week @ 2024-09-07 29/week @ 2024-09-14 15/week @ 2024-09-21 25/week @ 2024-09-28 2/week @ 2024-10-05

425 downloads per month

MIT license

110KB
2.5K SLoC

Zip2Arx: Zip to Arx Archive Converter

zip2arx is a command-line tool that converts zip archives to the Arx archive format. Arx (https://crates.io/crates/arx) offers a modern and performant alternative to traditional archive formats. This tool streamlines the process of migrating existing zip archives to the benefits of Arx.

Installation

Using Cargo

The recommended installation method is using Cargo, Rust's package manager:

cargo install zip2arx arx

This command will install both zip2arx and its dependency, the arx library, which is necessary for reading and manipulating Arx archives.

Pre-built Binaries

Pre-built binaries for Windows, macOS, and Linux are available for each release on the GitHub releases page. Download the appropriate binary for your operating system and place it in your system's PATH.

Usage Examples

Converting a Zip Archive:

zip2arx -o output.arx input.zip

This command converts input.zip to output.arx.

Working with Arx Archives (using the arx command):

After converting to Arx, use the arx command to interact with the created archive. Here are some examples:

  • List archive contents:

    arx list output.arx | less
    
  • Extract the archive:

    arx extract output.arx -C my_output_directory
    
  • Extract a single file:

    arx dump output.arx path/to/my/file.txt my_file.txt
    
  • Mount the archive (Linux/macOS):

    mkdir mount_point
    arx mount output.arx mount_point
    

    Remember to unmount the archive using umount mount_point when finished.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Sponsoring

I (@mgautierfr) am a freelance developer. All jubako projects are created in my free time, which competes with my paid work. If you want me to be able to spend more time on Jubako projects, please consider sponsoring me. You can also donate on liberapay or buy me a coffee.

License

This project is licensed under the MIT License - see the LICENSE-MIT file for details.

Dependencies

~21–33MB
~537K SLoC