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

TermMeaning
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.
You stay in charge of every file Items are always real files on your desktop (or in the portal's folder), and grouping one never moves it. It does change one thing: Picketdesk hides the file's desktop icon — the Hidden + System attributes, plus a claim marker so only files it hid are ever un-hidden — so while a file is grouped it is also missing from File Explorer's Desktop folder and from Open and Save dialogs (Picketdesk says so before your first grouping; the FAQ has the ways around it). A file moves when you move it, when you run Organize, or when an automation you set up fires: a scheduled sweep, or a picket's Self-clean policy (blank destination = the Recycle Bin). Close a picket whenever you like; its icons step straight back onto the desktop, and a file that already carried the System attribute before it was grouped keeps it.

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.

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.

FlagEffect
--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

  1. Press the left mouse button on empty desktop space and drag out a rectangle.
  2. 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.
  3. 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.