ADC build from sourcecode

Welcome to the ADC build from sourcecode repository! This repository provides all necessary files to manually compile the ADC Archiver 1.4.0 executable without relying on precompiled setups.

Overview

This repository contains the source code and resources required to compile the ADC Archiver 1.4.0 from scratch. It is intended for users who prefer to build the software manually.

Windows

1. Install Python 3.12.x, you can download it here (64bit only)

please note: Python 3.12.10 setups for both 64 and 32 bits are in the source package that you will be downloading in the next steps.

2. Add Python to path while installing.
3. Download the source archive, for Windows this will be a zip archive: Download source package for Windows
4. Extract the zip.
5. Open the terminal in the source archive.
6. Install required Python libraries with:

pip install -r requirements.txt

7. Install Nuitka and Scons:

pip install nuitka scons

Compile on Windows

1. Run in the terminal, cd'ed in the source archive:

nuitka --standalone --enable-plugin=tk-inter "ADC_Archiver_1.4.0.py"

2. After compiling is done, open the dist folder, there you will see: ADC_Archiver_1.4.0.exe
3. Run the executable by dubble clicking the file or:

./ADC_Archiver_1.4.0.exe

For custom .exe icon please use ResourceHacker as Nuitka doesnt support icons anymore.

Linux

Python is almost everywhere pre-delivered on most Linux distro's

1. Download the source archive for Linux Download source package for Linux
2. Open the terminal in the source archive.
3. Install pip

sudo apt install pip

4. Install required Python libraries:

pip install -r requirements.txt

5. Install Nuitka and Scons:

pip install nuitka scons

6. Install Tkinter

sudo apt install python3-tk

7. Install Patchelf:

sudo apt install patchelf

8. Optional: Install ccache to make compiling faster:

sudo apt install ccache

Compile on Linux

1. Compile with:

nuitka --standalone --enable-plugin=tk-inter "ADC_Archiver_1.4.0.py"

2. After compiling you can open the executable by running:

./ADC_Archiver_1.4.0.bin

---

Using Python 3.13 and up

Python 3.13 and up compilation works on Linux but for Windows you need a C compiler, in the source archive there is a file named vs_BuildTools.exe, run this on Windows and now you will be able to compile on Python 3.13 and up on Windows.

Note

[Windows only!] For Python 3.13 and up you need MSVC, MinGW doesn't work!

Project Structure

The repository includes the following key files and directories:

• ADC_Archiver_1.4.0.py: Main Python source code.
• ico/: Directory containing icon files.
• setup/: Directory with setup-related images like the setupbox.ico.
• Additional resource directories: banner/, jpg/, png/, svg/, webp/.
• get-pip.py is the script to install pip (If not already delivered with your Python installation).
• License for setup 1.1.rtf The documents for distributing setup.exe's.
• LICENSE Is the License (GPLv3 license) file.
• python-3.12.10-32bit.exe and python-3.12.10-amd64.exe Are the setup files for Python on both 64 as 32 bit Python.
• requirements.txt Includes Python libraries needed for ADC to work.
• runtime.txt Is the file that tells which Python versions are compatible.
• vs_BuildTools.exe The setup for MSVC (Clang compiler) to compile on Python 3.13.x.

Advanced Compilation Options

• Optimizing for Performance: Enable link-time optimization and follow all imports:

  nuitka --standalone --lto --follow-imports "ADC_Archiver_1.4.0.py"

• Using ccache for Faster Builds: Configure your environment to use ccache:

  export PATH=/path/to/ccache:$PATH

Packaging and Distribution

After successful compilation, test the executable to ensure it functions correctly:

./ADC_Archiver_1.4.0.bin

./ADC_Archiver_1.4.0.exe

To distribute the application, consider creating an installer using tools like NSIS or Inno Setup (for Windows), or packaging for Linux using tools like dpkg or rpm.

There is a full setup license in RTF format in the source archive called License for setup 1.1.rtf. Please make sure to fill in the empty spaces with your dev name, etc.

Troubleshooting

• Missing DLLs or SOs: Ensure all required libraries are included in the compilation command and are accessible at runtime.
• Compilation Warnings or Errors: Review the scons-report.txt file for detailed logs and address any issues as indicated.

Additional Resources

• Nuitka User Manual
• SCons Documentation
• Python 3.12.10 Documentation

For further questions or issues, please create an issue in this repository.

---

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

© 2025 Mealman1551