Build distrobox for calibre 8

 Phase 1: Create the Fedora 41 Distrobox

Run these on your Bluefin host terminal. We use Fedora 41 for library stability and a custom home to keep your config isolated.
bash
# 1. Create the container
distrobox create --name calibre8 --image registry.fedoraproject.org/fedora-toolbox:41 --home ~/distrobox/calibre8

# 2. Enter the container
distrobox enter calibre8
Use code with caution.
Phase 2: Install the "Dependency Gauntlet"
Run these inside the calibre8 container. These are the specific Fedora packages that satisfy Calibre 8's requirements for X11, OpenGL, and WebEngine.
bash
# 1. Update and install all required system libraries
sudo dnf install -y \
  wget xz python3 xdg-utils \
  xcb-util-cursor.x86_64 libxcb.x86_64 xcb-util-renderutil.x86_64 \
  xcb-util-image.x86_64 xcb-util-keysyms.x86_64 xcb-util-wm.x86_64 \
  libglvnd-opengl.x86_64 libglvnd-egl.x86_64 libglvnd-glx.x86_64 mesa-libGL.x86_64 \
  nss.x86_64 nss-util.x86_64 nspr.x86_64 atk.x86_64 at-spi2-atk.x86_64 \
  cups-libs.x86_64 libdrm.x86_64 mesa-libgbm.x86_64 \
  libXdamage.x86_64 libXrandr.x86_64 libXcomposite.x86_64 libXft.x86_64 libXtst.x86_64 \
  freetype-devel.x86_64 fontconfig.x86_64 libxshmfence.x86_64 pango.x86_64 \
  libxkbcommon-x11.x86_64 libxkbcommon.x86_64 libxkbfile.x86_64 \
  alsa-lib.x86_64 dbus-libs.x86_64 libXScrnSaver.x86_64 \
  at-spi2-core.x86_64 mesa-dri-drivers.x86_64

# 2. Create missing directories for the installer's icon script
sudo mkdir -p /usr/share/desktop-directories/ /usr/share/icons/hicolor/
Use code with caution.
Phase 3: Install Calibre 8.16.2
Run these inside the container to pull the specific version that matches your FreeBSD setup.
bash
# 1. Download the installer script
wget -O calibre-installer.sh https://download.calibre-ebook.com/linux-installer.sh

# 2. Run the installer targeting version 8.16.2
sudo sh calibre-installer.sh version=8.16.2
Use code with caution.
Phase 4: Export & Integration
Run this inside the container to add Calibre 8 to your Bluefin App Menu with the necessary flags to fix the Wayland/Sandbox issues.
bash
# Export with the Sandbox and XWayland compatibility flags
distrobox-export --app calibre --extra-flags "--env QTWEBENGINE_DISABLE_SANDBOX=1 --env QT_QPA_PLATFORM=xcb"
Use code with caution.
Critical Maintenance Tips
  • Accessing your Books: Inside the box, your real home folder is at /var/home/tim/. Point Calibre to your library there.
  • Database Warning: Never open this library with a Calibre 9.x app (like the default Flatpak). It will upgrade your metadata.db and break compatibility with your FreeBSD machine.
  • App Icon: If the icon doesn't show up immediately, run systemctl --user restart plasma-plasmashell (KDE) or log out and back in (GNOME).