Skip to content

[Docs] Update Debian installation guide for Debian 13 (Trixie) & SwayFX 0.5.3 #475

@reazndev

Description

@reazndev

Description

The current Debian installation instructions (INSTALL-deb.md) are outdated for users running Debian 13 (Trixie/Sid). Following the current guide leads to multiple failures regarding package names, missing dependencies for the newer wlroots backend, and version mismatches.

Issues Encountered

  1. Package Name Changes: Debian Trixie uses stricter naming conventions (e.g., libgdk-pixbuf-2.0-dev instead of libgdk-pixbuf2.0-dev).
  2. Missing Dependencies: The wlroots 0.19 backend requires additional libraries not currently listed, specifically liblcms2-dev, libliftoff-dev, and libdisplay-info-dev.
  3. Build Method: The manual download method for dependencies is prone to version mismatch errors. The Meson Subprojects method is significantly more reliable for ensuring SwayFX 0.5.3 builds against the correct versions of SceneFX (0.4.1) and Wlroots (0.19.0).
  4. Runtime Linking: The guide lacks a sudo ldconfig step, which causes the binary to fail immediately after installation with error while loading shared libraries: libscenefx.so.1.

Proposed Solution

I have successfully built and verified SwayFX 0.5.3 on a fresh Debian 13 environment using the subprojects method.

I will submit the PR shortly!

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions