Search & the command palette
A fast local index covers your desktop, portal folders, and any extra roots you add — filenames, file contents, even text inside screenshots. Nothing ever leaves your machine.
In-picket search
Plain filename searches respond after a shorter typing pause than flagged queries. Content, recursive and other flagged searches keep their existing pause to avoid starting expensive work on every keystroke.
Click the magnifier in a picket's title bar (or the picket menu →
Search this picket). Plain terms match the picket's items — AND-combined,
case-insensitive. Quote "literal terms" to match exactly.
In a portal, search covers the folder currently open in its breadcrumbs;
-r includes its subfolders. A smart picket searches its
current matching items. A regular collection searches its references,
including folders outside the Desktop; -r searches inside them.
An empty search box leaves the grid its keys: until you type, the grid is still on screen, and once a tile has focus Enter, Delete, F2, the arrows and type-ahead work as usual; Esc from the grid closes the empty box. As soon as you type, the results replace the grid and the keys belong to the search box.
Result limits and order
Picket search and the global overlay show at most 200 filename
results. A notice appears if another match was found beyond
those 200; exactly 200 matches does not trigger it. Content search stops
at 200 matching files and reports that the limit was
reached; there may be more. Narrow your terms, use -t, or
search a smaller folder to check other matches. These limits are
separate from the grid's 1,000-item More/Back pages.
Ordinary content snippets show up to three matching lines per file, with each line limited to 240 characters. Image OCR uses a shorter excerpt of up to 120 characters.
Plain filename searches prefer exact names, then prefixes, word-start matches and matches inside a name. Among equally good matches, Picket's recorded open frequency and recency help break ties, followed by name length and name. This history records opens through Picket and is stored in the workspace. Results need not be alphabetical or follow the picket's grid sort. This relevance ordering does not describe content or regex results.
PDF/Office text and image OCR caches use file size and the full modification
timestamp, so quick same-size edits invalidate old text. A file changed
during extraction is skipped until the next search. Precision depends on
the filesystem; older OCR cache entries are rebuilt when needed. A
document whose text cannot be read (damaged, password-protected, a
PDF the reader cannot parse, or an Office file whose zip container is
not the plain kind Office writes: ZIP64 end records, a part listed
twice, data before the archive, or a directory entry whose extra field
is malformed, holds more than 16 sub-fields or 1 KiB, or repeats the
ZIP64 field) is tried once per version: it matches nothing until the
file changes, and picket.log names it once.
PDFs are read by a second, short-lived picket-app.exe
that exits as soon as it has answered and is stopped after 30 s.
Picketdesk also requests a 1 GB memory limit through a Windows job
object: with it in place, a PDF that unpacks past 1 GB ends the
helper and costs only that file's text. If Windows refuses that
limit, the helper still reads PDFs
without a memory cap, and picket.log
warns once per session if the helper returns before the timeout.
The timeout still applies, but a crafted PDF
may consume substantial memory before it expires. Running the reader
separately protects Picketdesk from a crash in the PDF reader. You may
see it in Task Manager during a content search; ending it is
harmless.
Search flags
Flags combine anywhere in the query, and can be bundled
(-rc = recurse + content):
| Flag | Meaning |
|---|---|
-r | Recurse into the picket's folders, including a full picket of 1,000 folder items. |
-g | Global — search everything indexed, not just this picket. |
-c | Content search inside files — streams results
live; includes PDF, Word, Excel and PowerPoint text, and OCR of
png/jpg/jpeg/bmp images; skips binaries, files over 4 MB, and cloud
placeholders. A document's text is searched up to its first
8 MB. It searches contents only, never names, and several words
are one phrase: q3 report -c finds “q3 report” in that
order. |
-e | Treat the terms as a regular expression. |
-t pdf,txt | Restrict to extensions. |
-d 30 | Created or modified within the last N days — a file copied onto the desktop today counts, even though Windows kept the original’s write time. |
Those are the whole set — anything else after a - is
reported as an unknown flag rather than silently ignored.
-t and -d take a value, so they must come last
in a bundle (-rt pdf works, -tr pdf does not).
Examples:
| Query | Finds |
|---|---|
invoice -c -t pdf | PDFs containing the word “invoice”. |
-g -t png -d 7 | Every PNG modified this week, anywhere indexed. |
report -rc | “report” inside files (contents only — a -c search never matches names), recursing into folders. |
-e ^IMG_\d+ | Names matching a regular expression. |
Results show icon, name, path, size, and date; content hits show the
matched lines with line numbers and highlights — screenshot text matches
show a 🖼 snippet. Right-click any result for the full item menu.
↓ from the search box walks the results and
Enter opens the lit one — the keyboard route to a
-g/-r hit the grid does not draw. Nothing is
lit until you press ↓, so an Enter while you
type still opens nothing; ↑ from the first result goes
back to typing. The keys only walk results that are on screen: on a
rolled-up picket ↓, Enter and
Ctrl+Enter do nothing until you expand it — or
while a hover on its bar has it unrolled, when its results show and
the keys work — and a locked
private picket cannot be
searched at all. Screen readers hear the lit row as ↓
moves.
Ctrl+Enter turns the results into a real selection:
the matching items in this picket become the grid selection and the
search closes, so a query like -t zip -d 365 flows
straight into the bulk actions (move, tag, Delete, drag). Only items
the grid actually draws are selected. Click
★ to save the query as a
smart picket. Note that a smart picket
always views your desktop and never reads inside files:
-g, -r and -c are stripped when
the query is saved and ignored if present, while terms,
-t, -d and -e carry over
(-d still means created or modified). The
picket is named after the query's terms, not its syntax. See
why. A query with nothing left
to filter by once those are stripped (-g alone, or a bare
-e) is not saved: it would list, and hide, your whole
desktop, so a toast asks for words, -t or -d
instead.
The global overlay — Ctrl+Shift+F
Search everything from anywhere: ↑↓ select, Enter opens, Esc closes, right-click menus and all flags work. An empty query shows your 15 most recently modified files (a private picket's files are left out, and the next newest take their places) — often all you need, and the arrow keys walk them too: Ctrl+Shift+F, Enter reopens the file you changed last. The overlay dismisses on focus loss, but not for its own menus: right-click a result and choose Explorer menu… and the overlay waits behind it, taking focus back if you dismiss that menu without picking anything.
An Apps row above the results launches Start Menu
programs by name — type code → Visual Studio Code. It
shows up to four, from the Start Menu as Picketdesk found it at
launch (a program installed since appears after the next start), and
never an uninstaller's shortcut. Click
an app, or press ↑ from the first result to reach the row
(↑ again for the next app) and Enter to launch
it. Enter on its own still opens the first file; when no
file matches at all, it launches the top app. Changing the query removes
the previous query's apps from the row and keyboard selection while new
results load. Screen readers hear the
lit row — a recent file, a result or an app — as
↑↓ move.
On more than one screen, the overlay opens centred on the monitor your cursor is on, inside that screen's work area and sized for its DPI — press the chord while working on the second monitor and the launcher is there, not on the primary one. The page-switch strip follows the same rule.
The command palette
Type a command into the overlay instead of a search — Enter runs it; anything unrecognized stays a search. Repeated Enter presses while a command is running do not submit it again, and its reply keeps any text you typed afterwards:
| Command | Does |
|---|---|
move report.pdf to Work | Moves a file into a picket. For a file that is already there the palette answers that “report.pdf” is already in “Work”, and a move that cannot happen answers “Could not move …”; neither adds a step to undo. |
remind report.pdf 2h | Sets a reminder — durations like 30m, 2h, 1d, 1d2h. One that would fall after the year 9999 is refused, and the palette says so. |
new picket Taxes | Creates a picket. |
tag report.pdf green | Tags a file (red / orange / yellow / green / blue / purple; none clears). |
go Work | Focuses that picket (unrolling it if rolled up). A picket hidden by any mode stays hidden — the palette says so instead. A tab is shown in the picket that holds it, which is the one focused, unrolled or reported hidden. |
pin Work | Pins / unpins a picket (ignores hide-all). |
rollup Work · rollup all | Rolls a picket (or every picket) up or back down. |
sort Work by size | Sorts a picket — name, type, date, size, usage, manual. Add asc or desc to set the direction (sort Work by date asc is oldest first); manual order has none. |
page Gaming | Switches to a saved page (a pre-change snapshot is taken first). |
snapshot | Saves a layout snapshot into the time machine. |
organize | Runs an organize sweep now. |
undo | Undoes the last Picketdesk batch — the same 20-step stack Ctrl+Z and the tray use, reachable with nothing focused. Answers “Nothing to undo” on an empty stack. |
focus | Toggles Focus mode. |
Picket and page names resolve fuzzily (exact beats prefix beats
substring), and while you type one the overlay offers matching
titles — Tab accepts the first suggestion.
move, tag and remind never find a
file in a private picket — the palette has no Windows
Hello prompt, so they answer “No item matching …” as if it were not
there.
Inbox triage
The overlay's Inbox button lists the files that arrived since your last cleanup — the newest 60 desktop files created or modified (a file copied onto the desktop counts from the copy) since you last pressed Done — mark all triaged or Reset marker to now (both set the marker to now) — triaged entirely from the keyboard:
| Key | Action |
|---|---|
| 1–9 | File into one of your first nine regular pickets, in list order (portals, smart pickets, action zones and tabs are not numbered): the number-row key marked with the digit, with or without Shift (an AZERTY keyboard needs no Shift), or the keypad with Num Lock on. |
| R | Remind me tomorrow. |
| Del | Recycle. |
| Enter | Open. |
| S | Skip. |
“Done” marks everything triaged. The digits, R and S are single keys: held with Ctrl, Alt or the Windows key they do nothing. The keys act on the highlighted row, never through a button: with “Done” or “Reset marker” reached by Tab, Enter presses that button and the triage keys wait until focus is back on the list (Esc still leaves triage). One key at a time: a key pressed while the last one's file is still being filed, reminded or recycled is ignored, so it never acts on that same file twice. A filing refusal keeps the row available and reports why; only a confirmed filing removes it. A Del that recycled nothing (a No to Windows' own confirmation, a locked file) leaves the file listed and highlighted; a file already deleted outside Picketdesk leaves the list.
Reminders
The overlay's Reminders button lists every reminder you have set — the ones that have already gone off first, each group oldest first. A reminder is no longer thrown away the moment it fires: it keeps its ⏰ badge on the item and waits here until you deal with it, with Open, +1h, Tomorrow (both measured from now, not from when it was due) and Clear on each row. ↑↓ picks, Enter opens, Del clears, Esc goes back — on a row's button reached by Tab, Enter presses that button instead, and a mouse click on one leaves the keys with the list. The button turns amber while anything is waiting.
Settings → Export reminders (.ics) writes pending reminders to a new calendar file, preserving any existing export. Calendar identities survive rescheduling, file renames and restarts. Older reminders receive saved identities on their first export; a failed workspace save stops the export so a later restart cannot forget them.
This is the surface that always works. The Windows notification a due reminder posts stays in Action Center, but Windows gives Picketdesk no way to hear a click on it, so nothing about it is actionable.
The index
- SQLite, covering your desktop trees, portal folders, and any extra
roots added in Settings — around 120 k entries is typical. Each
root is indexed to at most 200,000 entries and 16 folder levels
deep; a walk that reaches the cap stops there and
picket.logsays so. A whole drive (C:\) is not a valid root and is refused; a save that refuses one now says so under the field and re-fills the box from what is stored, instead of flashing “Saved” over a line it threw away. - Crash-safe generational rebuilds; an incremental startup
refresh rescans only changed directories; a file watcher keeps
it live. A folder a scan could not read (its permissions, an antivirus
lock) is not counted as scanned: the next refresh that can read it
rescans it and every folder below it in full, so files that arrived in
it meanwhile still reach search. A file or folder renamed in letter
case only while Picketdesk was stopped (
Report.TXTtoreport.txt) keeps one entry, under its new spelling, and a renamed folder's contents follow it; in a case-sensitive folder, names that differ only in case stay two files with two entries. - The watcher checks itself. Every 30 seconds Picketdesk compares the
top level of each desktop folder with what the watcher reported. If
a file appeared or vanished without a report (a huge unzip into a
desktop folder, or a network Desktop after a VPN drop or sleep), it
restarts the watch, catches up the index and the desktop, and says
so in
picket.log. - A folder you add while Picketdesk is running — a new portal picket, or a new extra root in Settings — is indexed and watched straight away, so it is searchable within seconds and stays fresh. No restart.
- Closing a portal picket stops watching its folder — unless another picket still shows it, a portal sits in a subfolder of it, or it is on your extra roots list. Anything still using the folder keeps getting live updates. Removing one of two overlapping roots keeps indexed files covered by the remaining root and refreshes that coverage on the next scan. Files the remaining root does not index itself, because they sit in a hidden, dot-named or ignored folder, leave search with the removed root.
- A root reached through an alias, such as a junction or mapped path, remembers its last resolved location across an offline restart, so temporary unavailability does not discard its cached filename rows. Picket filename and content searches use that location and return paths with the picket's spelling. Links inside the root are still excluded. Removing the root clears its mapping; retargeting it removes the old location's rows unless another root covers them. If an older index has no remembered mapping for an offline root, the cached locations no mapping names stay until the configured roots resolve or are removed; a portal or root this version has reached is still dropped as usual when you close or remove it. Picket-scoped queries through that alias need its first successful resolution.
- Ignore lists (folders like
node_modules, extensions likeclass, written without the dot) are editable in Settings and trigger a background reindex. Both lists match regardless of letter case, accented letters included (PDFleaves outinvoice.pdf,ärchivleaves outÄrchivand everything in it), and an extension typed as.pdfor*.pdfcounts aspdf; a folder name keeps its dot (.gitis a folder). The first start of this version re-walks every root once if the lists hold a rule that now matches more than it did. If a reindex is already running, a full rebuild follows it using the latest folders and ignore rules. Repeated requests share one pending follow-up; existing results remain searchable while it runs. - Cloud placeholders are indexed by metadata only — searching never hydrates OneDrive files; the text search, the screenshot OCR pass and the duplicate finder all skip dehydrated files.
- Screenshot OCR uses the OCR engine built into
Windows on png, jpg/jpeg and bmp files; recognition is cached per
file (a first search over many new images does up to 40, the rest on
the next run) and skips images over 8 MB. It takes plain terms only
(a
-esearch skips it), and an image matches when every term appears anywhere in its text — not necessarily side by side, as in a document. The 200-file limit covers images and documents together. It reads the images your pickets hold too: a filed screenshot is hidden from the desktop, not from the search. An image it could not open this time (no OCR language installed yet, a file another program holds) is tried again on the next search, never remembered as having no text. Local only. Result snippets show the original text around the match, including when Unicode case conversion changes its byte length, with up to 40 preceding characters in a 120-character excerpt.
ocr-cache.json in the machine-local cache folder,
%LOCALAPPDATA%\com.picketdesk.app — never beside a workspace
that cloud sync or a redirect shares between PCs (an older build kept it
there; that copy is moved at launch). That is a plain-text record of
every screenshot a content search has opened. It is capped at 2,000
images and drops entries for images you delete, and
Settings → Search text inside images (OCR) — on by
default — skips the pass and deletes the file when you untick it.
Older queued or running searches cannot recreate it; turning OCR back
on permits new searches. Startup and a backup or snapshot with OCR
disabled also clear the transcript. An ordinary page change preserves
preferences saved while that page was loading.
-c covers text formats, PDF, .docx (body,
headers, footers and footnotes), .xlsx (cell text),
.pptx (slide text), and image OCR. The pre-2007
.doc/.xls/.ppt formats are not
covered, and a formula’s computed result is not text Excel stored, so
it is not searched either.