Skip to content

1.3.0 Documentation

Mealman1551 edited this page Jun 2, 2025 · 6 revisions

1.3.0 Documentation


Overview

ADC (ArchivedDataCodec) Archiver is a custom file archiving tool that allows you to compress and decompress files into a .adc format using zlib compression. ADC 1.3.0 is based on Aurora 2025.04.1 but has been directly modified. It includes a terminal-based interface and uses GUI dialogs for file selection.


Features

  • Compress multiple files into a single .adc archive
  • Extract files from .adc archives
  • Lightweight terminal interface
  • Tkinter GUI dialogs for user-friendly file selection
  • Uses zlib for compression
  • Progress bars during operations
  • Colorized terminal output using colorama

Dependencies (Developers only)

Ensure the following Python libraries are installed:

pip install progress colorama

Built-in:

  • os
  • zlib
  • tkinter
  • socket
  • getpass

Usage

Linux

https://github.com/Mealman1551/ADC/wiki/Linux-usage

Windows

Run the executable, downloadable from here

Interface

You will be prompted with a command menu:

  • c – Create an ADC archive
  • e – Extract an existing ADC archive
  • i – View information about the program
  • q – Quit the program

You can also pass an archive path as an argument to auto-start extraction by the executable.


File Format

Each .adc archive follows this structure:

  1. 2 bytes – Length of the filename
  2. N bytes – UTF-8 encoded filename
  3. 8 bytes – Length of the compressed file data
  4. N bytes – zlib-compressed file data

Key Functions

create_adc_archive(file_paths, output_path)

Compresses selected files and writes them into the .adc archive.

extract_adc_archive(archive_path, output_dir)

Extracts files from a .adc archive into the specified output directory.

parma_compress(data)

Compresses binary data using zlib.

parma_decompress(data)

Attempts to decompress binary data using zlib.


Info Command Output

Shows version, system info, and contact links:


License

This program is licensed under the GNU General Public License v3.0. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.html) for more details.


Source code

The source code is available here


Disclaimer

please handle the source code with care. With great power comes great responsibility!


Author

Mealman1551


© 2025 Mealman1551

Clone this wiki locally