https://github.com/mealman1551/adc
ADC (ArchivedDataCodec) is a new file extension and file archiver licensed under the GNU General Public License (GPL) v3. It uses Zlib for efficient compression and decompression of various file types. With a simple command-line interface, ADC supports cross-platform use, allowing users to easily archive and extract files on Windows and Linux.
https://github.com/mealman1551/adc
adc archive archiving-datasets fileformat python python3 zip zlib
Last synced: 7 months ago
JSON representation
ADC (ArchivedDataCodec) is a new file extension and file archiver licensed under the GNU General Public License (GPL) v3. It uses Zlib for efficient compression and decompression of various file types. With a simple command-line interface, ADC supports cross-platform use, allowing users to easily archive and extract files on Windows and Linux.
- Host: GitHub
- URL: https://github.com/mealman1551/adc
- Owner: Mealman1551
- License: gpl-3.0
- Created: 2024-08-31T18:33:16.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-27T08:58:55.000Z (about 1 year ago)
- Last Synced: 2025-04-27T09:23:17.502Z (about 1 year ago)
- Topics: adc, archive, archiving-datasets, fileformat, python, python3, zip, zlib
- Language: Python
- Homepage: https://mealman1551.github.io/adc.html
- Size: 236 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[ADC contact e-mail address](mailto:adc@linuxmail.org)
IRC channel: #adcarchiver on OFTC
[Forum](https://groups.google.com/g/adc-archiver)
[Gitter](https://matrix.to/#/#adc:gitter.im)
# ADC (ArchivedDataCodec)
[](#)
[](#)
[](#)
[](#)
[](https://github.com/mealman1551/adc/releases/latest)
[](#)
[](#)
[](https://github.com/Mealman1551/ADC/issues)
[](#)
[](#)
[](https://github.com/Mealman1551/ADC/actions/workflows/gitlab-sync.yml)
[](https://github.com/Mealman1551/ADC/actions/workflows/build.yml)
For Build Status and GitLab Sync status go [here](https://github.com/Mealman1551/ADC?tab=readme-ov-file#build--sync-status)
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](https://github.com/Mealman1551/ADC/tree/ADC-Unstable-(Aurora))
Please note: ~~ADC can currently only pack files, folders aren't supported yet.~~ [ADC Canary](https://gitlab.com/Mealman1551/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 (glibc 2.31 support was introduced on 26-08-2025)
***Developers:***
- Python 3.12.x
- zlib library (typically included with Python)
- tkinter
- progress
- colorama
- cryptography
- zipfile
## Installation
### Windows
1. Download the official installer here: [](https://github.com/Mealman1551/ADC/releases/download/v1.4.0/adc1.4.0setup.exe)
### 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`.
[Download tarball](https://gitlab.com/adc-project/tars/-/raw/main/adc.tar.xz?inline=false)
[Download portable tarball](https://gitlab.com/adc-project/adclinux/-/raw/main/bin.tar.xz?ref_type=heads&inline=false)
#### Command
Dependencies:
1. Wget
2. xz-utils
Run:
```bash
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:
```bash
wget -O- "https://gitlab.com/adc-project/bash/-/raw/main/remove.sh" | bash
```
#### You can also build ADC yourself
[Build ADC](https://github.com/Mealman1551/ADC-compile-from-scratch)
### Unix (BSD, Solaris)
1. Install Python3
2. Install `requirements.txt`
3. Download the source code from /src
4. 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](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](https://docs.google.com/forms/u/0/d/e/1FAIpQLSckLmPxVy7rW30_va7YpE42GAY5UKZqD8tjQgrSGWdbfRJUvA/viewform?usp=form_confirm).
## 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](https://github.com/Mealman1551/ADC/tree/ADC-Unstable-(Aurora)) will be updated monthly, if not weekly.
#### Release flow
1. [ADC Canary](https://gitlab.com/Mealman1551/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](mailto:adc@linuxmail.org).
## 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](https://gitlab.com/Mealman1551/ADC)
Unstable (Aurora) is only on GitHub!
---
For Canary/continuous live development see: [ADC Canary on GitLab](https://gitlab.com/Mealman1551/adc-canary)
#### ***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`](https://github.com/Mealman1551/ADC/blob/main/.github/workflows/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** | [](https://github.com/Mealman1551/ADC/actions/workflows/build.yml) |
| **GitLab Sync** | [](https://github.com/Mealman1551/ADC/actions/workflows/gitlab-sync.yml) |
| | |
**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.0 | LTS | :white_check_mark: | 18-10-2029 |
| 1.3.0 | Regular | :white_check_mark: | 15-05-2027 |
| 1.2.0 | Regular | :white_check_mark: | 15-11-2026 |
| 1.1.0 | Regular | :white_check_mark: | 15-05-2026 |
| 1.0.0 | Regular | :white_check_mark: | 15-11-2025 |
###### © 2025 Mealman1551