Dashboard: My filters
Do not add filters from untrusted sources
Classic malicious filter can modify the appearance of a website to fool the user.
"Trusted filters", filters requiring trust, marked in documentation as "Can only be used in a trusted-source origin", can directly execute code on web pages and make you harm. These type of filters can be used only in filter lists from uBlock Origin/uAssets repository and to use them in "My filters" you need to explicity enable setting bellow.
This will enable filters on this page. It's the same as "My filters" entry on "Filter lists" tab.
This will allow to use in "My filters", "Trusted filters", filters requiring trust, marked in documentation as "Can only be used in a trusted-source origin".
Caution
These filters can directly execute code on web pages and make you harm.
uBlock Origin (uBO) uses CodeMirror's widget to freely edit your filters as plain text.
Additionaly uBO uses also syntax highlighter (linter) to detect warnings and errors in your filters (and in filter lists).
The following keyboard shortcuts are available during editing -- most of them are handled by CodeMirror by default (I mostly lazily transcribed CodeMirror's own documentation):
PC_______________
|
Mac_______________
|
Function_______________
|
|---|---|---|
| Ctrl-Space | Cmd-Space | (uBO-specific) Auto-complete, whenever applicable: network filter options, cosmetic pseudo-operators, redirect and scriptlet tokens, pre-parsing directives. |
| Tab | Tab | (uBO-specific) Toggle prepending the current line or the lines in the current selection with ! (to quickly toggle the commenting out of filters). |
| Ctrl-A | Cmd-A | Select the whole content of the editor. |
| Ctrl-D | Cmd-D | Deletes the whole line under the cursor, including newline at the end. |
| Ctrl-Z | Cmd-Z | Undo the last change. Note that, because browsers still don't make it possible for scripts to react to or customize the context menu, selecting undo (or redo) from the context menu in a CodeMirror instance does not work. |
| Ctrl-Y | Cmd-Y | Redo the last undone change. |
| Ctrl-U | Cmd-U | Undo the last change to the selection, or if there are no selection-only changes at the top of the history, undo the last change. |
| Alt-U | Shift-Cmd-U | Redo the last change to the selection, or the last text change if no selection changes remain. |
| Ctrl-Home | Cmd-Home | Move the cursor to the start of the document. |
| Ctrl-End | Cmd-End | Move the cursor to the end of the document. |
| Home | Home | Move to the start of the text on the line, or if we are already there, to the actual start of the line (including whitespace). |
| End | End | Move to the end of the line. |
| Up | Ctrl-P | Move the cursor up one line. |
| Down | Ctrl-N | Move down one line. |
| Page Up | Shift-Ctrl-V | Move the cursor up one screen, and scroll up by the same distance. |
| Page Down | Ctrl-V | Move the cursor down one screen, and scroll down by the same distance. |
| Left | Ctrl-B | Move the cursor one character left, going to the previous line when hitting the start of line. |
| Right | Ctrl-F | Move the cursor one character right, going to the next line when hitting the end of line. |
| Ctrl-Left | Alt-Left | Move to the left of the group before the cursor. A group is a stretch of word characters, a stretch of punctuation characters, a newline, or a stretch of more than one whitespace character. |
| Ctrl-Right | Alt-Right | Move to the right of the group after the cursor (see above). |
| Backspace | Ctrl-H | Delete the character before the cursor. |
| Delete | Ctrl-D | Delete the character after the cursor. |
| Ctrl-Backspace | Alt-Backspace | Delete to the left of the group before the cursor. |
| Ctrl-Delete | Alt-Delete | Delete to the start of the group after the cursor. |
| Ctrl-] | Cmd-] | Indent the current line or selection by one indent unit. |
| Ctrl-[ | Alt-[ | Dedent the current line or selection by one indent unit. |
| Ctrl-S | Cmd-S | Save and apply the changes, if any. |
| Ctrl-F | Cmd-F | Find a string. Wrap around / to search against a regular expression. |
| Ctrl-G | Cmd-G | Find next occurrence after the current cursor position. |
| Shift-Ctrl-G | Shift-Cmd-G | Find previous occurrence before the current cursor position. |