Getting started
Picketdesk organizes your Windows desktop into translucent, searchable containers called pickets. Ten minutes here takes you from the installer to a desktop that keeps itself in order — the ideas first, then the setup.
Concepts
| Term | Meaning |
|---|---|
| Picket | A container window on the desktop holding icons. Lives above the wallpaper, underneath every application window. |
| Portal picket | Mirrors the live contents of any folder (e.g. Downloads). Dropping files into it moves them into that folder. |
| Smart picket | Shows the live results of a search query (all PDFs, this week's
files). Contents update automatically, always scoped to your
desktop's top level — the widening flags (-g,
-r, -c) are stripped on save and ignored
if present. |
| Collection item | A file from anywhere on disk that a picket merely points at. It is never moved, copied or hidden — see collections. |
| Action zone | Processes dropped files with a pipeline: chain steps with
|> — built-ins zip, datestamp,
move:<folder>, toast:<msg>, plus any
%f shell command. |
| Tab | A picket drawn inside another picket (“Subtab under”); the host shows a tab bar and both pickets keep existing. |
| Free icon | A desktop item living outside any picket — an ordinary Explorer desktop icon that Picketdesk deliberately leaves alone. |
| Page (layout) | A named saved arrangement of all pickets you can switch between. |
| Rules | Your filing instructions: files matching extension / name / age / size are imported into a picket you choose. Edit the shipped examples or write your own — they start switched off, so nothing moves until you say where. |
Installation & lifecycle
Check the release version and signing status before downloading. Updates are manual: export a backup, then run the new installer in the same location — it asks a running Picketdesk to restore your files and close first, so there is no need to quit it yourself. See the complete update steps.
- Installer:
Picketdesk_<version>_x64-setup.exe— NSIS, per-user, no admin rights. Pickets are drawn by the Microsoft Edge WebView2 Runtime, which Windows 11 includes; setup does not install it. Without it, setup says so, offers to open Microsoft's WebView2 page (install the “Evergreen Bootstrapper” from there) and stops before installing anything; run it again afterwards. The uninstaller automatically restores every file Picketdesk hid. If a file stays hidden (a permission Picketdesk lacks, an offline drive), it tells you, the receipt on your Desktop lists it, and Picketdesk's records are kept even if you ticked “Delete the application data”, so the file can still be restored. When the data really is deleted — the box ticked and every file back — the uninstaller first leaves onepicket-backup.jsonof your pickets and pages on the Desktop (never over an existing one: thenpicket-backup (2).jsonand so on), since the folder it deletes also holds Quit's backups. After a reinstall, the welcome box offers to restore the newest-dated one, and Settings → Import… restores one at any time. (If one of your saved pages cannot be read, that page is left out and the newest Quit backup, which may still hold it, is copied beside it under the next free number. The current backup is dated now; the copied Quit backup keeps the date of the Quit that wrote it, so Explorer's Date modified tells them apart.) It never holds the uninstall up (20 seconds at most), and is not written on an update, with the box unticked (the default), or in a silent or passive uninstall. - Single instance: launching Picketdesk twice just re-shows your pickets — or, with no picket to show, opens the welcome box below.
- Before your first picket: the first launch after
installing, and every later click on the Start-menu shortcut while
Picketdesk is running with no picket to show, open a Welcome to Picketdesk box: the
tray icon sits in the notification area next to the clock (Windows may
tuck it under the ^ arrow), and a picket is made by dragging a
rectangle on empty desktop space or with the tray's
New picket. Yes creates an empty
picket; No leaves Picketdesk waiting in the tray.
When a backup of your pickets is on your Desktop (the
picket-backup.jsonan uninstall that deleted the application data leaves there), the box first offers to restore it, saying how old it is and what it holds: Yes restores it as Settings → Import… would, and each item goes back into its picket; No leaves the file where it is and asks the usual question. While you have no picket and have never dismissed the welcome card, any other launch (in practice the sign-in autostart) raises a Windows notification with the same directions instead of a box. - First run: one picket shows a short welcome card,
dismissed for good with Got it. It also offers
“See the safety net in action (30 s, on a throwaway file)”
— Picketdesk makes its own
picket-demo.txt, files it into that picket the ordinary way so its desktop icon disappears, and Bring it back un-hides it and sends the demo file to the Recycle Bin. None of your files are involved, and the offer is simply absent wherever the drill could not run honestly. A double click makes one demo file, not two, and Got it in the middle of the drill brings the demo file back and recycles it too. The card leaves that picket's keyboard alone: the arrows, type-ahead, Enter and Delete work on its files while it is up. - System tray: Picketdesk's home while running — see the tray menu.
- Start with Windows: a checkbox in the tray menu, on by default after the first run (turn it off once and Picketdesk won't turn it back on). It starts through a logon task that fires the moment you sign in, so the pickets are part of the desktop rather than arriving a minute later behind your other startup programs; older installs are moved to this mechanism automatically. The task is named for your Windows account, so on a shared PC each person's setting is their own — turning it on, off, or uninstalling never affects anyone else's. Installing a new version keeps your setting: when the version number changes the installer removes the old version first, and putting the task back afterwards is part of the install. An install into a different folder moves Start with Windows over to the new copy, so the old one never starts at sign-in; a task you disabled in Task Scheduler stays disabled. If you had it switched off, it stays off — also on a shared PC, where Picketdesk or its installer, run as administrator, can see another account's older task and never takes it for yours.
- Installing over a running Picketdesk: the installer
first asks it to close — the same full restore as Quit, without the
receipt on the Desktop and without a backup — and waits up to 30 seconds, so
your files are ordinary desktop files while the new version goes in.
The new version takes them back when it starts: from the finish
page's Run Picketdesk box, at your next sign-in when
Start with Windows is on, or right away after a silent
/Sinstall only if you add/R. A copy that does not close in time is stopped by the installer, and the next launch re-claims its files. - Double-click the desktop to hide and show all pickets: on by default, but you can switch it off in Settings → Desktop behavior. The tray icon and tray menu still toggle either way.
- Drag on the desktop to draw a picket: on by default. A desktop drag looks just like a marquee selection, so if the “Create picket” chip gets in the way, switch it off in Settings → Desktop behavior; the tray's New picket still works.
- Quitting restores an ordinary desktop: every file a picket held is shown again as a normal desktop icon on exit.
How pickets hold your icons (managed pickets)
A picket's files are hidden from Explorer (using the hidden + system file attributes) and Picketdesk draws their icons itself — at the desktop's own icon size and grid pitch, with real thumbnails and shell labels. That is why nothing trails behind a drag, a desktop sort can never leave holes in a picket, and no icon can be pushed off-screen.
Only paths Picketdesk hid are ever un-hidden — a file you hid
yourself is never touched — and three independent safety nets restore
them: a clean exit, a watchdog sibling process, and the manual rescue —
Start menu → Picketdesk - Restore desktop files (quits
Picketdesk), the --restore-icons flag underneath.
See Safety & recovery.
Command-line flags
The installer adds no command to your PATH: run these as
"%LOCALAPPDATA%\Picketdesk\picket-app.exe" <flag> for
the default install folder.
| Flag | Effect |
|---|---|
--restore-icons |
Un-hides every desktop file Picketdesk hid and exits — the rescue after a hard kill.
It never switches Windows’ own View → Show desktop icons: that setting is yours.
Silent (it reports in the Desktop receipt and picket.log);
add --show-result for a window with the result, as the
Start-menu entry does. Exit code 3: a file is still hidden; 4: a running
Picketdesk could not be closed, so nothing was restored. |
--safe |
Safe mode: icons untouched, no desktop mouse hook. |
--profile <dir> |
Runs with fully isolated state (workspace, index, settings, log) — used for testing. It never hides a file and never moves a real desktop icon, and its Quit un-hides nothing: the hidden files on the real desktop belong to the installed copy. Its tray's “Start with Windows” is greyed out for the same reason, and Settings → “Move configuration to another folder…” is refused: its configuration always stays in the profile folder, and the redirect marker belongs to the installed copy. The directory is required: with none, Picketdesk says so and exits rather than starting a second instance on your real pickets. |
Your first picket, in 30 seconds
- Press the left mouse button on empty desktop space and drag out a rectangle.
- Release. If real icons were inside your rectangle, a chip by the cursor offers “Create picket with N items” — click it to group them. The icons stay selected while the chip is up, so you can still drag them; anything else you do dismisses it. An empty rectangle offers “Create picket here”. The very first time you group files, a box titled “Before Picketdesk groups your files” then explains what grouping does and asks to go ahead.
- Double-click the new picket's title to name it. Drag more icons in whenever you like; drag one out onto the wallpaper to free it again.
From here, the tutorials walk through portals, rules, action zones, and moving a layout to another PC.