Advanced Renamer for Linux - runtime dependencies
================================================

These builds target Ubuntu 22.04 LTS or newer, on amd64 (x86-64) and
arm64 (AArch64). Download the ZIP matching your processor architecture.
The package names below are for Ubuntu 22.04; apt on newer Ubuntu releases
resolves renamed libraries through their compatibility packages.

Command-line application (arenc)
-------------------------------

Required packages for the CLI executable:

  libc6 (>= 2.35)   C runtime, math library and dynamic loader

Install with (apt also installs their dependencies):

  sudo apt update
  sudo apt install --no-install-recommends libc6

arenc does not require GTK, GLib/GIO, libglib2.0-bin, shared-mime-info, a graphical
desktop, an X display or xdg-utils. File type descriptions use built-in names
where available, otherwise the uppercase extension (for example, .JPG).

Feature-specific packages (CLI and GUI)
--------------------------------------

Install these when using the corresponding features:

  perl              Required for metadata read through the bundled ExifTool
  curl              Required for HTTP/HTTPS requests and downloads
  ca-certificates   Required for HTTPS server certificate validation

For all of these features:

  sudo apt install perl curl ca-certificates

These packages are not required just to launch arenc or perform basic filename
renaming. Keep Perl installed if your batches use ExifTool metadata.

Graphical application (aren)
----------------------------

In addition to the CLI runtime libraries, the GUI requires:

  libatk1.0-0
  libcairo-gobject2
  libcairo2
  libgdk-pixbuf-2.0-0
  libglib2.0-0       GLib and GIO libraries
  libglib2.0-bin     Supplies gio for moving files to the desktop trash
  libgtk-3-0
  libharfbuzz-gobject0
  libharfbuzz0b
  libpango-1.0-0
  libpangocairo-1.0-0
  shared-mime-info   MIME database for native file type descriptions

Install these GUI dependencies with:

  sudo apt install libatk1.0-0 libcairo-gobject2 libcairo2 \
    libgdk-pixbuf-2.0-0 libglib2.0-0 libglib2.0-bin libgtk-3-0 \
    libharfbuzz-gobject0 libharfbuzz0b libpango-1.0-0 libpangocairo-1.0-0 \
    shared-mime-info

The GUI also needs a graphical desktop/display. For desktop URL/file opening,
install xdg-utils. Optional: libgtk-3-bin supplies desktop/icon cache utilities.

Running from the ZIP
--------------------

Extract the complete ZIP, then open a terminal in the extracted directory:

  ./aren          # graphical application; requires a graphical desktop
  ./arenc -help   # command-line application

Keep Lang, ExifTool, license.txt and exiftool.json beside the executables.
ExifTool and its Perl modules are bundled. QuickJS is linked into the
executables. No system ExifTool, QuickJS, compiler or Lazarus is required.
The ZIP does not install desktop launchers, file associations or PATH commands.
Settings and undo logs use ~/.config/advancedrenamer/v4/Data/ (or
$XDG_CONFIG_HOME/advancedrenamer/v4/Data/), shared with the .deb installation.

The matching .deb contains both applications and declares their combined
dependencies, including the GUI libraries and feature-specific packages.
Install it with sudo apt install ./advancedrenamer_<version>_<arch>.deb if you
prefer automatic dependency resolution and desktop integration. Use the ZIP
for a CLI-only setup without installing the GUI dependencies.
