Preferences gains two pages for the config.json settings that had no place in the app: - Sync: the patterns every synced folder leaves out (own patterns, and each built-in one on or off), and what the conflict sweep may do. - Apps: which program opens which kind of file (open_with), and how the search launcher opens (prompt). Each synced folder kept on this computer gets "Excluded Files…" in its menu for its own .pdfsignore: checked as typed, "Check a path" says which rule decides, and a version changed elsewhere is never written over without asking. `pdfs sync ignore list|add|remove|reset|check` does the same from a terminal, and `--page preferences-sync` (and -apps, -storage) opens Preferences at a page. Every writer of config.json now goes through AppDirs::update_config, which reads, changes and writes under an flock on config.json.lock, so the app, the tray and the daemon no longer undo each other's change (B292). The opener reads its rules on each open, so a new rule applies without a restart. The built-in ignore list also leaves out what Nextcloud, Dropbox and Syncthing leave out: desktop.ini, .directory, trash folders, NFS/FUSE leftovers, partial downloads, Kate swap and office lock files.
3.5 KiB
Search launcher and tray
The search launcher finds files in Proton Drive and in your home folder from a keyboard shortcut. The tray icon shows whether everything is up to date and gives quick access to the app.
Search launcher
pdfs-prompt searches Proton Drive and your home folder together, in one list with the best
matches first. It copes with prefixes, abbreviations, typos and swapped letters, and also matches
the names of parent folders.
To set it up, bind pdfs-prompt to a keyboard shortcut in your desktop's settings.
The window stays loaded after the first use, so later shortcuts open it instantly. Folders, music
and videos open straight from ~/ProtonDrive, so players can start before the whole file is down.
Other files from Proton Drive download first, then open.
To make even the first shortcut instant, start the launcher hidden when you log in.
pdfs-prompt --preload loads the window without showing it, and does nothing if the launcher is
already running. For example, in Hyprland:
exec-once = pdfs-prompt --preload
bind = SUPER, space, exec, pdfs-prompt
Which program opens a file can be changed per file type. See Choose which program opens a file.
Using your own launcher
pdfs-prompt --dmenu shows the results in fuzzel, rofi, wofi, tofi, bemenu or dmenu, whichever is
installed:
pdfs-prompt --dmenu
pdfs-prompt --dmenu --menu 'fuzzel --dmenu --width 60'
pdfs-prompt --dmenu --query invoice
These launchers filter a fixed list and cannot ask for new results while you type, so the search takes two steps:
- The first list,
Search Drive ›, shows your available-offline files. Type a search and press Enter. - The second list,
Drive: invoice ›, shows the results. Enter opens one. Typing something else searches again.
Search as you type with fzf
pdfs-prompt --fzf searches again on every key press, like the built-in window. It needs fzf.
Started from a keyboard shortcut, it opens a terminal by itself (foot, ghostty, kitty, alacritty,
wezterm or xterm) with the app ID pdfs-prompt, so one window rule covers all of them. For
example, in Hyprland:
windowrulev2 = float, class:^(pdfs-prompt)$
windowrulev2 = size 900 500, class:^(pdfs-prompt)$
windowrulev2 = center, class:^(pdfs-prompt)$
bind = SUPER, space, exec, pdfs-prompt --fzf
To make --dmenu or --fzf the default without changing your shortcut, pick it in
Preferences → Apps → Search Launcher, or set prompt.mode in config.json (see
Configuration → prompt). --gtk always opens the built-in window.
Which program opens a file you pick is set under Preferences → Apps → Open Files With.
Tray
pdfs-tray starts when you log in and shows whether your files are up to date, syncing, paused or
offline. Its menu opens the app or ~/ProtonDrive, pauses or resumes sync, and stops or connects
the service.
- GNOME shows tray icons only with the AppIndicator extension. KDE Plasma and most other desktops show it without help.
- Hide Tray Icon in its menu removes it until you turn it back on under Preferences → General → Appearance → Show tray icon.

