Skip to content

Latest commit

 

History

History
61 lines (41 loc) · 2.29 KB

TROUBLESHOOTING.md

File metadata and controls

61 lines (41 loc) · 2.29 KB

Troubleshooting

Flatpak

Snapshot relies on number of modern components which are under rapid development. Thus, in order to simplify debugging, please try the Flatpack from Flathub before reporting issues.

Pipewire

Snapshot exclusively uses Pipewire (from here on PW) to access camera devices.

Please restart PW to ensure all camera devices are found:

systemctl --user restart pipewire

A useful tool to look up information from PW is pw-dump. In order to check whether PW currently recognizes any camera devices, run:

pw-dump | grep default.video.source

If that is not the case, you may want to double-check that all required components for Pipewire camera support are installed, notably:

XDG Desktop Portal

Snapshot uses the camera portal to request camera access. There are desktop environment specific implementations for it, thus ensure to have the matching one installed:

If Snapshot can't find any devices, you can check camera permissions in various ways, a simple one being Flatseal.

Gstreamer

Snapshot uses GstPipeWire components. In order to list available cameras and additional information about them, look for entries that contain gst-launch-1.0 pipewiresrc when running:

flatpak run --command=gst-device-monitor-1.0 org.gnome.Snapshot Video/Source

for the Flatpak or

gst-device-monitor-1.0 Video/Source

for non-Flatpak installations.

In the later case, make sure to have the Gstreamer Pipewire plugin installed.

Logs

In case the issue persists you can get debug output for the application by running:

RUST_LOG=snapshot=debug,aperture=debug flatpak run org.gnome.Snapshot

If you file an issue make sure to include the version info from the "Troubleshooting" panel in the application's About dialog.