When using the AppImage version of Lychee Slicer, the lycheeslicer:// URL protocol is not registered automatically. This prevents the authentication flow from completing after logging in via the browser.


Two methods are available to fix this.


Method 1 — AppImageLauncher (recommended)

AppImageLauncher integrates AppImages into your system and handles URL protocol registration automatically.

  1. Download the appropriate package for your distribution from the AppImageLauncher releases page
  2. Install it — on Debian/Ubuntu-based distributions, run: sudo dpkg -i appimagelauncher_*.deb
  3. Run the Lychee Slicer AppImage as usual — AppImageLauncher will prompt you to Integrate and run, confirm it

The protocol is now registered and you can complete the authentication flow normally.


Method 2 — Manual registration

  1. Create a .desktop file at ~/.local/share/applications/LycheeSlicer.desktop with the following content:

Name=Lychee Slicer Exec=/absolute/path/to/LycheeSlicer.AppImage %u Type=Application MimeType=x-scheme-handler/lycheeslicer;

Replace /absolute/path/to/LycheeSlicer.AppImage with the actual path to your file.

  1. Set the default handler: xdg-mime default LycheeSlicer.desktop x-scheme-handler/lycheeslicer
  2. Update the application database: update-desktop-database ~/.local/share/applications
  3. Verify with: xdg-mime query default x-scheme-handler/lycheeslicer

Expected output: LycheeSlicer.desktop


You can now complete the authentication flow normally.