-
-
Notifications
You must be signed in to change notification settings - Fork 68
Features
All settings for EPT are inside PowerToys Settings.
If you're using the stable release of EPT and Everything 1.4, the you also have a few additional settings inside settings.toml.
- Options are in the
PowerToys Settings
window, underSystem Tools/PowerToys Run
there's a list of plugins; at the very bottom there'll be a panel forEverything
orEverything3
*This option only exists in EPT3
If you're running multiple instances of Everything, each with a slightly different search setting, you can specify the instance you would like EPT3 to use for the search.
Currently you can only link to 1 instance. If you didn't configure any named instances, the default name for Everything 1.5a is 1.5a
, or if you disabled alpha_instance
, remove all values and leave this field blank.
Additional options for the result, when a result is highlighted, some icons will display on the right, each icon corresponds to an option. Depending on what type the result is, some options might not show (ie: run as
options will only show if it's a program/shortcut).
As of v0.88.0, there are 9 possible options:
-
Open folder: opens the folder containing the result in file explorer
- Hotkey:
Ctrl+Shift+E
- Hotkey:
-
Run as Administrator: runs the selected result as administrator (Only available if the result type is a program/shortcut)
- Hotkey:
Ctrl+Shift+Enter
- Hotkey:
-
Run as User: runs the selected result as another user of the computer (Only available if the result type is a program/shortcut)
- Hotkey:
Ctrl+Shift+U
- Hotkey:
-
Copy: copies the selected file/folder
- Hotkey:
Ctrl+Alt+C
(default, swappable)
- Hotkey:
-
Copy path: copies the path of the selected file/folder
- Hotkey:
Ctrl+C
(default, swappable)
- Hotkey:
-
Open in console: opens a console in the directory of the selected file/folder
- Hotkey:
Ctrl+Shift+C
- Hotkey:
-
Open in custom program: uses a custom program to open the selected file/folder (requires some configuration, does not support all program)
- Hotkey:
Ctrl+N
- Hotkey:
-
Delete file/folder: deletes the file/folder. Note that this deletion is instant and permanent without requiring confirmation from the user. This action cannot be undone as the deleted file/folder does not go into the recycling bin. Also note that by default PT Run shows the previous result upon the next activation, meaning the file/folder you deleted will still be shown. Due to these "buggy" behaviour, this option is not enabled by default.
- Hotkey:
Ctrl+Del
- Hotkey:
-
Shell context menu: displays the extended shell context menu for the file/folder. This context menu should be the same context menu you'll see when shift+right clicking on the item in file explorer. The only option you won't see on the menu is Rename. If you use the delete option in the context menu, similar "buggy" behaviours from 7 will occur, but the deleted file/folder will be in the recycling bin. Note that when using the hotkey to call the menu, the menu will be displayed where your mouse cursor is, and not where the menu button is.
- Hotkey:
Ctrl+M
- Hotkey:
The order of the numbers will dictate the order the icons appear in the context menu.
EPT
Change how the display results are ordered, by default it uses the same sort method as Everything: NAME_ASCENDING
. This is done to provide a consistent user experience to first time users.
This option is independent of Everything's sort setting, and does not override the sort method set in Everything. The recommended sort method is DATE_MODIFIED_DESCENDING
or RUN_COUNT_DESCENDING
, but you may test different options to find the one that best fits your use case.
EPT3
With Everything's SDK3, advanced sorting is possible, by default EPT3 will sort by RUN_COUNT DESCENDING
, then by DATE_MODIFIED DESCENDING
. But depending on your preference, you may want to have NAME ASCENDING
to be your second sort filter. If you don't check the Descending
checbox it'll be ascending.
With both EPT and EPT3, you can use the filter sort:
to override the sort setting for a single query.
Example:
if you wish to sort by sizesort:size
The maximum number of results to show in PTR.
Default is set to 10 because of the Show more
option that's available. You can increase or decrease this number as needed.
Most users will not need this feature, but if you wish to use EPT to search only a specific folder, file type...etc, you can use this option to add a prefix to all your searches.
Example:
if you wish to only search for pdf files with EPT, type in
search filters such asdoc:
also works (a space is not strictly needed after a search filter)
This is for Show more
option.
If you installed Everything to the default locations in C:\Program Files
, you don't need to set anything here.
If you installed Everything to another drive or folder, you'll need to provide the full path (ie: D:\Everything\Everything.exe
)
This is for Context Menu option 6.
Provide the path to the executable file of the program you wish to use to launch the search result.
This is for Context Menu option 6.
Depending on how the program you wish to use accepts start arguments, you'll have to configure this accordingly. Read the documentation for the program you wish to use.
This checkbox swaps the shortcut for Context Menu Copy
and Copy path
Most users will not need this feature, but if you wish for EPT to resolve environment variables such as %temp%
or any other (custom) enviroment variable, check this option.
Do note that resolving environment variables will impact query speed.
By default, Everything uses the query to search for file names only. By enabling this feature, Everything will also match the query to the file path, such that if you search for files
, C:\Program Files\Everything\Everything.exe
will also be returned as a valid result.
Do note that Match Path creates conflicts with Regex, it is recommended that you use \
to search the path instead of enabling this feature (ie: \program windows
will search for a filename containing windows that has the word program in its file path)
PTR will try to preview the content of the result as an icon.
If you use cloud drives (One Drive, Google Drive, Drop Box..etc), when trying to preview the content of a online file (without local cache), it might create slowdowns, or temporary freezes if the max value is very high or if your connection to the cloud drive is very slow.
Without preview option, files will have an icon of
while folders will have an icon of
When enabled, highlighting search results will change the query text.
This may behaviour might be desirable if you're doing incremental searches, such as searching for a folder, highlighting the folder to search further inside the folder.
While this is the default behaviour for the search plugin in PTR, I prefer to have the query text constant, so I can add or remove query keywords quickly if I don't see the result I want, so this feature is not enabled by default.
Allows you to use regular expressing in the query text.
Regex changes how Everything search of results on the backend, so results might not be expected. If you do not use regex very often, it's recommended to not turn on this feature, and use the keyword regex:
when you need to use it
Example
audio: 101 regex:(\d{5})
Searches for audio file with 101 in file name(/path) and must have 5 digits
This option is independent of Everything's setting, and does not override setting in Everything.
Displays an additional result to launch Everything Search with the current query.
This is a convenience feature, so that you can see more results using Everything, without needing to increase the Max option, as Everything displays results in a more compact window, allowing you to see more results at a glance instead of scrolling through PTR.
On startup of PT, the plugin will check the github repo for the latest release version.
If a newer version is available, a notice window will appear.
-
Yes
: it'll automatically download the exe file on the release page and run it*. -
No
: you will not get notified again for the current updated, but will get notified if another update is available. (ie: Won't be notified again to update to 0.85.1, but if 0.86.0 is released, you'll be notified) -
Cancel
: you'll close the window, but still get notified the next time you launch PT.
* If you're on v0.88.0 and beofre, you'll need to manually exit out of PT before the updater can successfully update EPT. But for versions after v0.88.0, EPT will close PT forcibly when you click Yes. You'll receive an error if PT is still running.
Keep this option on Error
unless you wish to report a bug with additional debugging information, in which case you can switch to Trace
or Debug
.
Debug minimizes personal information; while
Trace aims to provides as much info as possible, including file paths and file names.
EPT supports the drag and drop feature of PTR.
You can drag a result from PTR to copy the file/folder to the dropped location, or drop the file/folder in a application to open it in that application.
The settings.toml
file in EPT's install directory under %LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Plugins
is only for achieving filter functions with Everything 1.4, as 1.4 does not process filters when queried thru the API, so it has to be implemented separately.
If you are using Everything 1.5, this file has no effects as of v0.86.0, and it not included with EPT3.
With 1.5, it does process the default and custom filters set in Everything when queried through the API.
In 1.5, the filters can be customized in Search -> Organize Filters...
(Ctrl+Shift+K)