FAQ & Troubleshooting

The desktop entry caches need to be refreshed. Run:

update-desktop-database ~/.local/share/applications
gtk-update-icon-cache ~/.local/share/icons

Or log out and back in. Some desktop environments (Plasma, GNOME) detect new entries on the next login automatically.

".adsl files open in an archive manager instead of AuraDeck."

The MIME type registration did not take effect. Check that the registration is in place:

xdg-mime query default application/x-auradeck-slides

Should return celray-auradeck.desktop. If it does not, re-run the install script:

./linux/install-mime.sh

If the file is still detected as a generic zip (application/zip), your file manager may be using content-based detection instead of extension-based. Right-click the file → Properties → set the default application explicitly.

"I see a generic icon instead of the AuraDeck logo on `.adsl` files."

Icon caches lag behind MIME registration. After install-mime.sh:

gtk-update-icon-cache -f ~/.local/share/icons/hicolor
update-mime-database ~/.local/share/mime

If you still see a generic icon, your file manager may cache thumbnails per-file. Open a fresh directory or restart the file manager.

"The build fails with `webkit2gtk-4.1` not found."

Install the webview development headers for your distribution:

# Debian/Ubuntu
sudo apt install libwebkit2gtk-4.1-dev libsoup-3.0-dev build-essential

# Fedora
sudo dnf install webkit2gtk4.1-devel libsoup3-devel

# Arch
sudo pacman -S webkit2gtk-4.1 libsoup3 base-devel

The full list is on the Tauri prerequisites page.

"Slides look fine in the editor but blank in PDF export."

This is almost always a font-loading issue. The exporter uses html2canvas, which renders synchronously and does not wait for @font-face resources to load over the network. Fix it by:

Switching to system fonts (system-ui, sans-serif).
Embedding the font as a base64 data: URI inside the @font-face declaration.

"My slide animations do not play in PPTX export."

PPTX exports are static images — animations and JavaScript do not survive. This is a fundamental limitation of the PPTX format. Use PDF for the same reason if your slides depend on motion. Share the source .adsl file or a screen recording for fully-fidelity playback.

"The presenter window opens on the wrong monitor."

AuraDeck does not pin windows to specific displays. Drag the audience window to the projector, then press F6 to spawn the presenter window — it will open on whichever monitor your cursor is on. Future versions will remember the layout per-deck.

Two options:

Export to PDF or PPTX (Exporting). They get a frozen snapshot but can flip through the deck in any PDF viewer or PowerPoint-compatible app.
Send the .adsl archive with a link to the install instructions. Best for technical audiences who want the live experience.

"Where are my recently-opened decks stored?"

In the platform-standard config directory:

Linux: ~/.config/com.celray.auradeck/
macOS: ~/Library/Application Support/com.celray.auradeck/
Windows: %APPDATA%\com.celray.auradeck\

The recents list is a small JSON file you can inspect or delete.

Still stuck?

Open an issue at github.com/celray/auradeck/issues with your platform, AuraDeck version, and what you tried. Logs from RUST_LOG=auradeck=debug ./auradeck are especially helpful.

"AuraDeck does not appear in my application menu after install."