WinShun features
Everything WinShun does, area by area. Back to the README; screenshots are in docs/截图.md. A step-by-step guide (in Chinese) is in docs/使用说明.md.
On a fresh install the search bar beside Open / Save dialogs, the folder menu and typing to search in File Explorer start switched on, as Listary has them (0.36.0; an upgrade keeps what you had), each a card under Settings › Plugins › Installed › Built-in features where it can be turned off. Some extras start switched off: Paste as file, the clipboard history taking over Win+V, the taskbar search box and the system switches. Plugins described as in the plugin library are installed from Settings › Plugins › Plugin library.
File search
-
An empty search panel (0.28.0): "List all files in the empty search panel" under Settings › Appearance › Size and layout (on by default) can be turned off, so the panel lists nothing until something is typed.
-
Query history. The clock button opens the last 100 completed queries.
Ctrl+Up/Ctrl+Downbrowses them and restores the previous draft at the newest position. Settings can choose Alt with the arrows or disable the keys. Delete individual entries or clear the list. Plugin keyword searches such as= 3*7are kept too and run again when picked; the hash and Base64 keywords, where passwords get typed, are not. History follows the usage-recording switch. -
Open windows. In All, sorted by relevance, matching current window titles and program names appear first. Enter activates the selected window, including a minimized one.
-
Minimal empty search. Enable Pure search mode under Appearance › Size and layout to keep only the input bar when empty. Results and the scope tabs return as you type; the history and expand buttons stay hidden, their shortcuts still work. Beside it, Scope tabs › Merged turns All / Files / Content into one button that names the current scope: a click or
Tabgoes to the next. Both start off. -
Typing on the desktop. With "Type to search on the desktop" on (Settings › Integration › File managers, off by default), a key typed while the desktop's icons have the keyboard opens the box to search the whole PC. Not while an icon is renamed or a menu is open, nor with
Ctrl,AltorWinheld. -
No delete button. "Show the delete button" under Settings › Result list (on by default) can be turned off: rows of files and folders then end without the bin; delete from More options in the right-click menu.
-
Merged scopes and panel controls. Optionally merge All and Files and filter file kinds in All. Hold Ctrl to see kind keywords. Assign a direct panel hotkey under Settings › Shortcuts › Open WinShun, and use the panel's filter button to collapse its sidebar while retaining active filters.
-
Speed: press Ctrl twice (or Alt or Shift twice, if you prefer); a search over three million files takes milliseconds.
-
Pinyin:
ndbgfinds 年度报告; a mistyped homophone (年度报高) is retried by sound. A setting can switch the input method to English each time the search box opens, so letters go straight in. -
Where: all local drives, USB drives and external hard disks if you like (including disks that report themselves as fixed, such as most USB enclosures; an unindexed one that is plugged in is offered at the end of the list), and NAS / SMB network shares and WebDAV folders (a NAS's WebDAV, cloud drives such as Jianguoyun), still searchable while their server is off and reconnected by themselves after it restarts; turn on “Search file contents” on a location's card to search inside its files. On a PC without administrator rights it indexes only the folders you choose (see Administrator rights below). A directory link, junction or mounted folder (
mklink) that leads to what is indexed nowhere else (a disk not chosen, a volume without a letter, a share not set up) is indexed under the link's own path and followed live, links made later too (0.32.0, needs the new index service; at most 256). Disks indexed by walking (no MFT read) find their links too, during the walk and as they are made (0.34.0). A link to a folder on a disk that is indexed already is walked under its own path too, as when you add that folder by hand, so the link's path finds what is in it; these are left out: Windows' own compatibility links (hidden or system, such asC:\Documents and Settings), links to a whole disk, loops back to the link or a folder above it, and links inside tool folders such asnode_modulesor.git(pnpm and npm make thousands there). A link to a network share that is set up already is still not taken twice. -
Order: your own files first, the date modified on each row,
Ctrl+Sfor best match / newest / oldest, and More in the footer sorts by name, folder, type or size. Click a result once to select and twice to open, if you would rather not open one by mistake (a setting). Recent files are listed when the box is empty, or nothing if you like; the search can also start empty each time it opens. A folder with nothing in it says “Empty folder” at the row's end and a 0-byte file “Empty file”, so you need not open them to find out (0.38.0; told from the index, never the disk; hidden folders and network shares are not marked). -
Programs first:
curllistscurl.exebefore the foldercurlandcurl.h; which file types go first is yours to change (exe, bat, cmd, ps1 and msi to begin with, like Listary's preferred file types). -
Learned order: one opening improves later matching searches for the same app or file, across Chinese names, pinyin and initials. Old preferences decay. Type
settingsorconfig, or pressCtrl+,, to open WinShun settings; a plugin's name withsettings(translate settings) opens that plugin's card in them (0.38.0). These rows are remembered like any other, and can be kept among the favorites with a keyword of your own;Ctrl+Shift+Con one copies itswinshun://link. -
Keyboard navigation:
Ctrl+J/Ctrl+Nmoves down;Ctrl+K/Ctrl+Pmoves up;Ctrl+U/Ctrl+Dpages up / down.Ctrl+Shift+Dswitches current-folder filtering. -
Shortcuts:
Ctrl+1…Ctrl+9opens a visible result (or chooseAlt). Numbers are visible by default in a separate column before the icons; choose hold-only or never in settings. Existing display choices are preserved. They follow the visible results after scrolling; while a Win顺 window is in front they are Win顺's, even if another app uses them as global hotkeys. Under Settings › Result list › Display and preview, “Keyboard hints” can hide the shortcuts help button at the right of the search box and the key hints in the footer; capture's All keys button can be hidden among the toolbar buttons. -
Letter jump (off by default; Settings › Result list › Behavior › Letter jump): tap a key by itself and every row in view gets a letter; the letter opens that row, the rows past the ninth too, with one hand. The key is the number keys' modifier unless you choose
Ctrl,AltorShift, and the letters and their order are yours too, digits included (for exampleQWERTASDFGZXCVB12345for the left hand). The bar under Open and Save dialogs has the letters too (a letter goes there, asEnter). In the search boxShift+letter picks that row and puts letters on its buttons (open location, terminal, copy, copy path, delete twice); in the clipboard it selects or unselects that row and the letters stay, so you can pick several and paste them together withEnter; in the dialog bar it only selects the row. The tap again orEscleaves. -
Open an address: with the Web search plugin on, a web address typed in the search box (
github.com/LingCore,baidu.com,localhost:3000, with or withouthttps://) gets an "Open the address" row first; a file of that very name on the PC stays first. Names that look like files (main.py,notes.md) are not addresses. -
Fill in what was just copied (off by default; Settings › Result list › Behavior): one line copied in another program at most 3, 5 or 10 seconds before the search box opens is searched at once, selected so typing replaces it.
-
Search panel: too many hits? The small button at the box's corner or
Ctrl+Egrows the same window into a panel, as Listary has it: filters down the left (scope, kind, date modified, size, folder), sortable columns on the right; right-click headers to choose name, path, type, size, modification and creation times, folder or source, and drag to reorder or resize them; the layout is saved; with nothing typed it browses the whole index by those filters (milliseconds over three million files). A custom size takes a unit (40 KB,1.5 GB; a bare number is MB) and a custom date2026or2026-3for a whole year or month; a box it cannot read is underlined in red (0.38.0).size:>10mbanddm:7dwork in the box too. Quick filters (as Everything's filters): save a query you use often under a name, such as!$RECYCLE.BIN\as "No Recycle Bin" orext:pdf size:>10mb, with the+in the side bar; it becomes a chip that narrows whatever you type at a click, several at once all apply, and content searches skip the files they exclude. Give one a prefix (saynobin) and:nobin reportapplies it from the plain search box too, several at once and beside a kind's prefix. One can have a sort of its own (a "Big files" filter, largest first), in force while it is on (0.38.0). Edit them under Settings › Result list › Kinds and filters. Press it again to collapse. -
Panel hotkey (0.30.0): the hotkey set for "Open the full search panel" under Settings › Shortcuts › Open WinShun closes the panel when pressed again while it is up and in front (before, only
Escdid); with the small search box up, it expands the box into the panel. -
Long names: a name that does not fit is shortened in the middle, keeping its extension and end ("…v3 final.xlsx"); rest the pointer on the row to see the full name, location, size, modified and created times. Drag the left or right edge of the search box to widen it (the width is remembered; double-click an edge for the default).
-
File sizes: Settings › Result list › Display & preview can show sizes in the compact results, alongside modification dates or on their own. Off by default; sorting by size always shows sizes. Folders and unknown sizes stay blank.
-
Logo controls: the WinShun logo on the left opens settings with a left click, toggles pinning with a middle click (
Ctrl+Talso works), and opens the position menu with a right click. Settings › Result list › Behavior › Logo right click can make that one click straight to the top, the center or the last dragged position; the logo's tooltip names it. Drag it to move the window. A pin badge shows when pinned: clicks elsewhere and opened files keep the box up;Esccloses it. -
Preview:
Alt+Pon a result (or Preview in its menu) shows the file without leaving the launcher: pictures, text (UTF-8 or GBK, detected), Word, Excel, PowerPoint and PDF (through the same preview handlers as File Explorer's preview pane; where this PC has none, as with only WPS or no office suite, or for a file downloaded from the internet, the document's text, by page, slide or sheet, with Excel's own row numbers), what a folder holds; the arrows move it to the next row,Alt+Pagain (or the × on the preview) closes it;Esccloses the launcher and leaves the preview as it is, so it is back the next time the launcher opens (turn off Restore preview on reopen under Settings › Result list › File quick preview to close it with the launcher). Code, JSON, YAML, INI / TOML, XML / HTML and Markdown are coloured, and the words searched for are marked and scrolled into sight. Illustrator.aiand Photoshop.psd/.psbfiles are drawn as pictures without Adobe's software (an.aitrimmed to what is drawn on its artboard). QuickLook or Seer, when running in the background, shows it instead. The result preview shortcut can be changed to Space, a function key, or an unused chord in Settings; Shift+Space still types a space. -
Thumbnails: pictures, videos, PDFs and the like show their thumbnail instead of their type's icon, in the results and in the search bar beside Open / Save dialogs; Settings › Result list can turn them off.
-
Context menu: right-click a row for its location, Copy path, Add to favorites, Open in terminal (the Command Prompt, or under Settings › Result list › 操作习惯 Windows PowerShell, PowerShell 7, Windows Terminal with its default profile, Git Bash, WSL, whichever are installed, or a command line of your own run in that folder with
{query}for it) and more;Shift+right-click (or More options in that menu) brings up Windows' own full context menu, as in File Explorer, for one row or several; after copy, cut or delete the search box stays open. -
Run as administrator, remembered: with "Remember “Run as administrator”" on (Settings › Result list › Behavior, off by default), an app or program run once with
Ctrl+Shift+Enterruns as administrator onEnterfrom then on; its row says Admin, and "Run with normal rights" in its menu makesEnterplain again. -
Scope remembered: the scope you chose (All, Files, Content or a kind) comes back at the next start, unless Clear the search on every opening is on; a typed prefix or a plugin row does not change it.
-
By kind: under Files, a row of kinds (folders, documents, pictures, videos, archives…);
Ctrl+Tabsteps through them,+adds your own. -
Files you never want to see: Settings › Search scope skips some types and file names, with
*and?wildcards; by default the~$temporary files Office and WPS make beside open documents. Typing such a name in the box still finds it. A link under the excluded folders leads there (0.36.0). -
Drag out: drag results into a chat, a mail or Explorer. Drag with the right button into Explorer and on release it asks what to do: copy, move, make a shortcut, or an archive tool's "extract here"; a right click without moving still opens the row's menu (0.32.0).
-
Rename in place:
F2on a file or folder (or Rename in its menu) turns the name into a box with everything before the extension selected;Enterrenames through the shell, soCtrl+Zin File Explorer takes it back, andEscleaves the name alone. A name Windows refuses, or one already taken there, is explained in the footer. One row at a time. -
Quick filters: save a query under a name, as Everything's filters do (
!$RECYCLE.BIN\,ext:pdf size:>10mb). Each is one click in the panel's filters, and all that are on must match; they also apply to content searches. Give one a prefix under Settings › Result list › Kinds and filters and:nobin reportapplies it from the plain box. -
A file kind bound to a folder: a kind under Settings › Result list › File types can name the folders it searches, so
cw:lists the CSV files of one work folder. -
A second key for Enter: Settings › Result list › Behavior can record another key (a function key, or an unused Ctrl / Alt chord) that opens the selected result as
Enterdoes. None by default; never Space. -
Live updates: the USN change journal is read, so renamed, new and deleted files are found at once; unplugging a USB drive never says it is in use.
-
Large icons: switch the search panel between a list and a thumbnail grid. Resize previews with the slider or
Alt+wheel, select several file categories together, and keep the normal selection, menus and file dragging. The view and thumbnail size are remembered. -
Into folders, a level at a time (GitHub #361): put the keyboard on a folder found (
↑↓, or a click) andTabgoes into it: the box holds its path and lists what is in it, ready to search there;Tabon a folder in there goes on down.Ctrl+Backspace(the caret at the end) comes back a level: out of a folder entered withTab, back to the words and the scope searched before, that folder selected again; on a path typed, to the folder above, the one left selected; a half-typed name goes first. A half-typed path (D:\Wo) completes to the folder listed first. The row the list selects by itself keepsTabfor the scopes (press↑or↓on it first); so do Content, regex mode and plugin keywords. -
Query syntax:
"exact phrase",!exclude,!node_modules\, wildcards*?,ext:pdf,docx,folder\name, and paths (D:\My Files\,tools/out/). Add OR groups (report | summary 2026, AND takes precedence), name anchors (^IMG,.pdf$), orregex:^IMG_\d+\.(jpg|png)$; invalid expressions explain the error.Ctrl+Rturns on regex mode, where every word is a regex, as in Everything.:pictures,videoscombines type keywords. -
WSL file search: add a Linux project or home folder under Settings › Search scope › Network & WSL. Installed distributions appear automatically. Search file and folder names alongside local files, including pinyin; indexed results remain available while WSL is stopped and update automatically when it runs again.
-
Remote scan controls: each network or WSL folder has independent daily scan hours (including overnight windows) and a maximum depth. Depth 0 is unlimited; depth 1 lists only the chosen folder. Background name and content reads pause outside those hours; cached results remain searchable. Check now runs one manual name scan, still respecting depth. Both limits are off by default.
Full-text search
- Content details pane: the
Ctrl+Epanel offers Summary, Hits, Text, native Preview and Report tabs. Read all available matches, refine hits and context, inspect Excel sheets with real row numbers, and copy, print or export text, CSV, HTML and XLSX. Full counts run on request; partial results are labelled. While the pane is open, a click on a file only selects it (the pane follows) and a double-click orEnteropens it;F11fills the screen with the panel, and again puts it back (0.33.0). - What: the Content scope searches inside txt, md, logs, source code and Word, Excel, PowerPoint, PDF and WPS files, showing the page, slide or sheet and row.
- Quieter everyday searches: All adds matches from the existing content index without launching document parsers. Choose Search contents when offered, or switch to Content, to read files that have not been indexed yet.
- Either word, and regular expressions:
now|soon(ornow | soon) finds files with either word; with other words, those and either. A word afterregex:orre:is a regular expression matched within a line, any case unless it starts with(?-i); in regex mode (Ctrl+R) every word is one. An expression with some fixed text in it (invoice-[0-9]+) is as fast as a word with the content index on; one with none reads every file. A broken expression says why.ws grepand the MCP toolsearch_contenttake the same. - In one folder: add a folder's name and a slash,
annual report abc/, to search only in folders named abc (/abclast works too;work/abc/takes the one in work); folders of the same name are all searched and listed under the box,Ctrl+Tabpicks one. Or pick a favorite folder there, or right-click a folder in the results → Search contents in this folder. - How: ranked by relevance, with a content index for speed; UTF-8, UTF-16 and GBK are detected. The first content index reads text files straight from the disk through the index service, so antivirus does not check them one by one and it is done much sooner. Files over the size limit, in system folders or of unlisted text types are skipped; the list says how many of each, and one click searches them too.
- Without the index service: it works too, only slower, as the files are read as you search.
- Safety: documents are read by a separate process with restricted rights.
Apps and settings
- Apps: everything in the Start menu (Store apps included), by name, pinyin, initials (
vsc) or program file (winword). Pinyin needs two letters; a single letter also lists apps opened before whose name has a character starting with it. - Found by the name they were installed under (0.29.0): the name Settings › Apps lists a program by finds its apps, even when their Start menu shortcuts are called something else:
microsoft officeoroffice 2024finds Word, Excel and PowerPoint,7-zip 25finds 7-Zip File Manager. An app's own name still comes first. - Apps tab (off by default): turn on "Show the Apps tab" under Settings › Result list and a fourth scope, Apps, follows All / Files / Content: the apps as a grid of icons. The chips under the box choose the windows open now (Running), the most used, the favorites or all of them (
Ctrl+Tab, remembered); arrows pick a tile,Enteropens it, and typing matches as All matches apps, among the ones chosen. The star on a hovered tile adds it to or takes it from the favorites; a right-click opens the menu a row has. The panel and the dialog bar do not have this tab. - Apps › Running (0.29.0): the first chip, Running, lists the windows open right now as tiles (icon and window title).
Enteror a click switches to that window, restoring it if it is minimized, instead of starting the program again; typing narrows them, and the list follows windows as they open and close. WinShun's own open windows (Settings, say) are listed too (0.32.0). - WinShun itself:
admin(管理员, 提权) lists Restart WinShun as administrator, for plugins that need it (an in-app update started while it runs so asks for administrator rights once more afterwards, 0.34.0+);winshun,issueor 反馈 lists its issue tracker and discussions. - Settings: about 1,200 Windows settings pages and Control Panel items (
ncpa.cpl, “network adapter”), plus Group Policy, Disk Management, hosts, AppData and more. - Searching for files only? Turn off app and settings results in the settings, and All lists files and content alone.
- System switches plugin: enable it in Settings → Plugins. Off for fresh profiles; upgrades preserve the previous system-search choice. Dark mode, hidden files, file extensions, Bluetooth, WLAN, volume and mute, keep awake, each with its live state at the end of its row;
Enterflips it in place and the box stays open,Ctrl+Enteropens its settings page.bluetooth off,muteandvolume 30act in one step;awake 1hkeeps the PC awake for an hour.
Web search
- When nothing is found (0.28.0, off by default): "Search the web when nothing is found" on the Web search plugin's card adds a row that searches with the first site in the list. A keyword may also come last:
weather gworks asg weatherdoes.
install and enable Web search from the plugin library. zhihu 显卡, baidu 天气: a keyword and a space search that site; found by a part of its keyword or by its name (b), a site's row takes Tab to put the keyword in the box. Manage sites, keywords, icons and suggestions on its plugin card; existing settings migrate on upgrade. Presets include Chinese sites, GitHub, YouTube and Wikipedia; add your own with %s in the URL, and import or export the list and icons. The site's search suggestions show below as you type (Enter searches one, Tab puts it in the box), and a site's icon can be an SVG file or pasted SVG code.
Favorites
- Right-click → Add to favorites. They come first when the box is empty; give one a keyword to open it; the start of the keyword finds it too. Right-click a folder → Search in this folder to browse it in WinShun, or choose it with the arrows and press Tab. On a favorite folder the list selected by itself, Tab switches scopes by default; optionally choose to browse it with Tab in Settings → Result list → Display and preview.
- Put in order (0.39.0): in Settings › Favorites drag a row by its handle, or click a column header above the list to sort them at once as File Explorer does: Name (
2before10), Date modified (newest first), Type (folders, files by extension, apps, system places, commands) or Size (files only, as in File Explorer). Click again for the other way, a third time for the order you had; a small caret shows the column. The sorted order is the favorites' order everywhere: the search box, the icon style, the drag pie and the dialog bar. The order from before the first sort is kept, and Restore order on the right brings it back without removing anything; favorites added since come after them. Sorted by name or type, new and renamed favorites go into their place; by date or size the order is the one at the click, so new ones go last and the caret goes away until the header is clicked again. A drag or Move up / down also removes the caret, and Restore order still goes back to the order before the first sort. Commands, apps and favorites that are gone have no date or size and stay last in those two sorts. An export holds the favorites only, not the sort. - Your own commands: Settings › Favorites › Add command. Give it a keyword and put
{query}in the command; what you type after the keyword goes there. With the keywordcodeand the command"C:\Tools\Code.exe" {query}, typingcode D:\my-projectand Enter hands that folder to the editor. No command prompt is involved, and searching or importing never runs a command. With "The words after the keyword find files" on for a command (off by default),code my projectlists the files and folders thatmy projectfinds, andEnteron one hands its full path to the command; the command's own row comes last, or first when the words are a path that exists. Each command can also be set to run silently (console programs,.batand.ps1files open no black window) and to run as administrator. - Your commands in the right-click menu of files (0.29.0, off by default): tick "Show in the right-click menu of files and folders" on a command (it needs
{query}) and a right-click on a file or folder in File Explorer offers "WinShun commands ›" with these commands. Choosing one hands the full path to{query}; the working folder is the command's own, or else the folder the file is in. Under "Show more options" on Windows 11. - Press
`while dragging: hold the left button on files or folders (no need to drag yet; File Explorer, the desktop, Total Commander or another program) and press the key belowEsc(it types nothing during the drag): your first 8 favorite folders appear round the pointer. Drag toward a folder to pick it, as in a marking menu, and let go to drop there: as in File Explorer, within a drive it moves and to another drive it copies,Ctrlcopies andShiftmoves. The progress and name-conflict windows are Windows' own, andCtrl+Zin File Explorer undoes it. Let go in the middle or pressEscand nothing happens; press the key again or drag further away and it closes, and the drag goes on as usual. On by default; turn it off in Settings › Favorites (“Press ` while dragging files to bring up the favorites pie”). It does not work while WinShun itself runs as administrator.
Plugins
-
Read guides in the app. The plugin card opens bundled documentation inside settings, with scrolling and selectable text. Esc returns to settings.
-
Review status and consent. The library shows official, source-reviewed, unreviewed native or unknown status. Unreviewed community native packages require individual consent on installation and every update. View source opens the publisher's page, and declining an update retains the installed version.
-
Shared host Qt. Native MSVC x64 Release plugins can opt into the versioned Qt runtime contract introduced in 0.22.0; since 0.23.0 this includes plugins with the
elevatedpermission. See the plugin development documentation for supported modules and deployment requirements. -
Report a problem to the author. Plugins by others are maintained by their authors. A card's "…" menu opens the Issues of the plugin's repository (the one the library lists, otherwise its homepage). A plugin without a homepage gets its listed repository as Homepage.
-
Resident limit. At most 8 resident plugins stay running by default; past that the least recently used one exits and starts again when needed. Settings › Plugins › Resident plugins at once offers 4, 8, 16 or no limit.
-
Image text search (optional plugin): searches images, scanned PDFs and embedded pictures in modern Word, Excel and PowerPoint files: once the index is built, type the words from a picture straight into the search box (in All, the first three picture rows follow the first five name rows), or use
ocr invoiceto list only picture and scan results. Selected folders are indexed offline with highlighted previews, pause and a storage limit. It shares the OCR component and keeps no image copies. Install from the plugin library; this package needs WinShun 0.20.0 (it is built with it). Since 1.0.2 it reads PDF pages whose text is drawn, upside-down pages and long pictures, also reads JFIF, GIF, HEIC and AVIF, and an installed plugin can read PDFs again. See setup and format limits. -
Bundled:
= 1+2*3,12 inch to cm,#ff8800, timestamps, UUID, Base64, hashes;killprocesses. -
Calculator tape: a sum whose result you took with
Enteris kept. Type=alone to list them, a row each (result, sum, time; newest first), and they also show under a sum being typed, to check one against another. On a kept sum:Entercopies the result again,Ctrl+Entercopies “sum = result”,Tabputs the sum back in the box to change,Shift+Enterremoves it; the last row clears them all. A month's sums, 200 at most, on this PC only; AI assistants and thewscommand line calling the calculator do not see them. -
LAN transfer (in the plugin library, to install when you want it): send files and text to and from phones and PCs on the same network that run LocalSend, with no server or account. You are asked before anything is received (unless you turn on Accept automatically in its card, plugin 1.0.7 or newer); type
lsto send and receive, or right-click search results or clipboard history › Send over LAN… and choose a device. History selections, including multiple entries, send without changing the system clipboard (LAN transfer plugin 1.0.1 or newer). -
Search by meaning (in the plugin library, to install when you want it):
? last year's expense rulesfinds a document that says “travel cost requests”. It uses the model you pick: Ollama or LM Studio on your PC uploads nothing; for SiliconFlow, Model Studio, OpenAI and others you enter your own key, and before the first run it says how much text would be sent and waits for your Enter. See its guide. -
Break reminder (in the plugin library, to install when you want it): a 20-second break every 20 minutes, every other one a 5-minute break. Thirty seconds before, a small bar at the top offers Postpone (once), Skip and Pause 1 hour; when it is due it waits for a pause in typing, dims every monitor with a countdown, and
Escends it early. Strict mode leaves only a 3-second hold ofEsc. Five minutes away counts as a break; full-screen games, slide shows and Do not disturb hold it back. Typebreakto see the time left, take a break now, pause until manually resumed across restarts, or pause for 1 or 3 hours. See its guide. -
Explorer tabs (in the plugin library, to install when you want it; needs Windows 11 22H2 or newer -- File Explorer on Windows 10 has no tabs, so it does nothing there): a folder that would open in a new File Explorer window opens as a tab of the window you used last instead, and that window comes to the front; a new window for a folder already open in a tab switches to that tab. Hold
Ctrl+Shiftwhile opening for a window of its own;Ctrl+Nor "Open in new window" in an Explorer window still gives a window. Folders Win顺 opens become tabs too. Typetabsto see how many were merged or to pause it (a pause is kept across restarts). From plugin 1.1.0 it remembers the open windows and tabs: with "Open the tabs from last time after logon" on they come back after the next logon (tabs, window places; nothing is opened twice), and the second row oftabsopens them on request. See its guide. -
Mouse gestures (in the plugin library, to install when you want it): hold the right button anywhere and draw; a trail follows the pointer with what letting go will do. Defaults: ← back, → forward, ↑ to the top, ↓ to the bottom, ↓→ close the window, ↓← minimize, ↑↓ WinShun's search box. Each takes an action name, keys such as
Ctrl+W, or a program, folder or web address to open; "More gestures" adds others of up to 6 strokes. A plain right click still brings up the menu; hold still a moment before a right-button drag. A list of programs, full-screen programs (unless turned on), touch and pen are left alone, and so are windows run as administrator (Windows does not let a program with normal rights take their mouse input).gestureslists them and pauses them. See its guide. -
Translate (in the plugin library, to install when you want it):
tr sentenceturns Chinese into English and anything else into Chinese, using your own key for DeepL, Microsoft Translator or an OpenAI-compatible service (each service keeps its own key), with presets for DeepSeek, Doubao / Volcengine Ark and Tencent Hunyuan.dict wordshows model-generated definitions and examples. Nothing is sent without a key. Superseded requests are canceled, and Enter copies the selected item. -
Browser bookmarks (in the plugin library, to install when you want it):
bm wordssearches the bookmarks of every Chrome and Edge profile, those synced to a signed-in account too (AccountBookmarks); Enter opens one. Pinyin works for titles and folders in Chinese (0.29.0, plugin 2.0.5): initials, full pinyin or a mix, sobm xjtuandbm xianfind 西安交通大学 andbm wafinds the bookmarks in a folder named 网安. The browser's own "Bookmarks bar" and "Other bookmarks" folders and the addresses are not read as pinyin. When more than 50 match, they are ranked before the first 50 are taken. -
Browsing history (the bookmarks plugin, 2.1.0):
bh wordssearches the pages opened in Chrome and Edge by title or address, pinyin for Chinese titles too; nothing typed lists the pages last opened. Off until you turn on "Search the browsing history" in the plugin's settings; read on this PC only. -
Plugin tiles (0.39.0): Settings › Plugins shows Installed, Plugin library and Built-in features as tiles, up to four in a row in a wide window, fewer as it narrows: icon, name, version, a few lines of description, keywords and the switch. Click a tile (or Details › on it) for the plugin's own page with its settings, permissions, keywords and readme; ‹ All plugins goes back. Settings on a plugin with a settings window of its own opens that window, starting the plugin first when it is not running (thanks to ra9fael for PR #396).
-
Plugin library: Settings › Plugins › Plugin library has WinShun's own Screenshot and recording, LAN transfer, Search by meaning, Break reminder, Explorer tabs, Mouse gestures, Translate, Browser bookmarks and Developer tools (a JSON tool:
jsonformats, minifies or escapes the JSON on the clipboard or typed,Enteropens a tree to browse and search it, 0.37.0), and plugins other people wrote (from WinShun-plugins); Choose Install and enable for a new plugin and review its permissions after the package is checked. Readme on an entry shows the plugin's own README before installing; an entry with release notes has a What's new button beside its name, which shows what that version changed and installs or updates it from there (0.32.0); who made it, what it may do and how it was reviewed are in the “i” beside its name. Updates keep its enabled state. Features awaiting recovery after an upgrade can be retried or installed from a local package on the Installed tab. It fetches the library when that page is opened, on Refresh, or to install. Signed background update checks follow the Automatic updates setting. If GitHub cannot be reached, Settings › General › Network proxy takes a proxy address by hand. -
Your own: zero-code
plugin.json, scripts in any language, or resident processes, with SDKs for Python, PowerShell and C++. Plugins run under a memory limit with normal rights; only a plugin that asks for administrator rights runs as administrator, and only while WinShun itself does and after you confirm it once on its card. A command can have several keywords: type them into its card with spaces between; from eight installed plugins on, a box filters them. See docs/plugins.en.md.
Open and Save dialogs
- Search bar: a search bar under every file dialog; type a name (pinyin too), press Enter, and the dialog goes there; a file opens straight away in an Open dialog, as Enter opens it in the search box, while
Ctrl+Enteronly goes to its folder and selects it (Save As and dialogs of programs run as administrator go there and fill the name in, the button stays yours); web page uploads, WPS dialogs and the "Browse For Folder" box of VBA macros too. The "Browse for folder" window of installers made with Inno Setup has it as well: a pick only fills in the path, and you press the installer's OK yourself (the Start Menu folder picker is left alone). The extraction path windows of Bandizip, 7-Zip and WinRAR have the bar too: a pick writes the folder into their path box, and OK stays yours (run against the real Bandizip 7.36; 7-Zip and WinRAR with stand-in windows). - Where the bar goes: under the dialog while the bar fits there (Auto and Below), its list opening upward when there is no room under it. A dialog that reaches the bottom of the screen or is maximised gets the bar over the taskbar at the bottom (on top, at most 800 wide so the tray and clock stay in view), clear of the dialog's title and address bar, as Listary does (0.33.0). Beside it only when not even that fits. Below also makes a dialog that is too tall shorter when it first shows, for two rows of results; Auto leaves it as it is.
Ctrl+G: jumps to the folder open in File Explorer, Total Commander, Directory Opus, XYplorer, Pulse or OneCommander, like Listary. OneCommander uses its active pane's folder, with no extra setup; dialog suggestions can also list its other open tabs, falling back to the active folder while tab state is out of sync.- Only the dialog's folder:
Ctrl+Shift+Din the bar, or "Only inside …" in its "…" menu, searches only the folder the dialog is showing and what lies in it; the folder's name appears before the text and follows the dialog. The same key, a click on that name or the menu brings the whole PC back. The choice is remembered. - Suggestions: open folders, a path you just copied, favorites and recent folders.
- Going there by itself: optional, as the dialog opens, or only when you come back to it from the file manager. Coming back, it goes to the folder in front there every time, even when that window showed it all along; only a folder the dialog was just sent to is not repeated (0.31.0).
- Programs run as administrator: with the index service installed,
Ctrl+Gand going there by itself also work in dialogs of programs run as administrator, including Windows XP style Open / Save dialogs and AutoCAD's own file window (the folder is put into the file name box, OK is sent once, and your file name is put back). A file picked in the search bar goes there with its name filled in; Open or Save stays yours. Without the service, the path is copied for you to paste. - Blender: enable the file-dialog extension to use WinShun in separate Open, Save As and Import windows. Save/Export confirmation stays in Blender. Tested on Windows x64 with Blender 5.2; see the dialog compatibility notes.
- Programs' own file windows: a file window a program draws itself (ArcGIS's "Add Data", say) is not a Windows dialog, so WinShun does not know it until you show it once: open that window, click "Learn a window" under Settings › Integration › Dialogs, and within five seconds switch back to the window and click into the box that takes the file name. From then on the search bar,
Ctrl+Gand going there by itself work on it: a folder is typed into that box and confirmed with Enter, a file goes in as its whole path and is confirmed too, whileCtrl+Entergoes to its folder and leaves its name in the box for you to confirm. It needs a window that already goes to a path typed into its name box. The rules live indialogs.jsonin the data folder ("Rules file"; a saved change applies at once): the program, the window (class,title,*for any run of characters), the box (box:type,id,name,class,index) and what confirms it (confirm:"enter"or a button). Not for programs run as administrator.
In File Explorer
-
Send to › LAN transfer (WinShun) (0.28.0): with the LAN transfer plugin on, the files chosen go to its device list from Send to in the right-click menu (under "Show more options" on Windows 11).
-
Pin to screen (WinShun) (0.29.0): with the Screenshot and recording plugin on, right-click a picture file in File Explorer and choose it to pin that picture on the screen; several pictures chosen are each pinned. Under "Show more options" on Windows 11 (or
Shift+right-click). -
WinShun commands › (0.29.0): right-click a file or folder to see the favorites commands set to show there (see Favorites); choosing one hands the full path to its
{query}. Under "Show more options" on Windows 11. -
Typing on This PC and Home (0.30.0): with Type to search on, typing in File Explorer on This PC, Home or Quick access searches the whole PC (there is no folder to put first). The Recycle Bin, the Control Panel, Network and search results keep their keys.
-
Caps Lock held down is left alone (0.29.0): with Type to search on, a letter pressed while
Caps Lockis held down no longer opens the search box, so tools that use Caps Lock as a modifier (CapsLock+, AutoHotkey, PowerToys) keep their keys. Caps Lock merely switched on (typing capitals) still searches. -
Typing to search does not start while a mouse button is down (a file held or dragged); with a Chinese input method the letters still being composed are searched at once.
-
Direct folder entries. Under Settings › Integration › File managers › Folder menu, set 0–10 recent or open folders to show directly. Zero uses the submenu, and overflow entries appear under More. Menu density follows the interface size and long paths have hover tips.
-
Tessoa folders. Ctrl+G can read the active folder of a specific Tessoa window using its v1 protocol, available in Tessoa 0.22.0 or newer.
-
Folder menu: double-click empty space in File Explorer or on the desktop, then choose Favorites, Recent folders or Open folders (the folder you are in is not among them; with no other open, Open folders is left out, 0.38.0). Favorites include folders, files, apps, system places and custom commands, with names and icons; hover for the full path or command. Choose a folder to navigate the same window (the desktop opens a new one); to go to a folder inside it, rest the pointer on its row (or click the arrow at its end, or press Right) and a column opens beside it listing the folders inside, column after column: the columns before stay, the row you came from stays highlighted, and where the screen ends on the right they open to the left. Moving diagonally toward a new column opens none of the rows you pass; back on another row of an earlier column, the columns after it close. Or click a command to run it;
{query}receives the current folder and an explicit working directory takes priority. The keys act on the last column: Right opens a column, Left or Backspace closes one, Esc closes the menu. Each column scrolls on its own and the menu keeps the source window's focus. Each column is as wide as its longest name wants, between a narrowest and a widest width, longer names cut short (0.38.0). With “A folder's column also lists its files” on (off by default), a folder's column lists its files after its folders, and a click or Enter opens one; an empty folder says so, and past 500 files a last row opens the folder for the rest. In Open and Save dialogs the menu still lists folders only. Each group can be switched off in settings, as can how it opens (double left click, middle click), where (File Explorer, desktop) and each action at the end of the menu (Search here, Copy path, Command Prompt, PowerShell, Add this folder to favorites, WinShun settings). -
It never takes the focus: arrows, Enter, Esc and first letters work; a click elsewhere or another double click closes it. It stays out of the way while Listary runs.
-
In Directory Opus too: WinShun can add its command to Opus's settings for you (Opus restarts once), and puts the old one back when turned off or uninstalled.
-
In Clover and 360 Folder too: a double click on blank space in their tabs brings up the menu, and typing in their file lists searches with that tab's folder first. Both have their own "double click blank space to go up" (on by default); while it is on, WinShun leaves the double click to them. Untick it in Clover's settings (then quit and reopen Clover, which saves settings on exit) or in 360 Folder's Settings › Quick actions. 360 Folder does not tell other programs which folder it shows, so WinShun finds it by the tab's title and the names listed; when too many folders share that name, the search covers the whole PC.
-
Type to search in Directory Opus: enable it separately in Settings → Integration → File managers (off by default). Start with a letter or digit in the file list to search, the focused tab's folder first (as in File Explorer), including either pane of a dual display.
Escreturns to Opus; opening a folder or locating a result withCtrl+Enteruses the original pane. Renaming, address bars, menus and Opus find modes starting with symbols keep their usual behavior. -
Answering for Everything: switch on “Let other programs search WinShun as Everything” in Settings → Integration → File managers (off by default) and the Everything search of Directory Opus, Total Commander,
es.exeand tools built on the Everything SDK is answered from WinShun's index, with Everything not installed. Words, quotes,!not,a | b, wildcards, a folder to look in, the start of a full path as Everything takes it (file:"D:\images" ext:jpg;png, as programs built on the Everything SDK ask;D:\images\*.jpgtoo),ext:,size:,dm:,regex:,file:/folder:andparent:work, with sizes (folders too) and dates; Everything-only functions such asattrib:orcontent:find nothing rather than something else. While Everything itself runs, it goes on answering. With the switch on, the folders under the excluded folders are indexed all the same, so Total Commander and the like can count their sizes, while WinShun's own searches still leave them out; whole drives excluded stay out (0.32.0). Any program on this PC can then look up the names in the index, as with Everything installed. -
By a shortcut: when another program has the double click, or for Total Commander, XYplorer and Pulse, give the folder menu a shortcut in the settings and press it in any window: in File Explorer, on the desktop, in Directory Opus, Total Commander, XYplorer and Open / Save dialogs the folder picked opens in that window (in Pulse, where its “Folders opened from other apps” setting puts it: a new tab or a new window); anywhere else, in your file manager. Press it again to close the menu.
-
“Search here with WinShun” on the right-click menu of folders, a folder's blank space and drives (under “Show more options” on Windows 11): the search window opens with that folder typed. It can be turned off.
-
Type to search: type anywhere in a File Explorer file list and WinShun searches for what you typed, like Listary: what is in that window's folder (and its subfolders) comes first, the rest of the PC follows under a thin "Elsewhere" line; "Only in …" or
Ctrl+Shift+Dkeeps to that folder, pressing it again keeps to this level alone (no subfolders), and a setting can make either the default. A Chinese input method composes as usual, andEscgoes back to File Explorer. A folder you pick opens in the same tab, so typing again goes one level deeper;Ctrl+Enteron a file or folder also goes, in that tab, to the folder holding it and selects it (when the file manager set in Settings is File Explorer); and the keys of Explorer'sShift+right-click menu stay with the menu. On for new installs (0.36.0; an upgrade keeps what you had); it replaces Explorer's own jump to a file by its first letters, so turn it off in the settings if you want that back. A kind works here too:report :documentsordocuments: reportlooks for documents only, in that folder first. -
Placement and selection (0.17.0): the search box opens beside the originating Explorer window when all of it fits there; otherwise (a large, centred or maximized window) it opens in the bottom right corner of the file list, as Listary's does, never in a corner of the screen. Neither changes its remembered position. On the few PCs where Windows will not let the search box to the front, Explorer keeps the focus and what is typed still goes into the box (past the input method: pinyin is searched as letters). Browsing a direct child selects and reveals it in the original tab while the search field keeps keyboard focus; nested and elsewhere results do not navigate Explorer.
Clipboard history
-
Hidden entries (0.28.0): "Hide content" in an entry's menu shows dots in the list and the preview and keeps its text out of the search; pasting is unchanged and "Show content" brings it back. A note tells you which one it is.
-
Edit the text: "Edit the text…" in a text entry's menu turns the preview into an editor;
Ctrl+Enteror Save keeps the change,Escdrops it. The entry stays where it is with its group and note; formatting it was copied with is dropped, so it pastes as the edited plain text. Leave the editor half way and the words are there the next time. -
A copied file: one text file copied shows its beginning under its name in the hover preview (0.28.0). In the side preview (
Alt+P, the eye button), one copied local file or folder shows as the search's preview shows it: a picture, text and code with line numbers, Word, Excel, PowerPoint and PDF through the same preview handlers as File Explorer (their text where there is none), what a folder holds. Clicking or scrolling in a document keeps the clipboard open, and↑↓take the preview along to the next entry. -
Picture thumbnails in three sizes (0.29.0): "Picture thumbnails" under Settings › Clipboard is Small, Standard or Large, in place of the old "Large picture thumbnails" switch. Small keeps a picture's row as high as a text row, with the thumbnail where the icon would be; Large is what the old switch gave when it was on, and an upgrade keeps it where the switch was on.
-
Several copied pictures (0.29.0): several picture files copied in File Explorer show the first one's thumbnail with how many there are on its corner (in Small, the thumbnail without the number). WebP, HEIC, TIFF and other pictures Windows itself opens show a thumbnail too (0.36.0). Copied files that are all pictures are also found under Pictures, still under Files, and paste as files.
-
Copied in WPS Writer (0.36.0): WPS's own format is kept with the text, so pasting it back into WPS keeps formulas editable and the layout as a direct paste would; other programs get the text and formatting as before (tested with WPS 12.1).
-
Text with a formula or a picture in it, copied in WPS or Word, shows in the list and the preview as it looked there (fractions, superscripts), so similar formulas are told apart at a glance; pasting is unchanged,
Shift+Enterstill pastes the plain words. From copies made after updating (tested with WPS 12.1). -
Find a group. Press
Ctrl+Gor the folder button, search group names, select with the arrows and press Enter. Continue typing to search inside the group. Esc restores the earlier content query and scope. -
Part of an entry: in the side preview, drag over the text to select part of it;
Ctrl+Ccopies just that part (as a new entry) andEnterpastes it, the entry staying whole. A copied text file's lines and a picture's words select the same way. -
Menu keys without the menu:
Ctrl+Ssaves as files,Ctrl+Eedits a picture or changes the words,F3pins a picture to the screen (with the screenshot plugin, as there), andCtrl+Tpins the window, as it pins the search box. -
Where it opens: by the text caret (default), by the mouse pointer, or where you last moved it (Settings › Clipboard › Record › 剪贴板打开位置): the same place and size each time, on the monitor with the mouse.
-
No search box: turn off Show the search box under Settings › Clipboard and the top row keeps only its buttons; typing no longer searches, while the arrows,
Enter,Alt+1–9and the other shortcuts work as ever. Finding a group by name still brings the box up for the name. -
Hover preview. Rest the pointer on an item for about 200 ms to see its text or picture. Move into the popup to keep reading. Scrolling or changing groups closes it, and Alt+P or the middle button can open the manual side preview.
-
The side preview next time: it closes with the clipboard, and the clipboard opens on its list. Turn on Restore the preview on reopening under Settings › Clipboard › Paste actions and list display to have a side preview left open come back with the window; one closed by hand stays closed. The hover preview is not affected.
-
Resize: drag any edge or corner to change the clipboard window's width and height, including with the preview open. Sizes are remembered; double-click an edge to reset. Limited screen space temporarily reduces the window without overwriting your preferred size. Text follows Settings › Appearance › UI size by default, or pick its own size in Settings › Clipboard › Clipboard size (including a dense one-line-per-entry step). Copied image files show thumbnails too.
-
What: text, pictures and files, opened with
Win+Vor your own shortcut, by the text cursor, without taking the focus. -
Search: pinyin,
@appfilters, and words in copied pictures (Windows recognition by default; install enhanced recognition for PaddleOCR, with better Chinese, English, numbers and small print. Images are processed on your PC. Since 0.39.0 a very long, thin picture (say 33,000 × 35 px) is read in about the memory of an ordinary screenshot instead of several GB, and a picture the program crashed on twice while reading it is no longer read: it stays, without searchable words). -
Preview: full text, pictures, HEX / RGB / HSL color values. The eye button (or
Alt+P) opens and closes it; while it is open, the row under the mouse is shown. It is wider now, and the line beside it can be dragged, the width remembered. -
Original image formats: PNG, JPEG and GIF data supplied by the source are kept as received; bitmap-only copies become PNG. Drag pictures into a folder or paste them into File Explorer to save them in their stored format. Select several with Ctrl or Shift to save them together. GIF previews can play and pause.
-
Paste: double-click or
Enter, or one click as in Windows' own history (an option). Number hints on the icons are always visible by default and can be adjusted in Settings. -
Into programs run as administrator: Windows drops the keys a normal program sends them, so the index service presses the one paste chord for you (Settings › Clipboard › Paste into programs run as administrator, on by default). Without the service the entry is copied and you press
Ctrl+V. -
Paste without opening it: Settings › Clipboard › Shortcuts › “Paste without opening the panel” (
Ctrl+1–9orAlt+1–9) pastes the first nine entries straight into any program, format kept. Off by default; when on, those keys no longer do their usual job in other programs (switching browser tabs, say). -
Hold and press again, as in Ditto: Settings › Clipboard › Shortcuts › “Hold and press again, release to paste”. Keep the shortcut's Ctrl, Alt, Shift or Win held: each further press moves one entry down, and letting go pastes it; held about a second, letting go pastes the first entry;
Escwhile holding pastes nothing. Off by default. It works over programs run as administrator too, while pasting into them is on. -
Upload boxes: in a Windows “Open” file box, pasting files from the clipboard history puts their full paths in the File name field, several at once if you like; then click Open.
-
Equations and embedded objects: an equation copied from Word is kept as formatted text, shown as it looked (as one from WPS), and pastes back into Word as an equation you can still edit;
Shift+Enterpastes it as a line of text (0.38.0; it used to be a picture entry). An embedded object (or an equation from an editor that gives no formatted text) is kept as a picture entry, with its text, which you can search, and pasted back as an object you can still edit; a program that only takes pictures gets the picture. (Tested with Word.) -
Organize: pins, groups, multi-paste in order, and
Alt+1…Alt+9; pinned items can come first, and the order is yours to drag or move withCtrl+↑/↓.Ctrl+Apicks every listed entry, Delete all in the row menu clears them at once, andCtrl+Zbrings them back. A note of your own on an entry (Add note in its menu) leads it in bold and is found by the search, pinyin included; pick one of seven colours beside the box (orTabthrough them) to tell kinds of entries apart at a glance, each readable in light and dark. -
Copied files that are gone: their entry says “no longer there”, and can be hidden or cleaned out automatically (pinned and grouped entries stay; a pulled-out USB drive does not count).
-
Import: Settings › Clipboard › Keeping › Import clipboard history takes a Ditto database (one click if Ditto is installed),
.txttext and.csvtables (GBK files saved by Chinese Excel are recognised); what is imported goes into a new group, is never cleaned out automatically, and entries you already have are skipped. -
Privacy: passwords from password managers are not kept, and the history stays on your PC.
-
Programs left out: Settings › Clipboard › "Don’t keep copies from these programs". When one of them copies, WinShun does not even open the clipboard. If copy and paste misbehaves in a program while WinShun runs (someone reported ArcMap not pasting copied features), adding it there is the first thing to try.
Screenshots and recording
- Keys on a pin (Screenshot and recording 1.1.14): after a click on it,
Eedits,Oreads its text,Usends it to the top edge and back; changeable under Keys › Pin window. - Pin from File Explorer (0.29.0): right-click a picture file › Pin to screen (WinShun); see In File Explorer.
The Screenshot and recording plugin: install it in Settings › Plugins › Plugin library, record your own shortcut under Settings on its card, and turn on PrtScn there too if you want it. Who had screenshots on gets it installed with the update, settings as they were.
- Area and full-screen recording: choose Record or press
Ctrl+Rafter selecting an area, for MP4 or GIF. Switch between Area and Full screen on the controls; Full screen records the entire monitor containing the selection, including its taskbar, and Area restores the original selection. Pause and resume, choose quality, cursor and click highlights, and optionally show the shortcuts and mouse buttons pressed as keycaps in a corner (off by default; "All keys" records typing too). MP4 audio is optional and off by default; GIF is silent. Controls stay out of the recording. Choose a save folder, or record another take without replacing the previous file. - Toolbar and saving: the toolbar has two rows: the common tools, undo/redo, pin, save, cancel and confirm next to the selection, and the line, highlighter, text recognition, QR, scrolling screenshot, recording, delay and the key list in a shorter second row (the rows swap when the toolbar sits above the selection). Drag the toolbar by its left grip together with its style panel. Choose the screenshot save folder and a shortcut to pin the latest screenshot in the screenshot's settings. After a save, click the notification to see the file selected in your file manager.
- Choosing: rest the pointer on a window or a button and it is outlined, with everything outside it dimmed; click to take it, or drag an area; the wheel makes the outline larger or smaller. Side panels and buttons in apps that draw their own interface, such as Settings and Calculator, are outlined too (not inside Chromium apps such as Chrome, Edge, VS Code and WeChat, where only the whole window is outlined; drag an area there).
WASDmoves the mouse pointer by one physical pixel (also while the left button is held, so the area follows) andShift+WASDby ten; the arrow keys move the area andShift+arrows resize it.Rcycles through up to 10 distinct recent areas from this run on the current picture;Shift+Rcycles in reverse;,and.step through past captures (the whole screens, the area and the annotations, editable again), the last 10 kept by default. - Magnifier and color: the pixels under the pointer, enlarged;
Ccopies the color under it and ends the capture, andShiftalone switches between#RRGGBB,rgb()andhsl(). Once an area is chosen, the magnifier shows only inside it. - HDR screens: captures on an HDR screen keep their normal colors. Turn on “Also save an HDR picture on HDR screens” in the screenshot's settings (off by default) and
Ctrl+Ssaves a.jxrof the same name beside the PNG, with the bright parts as bright as they were; Windows Photos shows it. - Copy the words:
Shift+Creads the words in the area and copies them. - Read text on screen: record a separate “Read text on screen” shortcut under Shortcuts in the capture settings (none by default). Press it, drag over an area or click a window, and when you let go its text is read and copied, with no toolbar and no screenshot kept; a small card beside it says Copied and shows the first lines, and Edit opens the text to change and copy. It is also in the tray menu and under
capin the search box. - Shortcut hints: while capturing, the bottom-left corner lists the keys that work right now: different before choosing, after choosing and with an annotation tool. It waits its turn: it fades in only after a short pause at the start, goes the moment you press a mouse button, and after you choose an area it appears once only if you stop for about 2 seconds, leaving again as soon as you move. It is hidden while you drag or type. When the area or the toolbar covers that corner it moves to the bottom right; when the pointer comes near it turns almost transparent. It never ends up in the picture.
?shows or hides it for one capture, "Don't show again" turns it off, and "Show shortcut hints while capturing" in the screenshot's settings (Shortcuts) turns it back on. - Delay:
Ctrl+Shift+D, or Delay on the toolbar, counts down (the seconds are a setting) and freezes the screen only at the end, for menus and tooltips. “Include the mouse cursor” in the settings puts the pointer in the picture (off by default). - QR codes:
Qreads a QR code in the area and shows its text to copy; for a web address there is an Open link button, and nothing opens until you click it. Small codes and QQ's round, dotted ones are read too. - An exact size: click the size by the selection, or press
F, to type a width and a height, lock the shape for drags, handles andShift+arrows, or pick from a list of sizes and shapes you can add to. Before selecting,Fand a size make a selection of that size at the pointer. - Marking up: rectangle, ellipse, arrow, line, curve, path, pen, highlighter, text, numbers and redaction. Curve and path nodes remain adjustable, and the highlighter offers different drawing modes. Numbers can be
1 2 3,A B C,a b c, Roman numerals or numbers in circles, and a few words can be typed beside one. Redaction is mosaic, blur, solid or Smooth (covered with the surrounding background, as if wiped away), as a box or a stroke; what is under it cannot be worked back out. - Smart redaction: after you rest on an area, WinShun reads it on your PC and finds phone numbers, ID card and bank card numbers, e-mail addresses, keys and this PC's user name, and offers “N found · click to redact”; one click (or the Smart redact button, or
Shift+B) covers them all and oneCtrl+Ztakes it back. It can miss some, so look once more before you send. - Screenshot translation: Translate on the capture toolbar pins the selection where it is with its words translated in place: the original words are covered with the background colour and the translation is set where they were, in their colour and at about their size, bold where they were bold and centred where they sat in the middle of a button. A picture already pinned can be translated too: Translate on its menu. "Translating…" shows in the corner meanwhile;
Tabturns the pin between the original and the translation, and its menu has Show the original and Copy the translation. It is a pin like any other: move it, zoom it, copy it, save it. Made for flat backgrounds such as windows, web pages and documents; words on a photo leave a patch, and slanted lines stay as they are. For plain text, choose Recognize text and then Translate in that window: the original above, the translation below, after editing or selecting some of it if you like (all of it when nothing is selected, up to 3,000 characters). A sentence the screen wrapped onto several lines is put together again before it is translated; short lines such as menus and lists stay one per line. The translation can be selected and copied, and a button copies all of it. It uses the Translate plugin from the plugin library with the service you set there, or any other plugin that says it can translate (0.32.0): the official one is asked first, and the next is tried when one has no service set up or fails; a translator installed but switched off is said so, with a button that turns it on; when the plugin or a service is missing, or the translation fails, the text recognition window opens instead and says so with a button that goes straight to the settings, and you go on from where you were. "Read text and translate" is also among the mouse button actions, and the toolbar button can be turned off in the settings. - Translate with a hotkey (Screenshot and recording 1.1.19): record a “Translate screen region” shortcut under Shortcuts in the capture settings (none by default), or use Screenshot › Translate screen region in the tray menu or
cap. Drag over an area or click a window, and when you let go the words are translated in place, as Translate on the toolbar does, with no toolbar and nothing in the screenshot history.Esc, a right click or the hotkey again cancels. It uses the service set up in the Translate plugin; when that is missing, the OCR window says why. - Whole windows only (1.1.19): before selecting,
Tab(the key Snipaste uses) outlines whole windows only, not the buttons and boxes inside them;TaborShift+Tabagain brings them back. The choice is kept, “Detect whole windows only while selecting” in the settings is the same switch, and it works when reading or translating text on screen too.Shift+arrow keys move the pointer ten pixels at a time before a selection. - Redact a line with a click: with the redact tool, a line of text under the pointer gets a red frame; a click covers that line, another click on it shows it again. Dragging still draws a box as before.
- Scrolling screenshots: for a web page, a chat, a document or a file list longer than the screen, choose the area and press
Ctrl+L(or Long screenshot on the toolbar): scroll manually while WinShun stitches the frames, then pressEnterto open the result in the editor. Turn on Auto-scroll when needed. Content that only scrolls sideways, or keeps moving, does not suit it. - Finishing:
Entercopies it, into the clipboard history too, where the words in it can be searched; with a save folder chosen in the screenshot's settings,Ctrl+Sor Save saves straight into it and the arrow beside Save offers “Save as…”; without one,Ctrl+Sopens the native Save As dialog and the arrow offers “Save to previous folder” (Pictures\Screenshots). Cancelling Save As keeps the selection and annotations. “Pin screenshots when copying” also pins it on the screen whenever it is copied. A marked-up picture can be opened and changed again later, from the clipboard history, the search box or a pin, with multi-select, a color picker and cropping. - Pins:
F3pins it on the screen, always on top: zoom, change opacity, rotate and flip, fold it to a small tile, read its text, or drag over the text withTto copy it. What “Double-clicking a pin” does (back to 100%, close, fold or nothing) is a setting. Capture › Pin image in the tray menu, or the configurable Pin image shortcut, pins a clipboard image first, then copied text (0.38.0, Screenshot and recording 1.1.26); otherwise it restores the last screenshot at its original position with annotations. Text is pinned as a card in the current style and theme, keeping its line breaks and indents (code in a monospaced font), the first part of a long text shown with “…”;Ctrl+Con it copies the whole text, and its menu also offers Copy picture. In the clipboard history,F3(Pin to screen) does the same for a text or link entry, except entries kept from view. A click-through pin can be reached again by holdingCtrlover it, to drag it or use its right-click menu.F3,Ctrl+Sand the keys inside a pin can be changed, or cleared, under Keys in the screenshot settings. - Edit a pin where it is (1.1.19):
E, or Edit in its menu, grows the toolbar on the pin itself (below it when there is no room above) instead of opening a window;Enteror Done puts the edited picture on the pin,Escleaves it as it was. Click a pin and pause, and its keys are listed in the bottom-left corner of the screen;?orF1shows or hides the list. - Close a pin from its corner (1.1.20): when the mouse comes onto a pin, a round close button appears in the corner on the side it came in from; one click closes the pin, no menu needed. The outermost corner still resizes; the button goes when the mouse leaves.
- Text and search: Recognize text on the toolbar shows the words in a picture to copy, to search with, or to search on the web; when they stand as a table (columns of words lined up), Copy as a table (Screenshot and recording 1.1.25) copies them with a tab between cells, so Excel and WPS paste them into cells (rows and columns come from where the words stand; merged cells and cells of several lines come out only roughly);
jtand a space in the search box list past screenshots by the text in them. - Presenter and whiteboard: Screenshot › Presenter / whiteboard in the tray menu, or
cap whiteboard; you can also record a hotkey for it in the screenshot settings under Shortcuts (none by default). It draws on the live desktop: pen, highlighter, arrow, text, numbers, andXfor a laser pointer whose trail fades at once.Escor a right click hands the mouse and keyboard back to the programs below (to flip a slide, say);Wis a whiteboard andKa blackboard. The ink is pixels on the screen, so recordings and screen sharing need to capture the whole screen. - Yours to set: what a double left click, the right, middle and side buttons do after you have chosen an area (copy, copy and pin, save, pin, read text and copy, search or search the web, cancel, step back), and which buttons the toolbar shows.
Taskbar search box
WinShun's own search box on the Windows 11 taskbar, or a pinned WinShun icon instead (the only way on Windows 10). The box has a fixed place the icons never push around: the taskbar's left end with centred icons, left of the tray icons with left-aligned ones; a whole box, its icon and label, or its icon alone, as Windows' own search, narrower by itself when the taskbar fills up. Under Search box position you can keep it beside the tray with centred icons too. It works on its own or alongside Windows search; hiding Windows search, taking over Win+S, and searching as you type in the Start menu are all optional.
AI assistants (MCP)
- What: WinShun is an MCP server. Claude Desktop, Claude Code, Cursor and VS Code connect in one click and search file names, file contents and recent changes.
- Safety: read-only by default, limited to what the AI client may see, with folders kept from AI and a call log.
- Setting up: tell the AI to “set up WinShun for me”; it asks a few questions and changes several settings in one go. A window asks you first, a notice at the bottom right says what changed and offers Undo for a few seconds; security-related settings always ask.
- Command line
ws: search from a terminal, like Everything'ses:ws report(names),ws grep invoice(contents),ws text plan.docx(a document's text),ws recent --days 7. AI agents that run commands (Claude Code, Codex) need less context with it than with MCP;ws skill --install claudeinstalls its instructions, andnpx skills add LingCore/WinShuninstalls them for other assistants, together with skills for writing a plugin and for working on WinShun itself.ws pluginmanages plugins:list,search translate,install <id, package or folder>,enable,disable,remove; what needs your yes (a plugin's permissions the first time it is turned on, an unreviewed package, a removal) WinShun asks you in its own window. It shares MCP's switch and safety settings.
Looks and settings
-
Interface font. Choose a font in Appearance. It applies across all interface styles, light and dark, while menus follow the interface size. A font may be chosen under its English or its Chinese name (LXGW WenKai and 霞鹜文楷 are the same font) and stays chosen after a restart (0.29.0); the list shows each font once, under the name Windows lists it by. The list has a search row of its own: type part of a name, move through the matches with the arrow keys or
Page Up/Page Down, and take one withEnter(0.31.0). -
Double-tap actions. Choose search, clipboard history or a compatible enabled plugin action for a Ctrl, Alt or Shift double tap under Settings › Shortcuts › Open WinShun.
-
Preview handoff. The content pane's native Preview tab can take over the current floating preview with its document layout. Preview-follow behavior is configurable and placement is steadier near screen edges.
-
On-demand UI. The search panel and some row actions are created when needed, reducing the number of objects in ordinary search. Health focuses on current activity and memory use.
-
Interface styles: Settings › Appearance › Interface style offers four looks for every window: Refined native (精修原生, the default: Windows 11's own, following the accent colour), Brand colours (品牌色彩), Soft tactile (轻拟物质感: raised keys, light depth) and Liquid Glass (液态玻璃: Windows' own Acrylic behind restrained glass surfaces, with two sliders for transparency and clarity), each in light and dark.
-
Looks: light and dark themes following Windows, see-through Mica on Windows 11 (in the Refined native and Brand colours styles), Windows' own rounded corners or square ones, sharp icons at any scaling; dense (one line per result in the launcher, 0.33.0), compact, standard or roomy sizes, and a monochrome tray and taskbar icon if you like; the app logo stays inside the search bar as its persistent action control.
-
Settings: searchable (
Ctrl+F); changes apply at once. Since 0.37.0 in fewer, clearer categories: General (with updates, startup, backup, network, storage and diagnostics), Shortcuts, Appearance, Search scope, Result list, Integration (taskbar, file managers, dialogs), Favorites, Clipboard, Plugins, AI assistants, Health and Gleaning. -
Open animation: Settings › Appearance › Open animation slides and fades the search box and, since 0.37.0, the clipboard in and out; turn it off and both appear at once.
-
Hover tips (0.36.0): turn off Settings › Appearance › Hover tips and the icons of the kind strip, the plus buttons and the buttons on rows no longer pop up their explanations. The "i" explanations in Settings, and full names of rows too long to show, still appear.
-
Window sizes (0.40.0): the settings window, Screenshot settings and Image text search open at the size you last dragged them to, maximized if you left them so, the next start too, on the screen under the pointer and never larger than it. A double click on such a window's edge gives it its default size. Turn off Settings › Appearance › Remember window sizes and they open at their default size each start; the sizes kept are cleared.
-
File manager: folders and file locations open in File Explorer, Total Commander, Directory Opus, XYplorer or Pulse (those installed are listed), or in any other file manager whose commands you enter under Settings › Integration › File managers.
-
Backup: choose a folder under Settings → General → Backup (a synced folder makes it a cloud backup); settings, favorites, dialog pins, your own web icons and plugins are backed up as they change, the last 10 kept, ready to restore.
-
Cloud backup (the Cloud Backup plugin from the library): for a WebDAV address (Nextcloud, a NAS, 坚果云) or a private GitHub repository instead of a synced folder. Fill in its card; changed settings are uploaded by themselves, the last 10 kept at each place. Type
cloudand a space: Enter backs up now, and Enter on one of the backups listed below (then once more to confirm) restores it after saving the present settings on this computer. Passwords stay in Windows Credential Manager; nothing is uploaded to a public repository. -
Move to another PC: under Settings → General → Backup, choose “Export backup…” to save a ZIP, then “Restore from backup…” on the new PC. Automatic backups need not be enabled. The current configuration is saved locally first; enter plugin passwords again and check custom paths on the new PC.
-
Updates: announced in the tray (checked every 10 minutes, at almost no cost when nothing is new). A usual version reaches each PC at its own moment within a day of its release; one that fixes something important is announced within minutes, as “an important update”. Check for updates in the settings to see a new version at once. “Download and install” fetches the package, checks its SHA-256 and installs it (the portable copy swaps only its program files, never
data; a copy installed with Scoop offers “Update with Scoop” instead and letsscoop updatedo it). From one of the last few versions only what changed is downloaded (usually a few MB, not the whole package); if the program's files were changed here or the download does not go well, the full package is downloaded instead. Downloading the installer yourself still works.
winshun:// links
A winshun:// link in a web page, a notes app such as Obsidian, a desktop shortcut or a script opens WinShun's search box with the words filled in, or its settings (0.33.0):
winshun://search/words: the search box, searching for “words” at once; everything aftersearch/counts, slashes too (winshun://search/D:/Work/contract).winshun://search?q=words: the same in the style of a web form (+is a space here);winshun://searchalone just opens the box.winshun://settings, orwinshun://settings/<page>for one page, by the names the AI toolopen_settingsuses (general,shortcuts,appearance,scope,contentfor Search scope › File contents,results,taskbar,files_and_dialogs,favorites,clipboard,web,paste_file). The olderadvancedandstartupstill work and open General.winshun://settings/plugin/<id>opens the settings at that plugin's card (0.38.0), aswinshun://settings/plugin/winshun.capture. Search for the plugin's name withsettingsand pressCtrl+Shift+Con the row to copy it.
Spaces, &, # and % in the words are written percent-encoded (%20 for a space). Links never open files. The link is registered for your own account, pointing at the WinShun in use, checked at each start; turn it off under Settings › Integration › File managers (“winshun:// links”, on by default), which also removes it, as uninstalling does.
Keys
| Key | Action |
|---|---|
| Ctrl twice | Open / close the search bar (Alt or Shift twice instead, or another shortcut such as Alt+Space, can be set) |
Enter / Ctrl+Enter / Ctrl+Shift+Enter |
Open / show in folder / run as administrator |
Ctrl+C / Ctrl+Shift+C |
Copy the file / copy its path |
F2 |
Rename the selected file or folder in place |
Ctrl+1…Ctrl+9 |
Open the nth row (numbers visible by default; hold-only is optional) |
Tab / Shift+Tab |
Switch scope: All / Files / Content, and Apps when its tab is on (forward / back) |
Tab (on a folder chosen with ↑ ↓ or a click) |
Go into the folder and list what is in it; complete a half-typed path |
Ctrl+Backspace (the caret at the end of a path) |
Up a level: out of a folder entered with Tab, back to the search before it |
Ctrl+Tab / Ctrl+Shift+Tab |
In Files, step through the kinds; in Content, through the folders |
Ctrl+S |
Best match → newest first → oldest first (name, type and size are under More in the footer) |
Ctrl+J / Ctrl+N, Ctrl+K / Ctrl+P |
Move down / up; Ctrl+U / Ctrl+D pages up / down |
Ctrl+, |
Open WinShun settings |
Ctrl+E / Ctrl+T |
Expand to the search panel / pin the search box (stays up through clicks elsewhere) |
Ctrl+Shift+D (opened by typing in a folder window) |
Cycles: current folder first, only the current folder, only this level (no subfolders) |
Alt+P / Shift+right-click |
Preview the row / Windows' own context menu |
Ctrl+G (in a file dialog) |
Go to the folder shown in your file manager |
Win+V / Win+S (once turned on) |
Clipboard history / search above the taskbar |
| A shortcut you set (Settings › Integration › File managers) | The folder menu in any window; again to close it |