Module watch_path_display 

Provides user-friendly display names for watch paths.

Flatpak document-portal paths (/run/user/.../doc/...) are mapped back to their original human-readable folder names. Regular paths are shortened to their final component for compact UI display.

Functions

display_watch_path

Converts a stored watch path into a user-friendly label for display in the UI and logs.

display_watch_path_inline

Returns the full path for regular folders, or the folder name for Flatpak portal paths. Useful for contexts where the path is displayed inline (e.g., diagnostics, album linked folder) without a separate subtitle.

is_document_portal_path

Detects document-portal paths returned by the Flatpak file chooser portal.

watch_path_subtitle

Returns an explanatory subtitle for special watch paths, if applicable.