ADC contact e-mail address

Forum (Main announcement channel)

Gitter

ADC (ArchivedDataCodec)

Index / Quick Links

• ADC Overview

• Features

• Getting Started

• Installation

  • Windows
  • Linux

• Usage

• License

• Issues

• Update Schedule

• Contributing

• Contact

• Build & Sync Status

• Supported Versions

• Prepare Build environment on Windows

• Prepare Build environment on Linux

  • Start building on windows .2
  • Start building on Linux .2

For Build Status and GitLab Sync status go here

Compatible with: &

ADC (ArchivedDataCodec) is an open-source file extension and archiving/compression tool that uses Zlib for efficient compression and decompression of various file types. With a simple command-line interface, ADC supports both Windows and Linux, making it easy for users to archive and extract files.

ADC Archiver uses a byte-key of 8, meaning that it can create archives without limitations

For the unstable/rolling release see: ADC Aurora

Please note: ADC can currently only pack files, folders aren't supported yet. ADC Canary supports this now!

Features

• Great Compression Algorithm: Utilizes zlib for efficient compression.
• Cross-Platform: Compatible with both Windows and Linux.
• Command-Line Interface: Simple and intuitive interface.
• Support: Supports a wide range of file types.

Getting Started

Prerequisites

Users Windows

• Windows 8 or higher Linux
• A Modern Linux distro that has at least glibc 2.31

Developers:

• Python3
• zlib
• tkinter
• progress
• colorama
• cryptography
• bas64
• zipfile
• webbrowser
• urlib
• json
• ssl

Installation

Windows

1. Download the official installer here:

Linux

Tarball

Download the tarball and run install.sh, this will copy the files to /opt and make a symlink to /usr/local/bin.

To remove run remove.sh in the same tarball.

Download tarball

Command

Dependencies:

1. Wget
2. xz-utils

Run:

mkdir -p ~/adc-temp && cd ~/adc-temp && wget -O adc.tar.xz "https://gitlab.com/adc-project/tars/-/raw/main/adc.tar.xz?inline=false" && tar -xJf adc.tar.xz && sudo ./install.sh && cd ~ && rm -rf ~/adc-temp

to install ADC without leaving any garbage

To remove ADC you can run:

wget -O- "https://gitlab.com/adc-project/bash/-/raw/main/remove.sh" | bash

ADC has multiple mirrors

• GitHub (Recommended)
• SourceForge

Unix (BSD, Solaris)

1. Install Python3

2. Install requirements.txt

3. Install python3-tk

4. Download the source code from /src

5. Run the source code in python3

Usage

Download the program for Windows or Linux. Tarballs and setups available in the Releases tab.

License

This project is licensed under the GNU GPL-3.0 License. You are free to use, modify, and distribute it under the terms of the license.

Issues

Create an issue easily without the need for a GitHub account via this form.

Update Schedule

I select a date myself what is the best time, cuz i have work. Meanwhile, the rolling release Python source script ADC Aurora will be updated monthly, if not weekly.

Release flow

1. ADC Canary, live updated repo, not meant to use.
2. after ADC Canary the working code will be ported to ADC Aurora asap.
3. Stable version will be based on Aurora's source code after testing the code, if there are bugs i will use a stable Aurora script.

Contributing

Contributions are welcome! See the CONTRIBUTING.md file.

Contact

Have questions or want to learn more? Feel free to reach out via this mail address.

GitLab

I have 2 ADC Repos on Gitlab, one is a continuously updated mirror of the Main branch (Stable only), and the other is the Canary repo, meant to be before Aurora

Mirror/Main(Stable) GitLab repo of ADC: ADC on GitLab

Unstable (Aurora) is only on GitHub!

---

For Canary/continuous live development see: ADC Canary on GitLab

DO NOT USE THE CANARY REPO AS MAIN SOURCE, THIS IS LIVE DEVELOPMENT ONLY!

---

Syncing to GitLab

Syncing to GitLab is done via the gitlab-sync.yml file in /.github/workflows/gitlab-sync.yml

Notes

If you want to support the project please consider a small donation:

---

No macOS support

ADC Archiver does NOT support macOS, and it never will. This is a deliberate decision to take a stand against the growing dominance of proprietary ecosystems and Apple’s developer restrictions. This project supports open platforms only: Windows and Linux/Unix.

You can ofc run the source code but official binaries and/or setups are not compiled for macOS!

---

Build & Sync Status

Workflow	Status
Build Status
GitLab Sync

Build Status: Builds and compiles ADC's source code with Nuitka and testing binary after it for errors.

GitLab Sync: Syncing Main branch to GitLab.

Supported Versions

Version	Release Type	Supported	EOL (End Of Life)
1.4.x	LTS	✅	18-10-2029
1.3.0	Regular	✅	15-05-2027
1.2.0	Regular	✅	15-11-2026
1.1.0	Regular	✅	15-05-2026
1.0.0	Regular	❌	15-11-2025

Build ADC

Note

For compiling on Python 3.13 and up, a C compiler is required. On Linux, GCC is sufficient. On Windows, MSVC (cl.exe) is required > >via Visual Studio Build Tools 2022. Python 3.12 can compile without a C compiler using MinGW64.

Supported versions: 1.0.0, 1.1.0, 1.2.0, 1.3.0, 1.4.2. Use make windows or make linux for the latest version (1.4.2), or x.x.x-windows / x.x.x-linux for a specific version.

Building on Windows

Preparing build environment on Windows

Please disable Windows Defender as it may block compilation.

Installing Make

Options to install GNU Make:

Option 1 — WinGet (Recommended)

winget install GnuWin32.Make

Add Make to PATH. More info

Option 2 — Chocolatey

choco install make

Downloading and extracting source code

1. Download and extract: source_code.zip

Installing Python and VS Build Tools

1. Install Python 3.13.x (64-bit). Ensure pip is installed and Python is added to PATH.

python --version

2. Install Visual Studio Build Tools 2022:

make buildtools22

3. Open VS Developer PowerShell:

Import-Module "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\Tools\Microsoft.VisualStudio.DevShell.dll"
Enter-VsDevShell -VsInstallPath "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools" -DevCmdArguments "-arch=x64 -host_arch=x64"

Then:

cd ArchivedDataCodec-main

Then:

make deps-windows

Start building on Windows

Warning

Do NOT run the binary while compiling!

Warning

Do NOT install MinGW64 if Nuitka asks for it. You CAN install depends.exe if Nuitka asks for it.

Compile the latest version:

make windows

Or specific version:

make 1.3.0-windows

Run the binary:

cd dist
./ADC_Archiver_1.4.2.exe

or

./ADC_Archiver_1.3.0.exe

Clean build:

make clean-windows

Debug build (Optional) Only use if you really need to, normally make windows is the best option:

make debug-windows

---

Building on Linux

Preparing build environment on Linux

Install dependencies:

sudo apt install build-essential pip python3-tk make patchelf ccache scons

Ensure Python 3.10+:

python3 --version

Download and extract source: source_code.tar.gz

Install additional dependencies:

make deps-linux

Restart or logoff to apply packages.

Start building on Linux

Warning

Do NOT run the binary while compiling!

Compile latest version:

make linux

Or specific version:

make 1.3.0-linux

Run the binary:

cd dist
./ADC_Archiver_1.4.2.bin

or

./ADC_Archiver_1.3.0.bin

Clean build:

make clean-linux

Debug build (optional):

make debug-linux

Notes

Specific old versions can be compiled with commands like make 1.1.0-windows or make 1.2.0-linux. Version 1.0.0 is deprecated; compilation is possible but not recommended.

---

© Mealman1551