Skip to content

Bitpainter75/aimp-appimage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 

Repository files navigation

AIMP — AppImage

Unofficial AppImage builds of AIMP for Linux, packaged for portability across distributions including Bazzite, Aurora, CachyOS, and other modern Fedora/Arch/Debian-based systems.

This repository contains only the build script and releases.
AIMP is proprietary software by Artem Izmaylov. All rights reserved.


AppImages

Three separate AppImages are provided, each containing the full AIMP library tree:

AppImage Binary Description
AIMP-6.00-x86_64.AppImage AIMP Audio player
AudioConverter-6.00-x86_64.AppImage AIMPac Audio converter
AdvancedTagEditor-6.00-x86_64.AppImage AIMPate Audio tag editor

Download the latest release from the Releases page.


Usage

chmod +x AIMP-6.00-x86_64.AppImage
./AIMP-6.00-x86_64.AppImage
./AIMP-6.00-x86_64.AppImage /path/to/music.mp3

chmod +x AudioConverter-6.00-x86_64.AppImage
./AudioConverter-6.00-x86_64.AppImage /path/to/file.flac

chmod +x AdvancedTagEditor-6.00-x86_64.AppImage
./AdvancedTagEditor-6.00-x86_64.AppImage /path/to/files/

No installation required. All dependencies are bundled — no additional packages need to be installed.


Desktop Integration (optional)

The easiest and most modern way to manage these AppImages is using Gear Lever (available as a Flatpak on Flathub). It provides full desktop integration, updates, and automatic icon/menu generation without modifying your core system files. It is highly recommended for atomic/immutable distributions like Bazzite and Aurora.

Manual integration:

mkdir -p ~/.local/bin
cp AIMP-6.00-x86_64.AppImage ~/.local/bin/
# Give it executable rights, or let Gear Lever manage the file directly

Compatibility

Distribution / Target System Status Note
Bazzite / Aurora (Fedora 44) ✅ tested Smooth playback, all UI components working
Fedora 40+ ✅ expected Compatible thanks to bundled modern GNOME libs
Arch / CachyOS / Manjaro ✅ tested Out-of-the-box compatibility
Ubuntu 24.04+ / Debian 13+ ✅ expected Built on modern Ubuntu 24.04 glibc base
Older distros (glibc < 2.39) ❌ not supported Requires Ubuntu 24.04+ baseline

What's bundled

Beyond AIMP's own libraries from the official distribution archive, the build script additionally bundles the following system libraries that may be missing or carry a different SONAME across target distributions:

Library Source / Handling Reason
libbass-aimp.so Extracted from AIMP archive Part of the AIMP core package — not present on clean target distros
libavcodec-aimp.so.61 + libavfilter-aimp.so.10 + libavutil-aimp.so.59 + libswresample-aimp.so.5 Extracted from AIMP archive AIMP-specific FFmpeg libs — loaded by aimp_inputFFmpeg.so
libicudata.so.78 + libicuuc.so.78 Ubuntu 22.04 System (via Symlink mapping) SONAME-pinned to v78 compatibility layer for rolling-release targets
libxml2.so.16 Ubuntu 22.04 System (via Symlink mapping) New SONAME since libxml2 2.13 (Arch); Fedora 44 still uses .so.2
libglycin-2.so.0 Autodownloaded via Ubuntu upstream pool GNOME image loader — absent on KDE-based systems (Bazzite, Aurora)
libtinysparql-3.0.so.0 Autodownloaded via Ubuntu upstream pool Renamed from libtracker-sparql — not installed on KDE systems by default

LD_LIBRARY_PATH is set to $APPDIR/opt/aimp by AppRun so bundled libs are isolated and preferred over target system libraries.


Build it yourself

Prerequisites

The script utilizes a "No-Install" methodology. You do not need to install AIMP on your host system. For maximum portability (targeting lower glibc 2.35), it is recommended to run the build script inside an Ubuntu 22.04 Distrobox environment.

The script automatically detects, updates, and installs missing build-essential packages (curl, zstd, etc.) inside the container environment.

Build

  1. Download the official AIMP for Linux package (.tar.zst, .tar.gz or .tar.xz) from the AIMP Download Page.
  2. Clone this repository, place the downloaded archive in the same directory as the script, and execute it:
git clone https://github.com
cd aimp-appimage

# Ensure the archive is in this folder, then run:
./build-appimages.sh ./aimp-6.00-3075b-x86_64.pkg.tar.zst

The three standalone AppImages (~70 MB each) will be outputted directly to your current working directory.

What the script does

  1. Validates and installs missing system components (apt/sudo handling) automatically.
  2. Unpacks the AIMP source archive into an isolated, temporary sandbox directory.
  3. Automatically downloads and pre-extracts missing upstream target libraries (libglycin, libtinysparql) into the portable bundle.
  4. Generles and injects custom AppRun scripts to configure modern cross-distro library execution.
  5. Strips secondary component Actions from the core aimp.desktop profile for clean application menu mapping.
  6. Packages the independent target directory paths into fully self-contained AppImage builds.

User data

AIMP stores all user data in the home directory — the AppImages do not modify any system files:

Data Path
Configuration ~/.config/AIMP/
Library / playlists ~/.local/share/AIMP/

Links

About

Unofficial AppImage builds of AIMP for Linux, packaged for portability across distributions including Bazzite, Aurora, and other Fedora-based systems.

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages