Linux Setup Guide — Sample Manager

Distro compatibility

The AppImage is built on Ubuntu 20.04, which links against glibc 2.31. Any distribution shipping glibc ≥ 2.31 can run it — older distros will get a hard "version not found" error on launch.

Tested distros are listed below. If yours isn't in the table, check your glibc version with ldd --version.

Distro	Minimum version	Works?
Ubuntu	20.04 LTS+	Yes
Debian	11 (Bullseye)+	Yes
Debian	10 (Buster)	No — glibc 2.28
Fedora	32+	Yes
Arch Linux	Rolling	Yes
Linux Mint	20+	Yes
Pop!_OS	20.04+	Yes
openSUSE Leap	15.3+	Yes
openSUSE Tumbleweed	Rolling	Yes
RHEL / Rocky / AlmaLinux	9+	Yes
RHEL / Rocky / AlmaLinux	8	No — glibc 2.28

Installation

Sample Manager for Linux is a single portable AppImage — no package manager, no root, no install step required.

1.

Download SampleManager-x86_64.AppImage from your dashboard.
2.

Make it executable:
chmod +x SampleManager-x86_64.AppImage
3.

Run it:
./SampleManager-x86_64.AppImage
You can also double-click it in your file manager if your desktop environment supports AppImage execution.

Activation: On first launch you'll be prompted to enter your license key. An internet connection is required only for this one-time step. The app runs fully offline after activation.

FUSE — the most common issue

AppImage type 2 requires libfuse2 to mount itself at runtime. Many modern distributions now ship only FUSE 3 by default, so you may need to install it manually.

Ubuntu / Debian / Mint

sudo apt install libfuse2

Needed on Ubuntu 22.04+ and any Debian-based distro shipping only FUSE 3.

Fedora

sudo dnf install fuse

Needed on Fedora 34+.

Arch Linux

sudo pacman -S fuse2

Install fuse2 (not fuse3) from the official repos.

Can't install libfuse2? You can bypass FUSE entirely by running the AppImage with the --appimage-extract-and-run flag:

./SampleManager-x86_64.AppImage --appimage-extract-and-run

System libraries

These libraries are not bundled in the AppImage and must exist on your system. Standard desktop installations typically include all of them — minimal or server setups may be missing one or two.

libasound2

ALSA audio interface. Almost always present on any audio-capable desktop. Required for all audio output.

libwebkit2gtk-4.0

Common missing

Required for the app's UI rendering. May not be installed on minimal Fedora or Arch setups — the app will crash on startup without it.

libX11, libXcomposite

Standard X11 display libraries. Present by default on any X11 or XWayland desktop environment.

Install missing libraries — Debian / Ubuntu

sudo apt install \

  libasound2 \

  libwebkit2gtk-4.0-37 \

  libx11-6 libxcomposite1

Install missing libraries — Fedora / RHEL

sudo dnf install \

  alsa-lib \

  webkit2gtk4.0 \

  libX11 libXcomposite

Wayland

Sample Manager uses X11 for display. It works correctly on all major Wayland compositors via XWayland, which is enabled by default on GNOME, KDE Plasma, and most other Wayland desktops.

XWayland (standard)

If your Wayland compositor runs XWayland — which the vast majority do — Sample Manager will launch and run without any extra configuration. You don't need to do anything.

Pure Wayland (no XWayland)

A Wayland-only setup with XWayland explicitly disabled is not supported. This is rare in practice — most compositors ship with XWayland enabled. If you've disabled it manually, re-enable it to run Sample Manager.

Desktop integration

AppImages don't install automatically. Create a .desktop entry to make Sample Manager appear in your application launcher.

Create a launcher entry

Move the AppImage to a permanent location first (e.g. ~/Applications/), then create the desktop entry:

mkdir -p ~/.local/share/applications

cat > ~/.local/share/applications/sample-manager.desktop <<EOF
[Desktop Entry]
Name=Sample Manager
Comment=Intelligent sample library manager
Exec=/home/$USER/Applications/SampleManager-x86_64.AppImage
Icon=sample-manager
Type=Application
Categories=Audio;Music;
EOF

update-desktop-database ~/.local/share/applications/

Replace the Exec= path with the actual location of your AppImage.

Some desktop environments (GNOME, KDE) support AppImage integration via tools like AppImageLauncher, which can handle desktop entry creation automatically on first run.

Troubleshooting

Run the AppImage from a terminal to see the full error output: ./SampleManager-x86_64.AppImage

App won't launch — "fuse: failed to exec fusermount3" or "fuse: device not found"

libfuse2 is missing. Install it for your distro (see FUSE setup above), or use the bypass flag:

./SampleManager-x86_64.AppImage --appimage-extract-and-run

App crashes immediately or UI is blank / broken

Most likely libwebkit2gtk-4.0 is missing. Install it:

sudo apt install libwebkit2gtk-4.0-37 sudo dnf install webkit2gtk4.0

App won't launch — "version 'GLIBC_2.3x' not found"

Your distribution's glibc is older than 2.31. Check the compatibility table above — if your distro version is listed as unsupported, you'll need to upgrade to a supported release.

No audio output

→Confirm libasound2 is installed and ALSA can see your audio device: aplay -l
→Check that your user is in the audio group: groups $USER. If not, run sudo usermod -aG audio $USER and log out.
→Make sure no other application holds exclusive access to the audio device.

Activation fails — "network error"

→Confirm outbound HTTPS (port 443) is allowed to mosylaudio.com.
→If behind a proxy, set HTTP_PROXY and HTTPS_PROXY before launching: HTTPS_PROXY=http://proxy:port ./SampleManager-x86_64.AppImage

Still stuck?

Reach out and we'll get you sorted.

← Back to Sample Manager