Tridactyl help page

Use :help <excmd> or scroll down to show help for a particular excmd. If you're still stuck, you might consider reading through the :tutor again.

The default keybinds and settings can be found here and active binds can be seen with :viewconfig nmaps or with bind.

Tridactyl also provides a few functions to manipulate text in the command line or text areas that can be found here. There are also a few commands only available in the command line which can be found here.

Ex-commands available exclusively in hint mode are listed here

We also have a wiki which may be edited by anyone.

How to use this help page

Every function (excmd) on this page can be called via Tridactyl's command line which we call "ex". There is a slight change in syntax, however. Wherever you see:

function(arg1,arg2)

You should instead type

function arg1 arg2 into the Tridactyl command line (accessed via :)

A "splat" operator (...) means that the excmd will accept any number of space-delimited arguments into that parameter.

Above each function signature you will see any aliases or key sequences bound to it. The internal names for the various modes are used, which are listed here:

- `nmaps`: normal mode binds
- `imaps`: insert mode binds
- `inputmaps`: input mode binds
- `ignoremaps`: ignore mode binds
- `exaliases`: aliases in the command mode
- `exmaps`: commandline mode binds

At the bottom of each function's help page, you can click on a link that will take you straight to that function's definition in our code.

You do not need to worry about types. Return values which are promises will turn into whatever they promise to when used in composite.

Caveats

There are some caveats common to all webextension vimperator-alikes:

To make Tridactyl work on addons.mozilla.org and some other Mozilla domains, you need to open about:config and add a new boolean privacy.resistFingerprinting.block_mozAddonManager with the value true, as well as remove those domains from extensions.webextensions.restrictedDomains.
Tridactyl can't run on about:*, some file:* URIs, view-source:*, or data:*, URIs.
To change/hide the GUI of Firefox from Tridactyl, you can use guiset with the native messenger installed (see native and nativeinstall). Alternatively, you can edit your userChrome yourself.

Getting help

For more information, and FAQs, check out our readme and troubleshooting guide on github.

Tridactyl is in a pretty early stage of development. Please report any issues and make requests for missing features on the GitHub project page. You can also get in touch using Matrix, Gitter, or IRC chat clients:

All three channels are mirrored together, so it doesn't matter which one you use.

Functions

abbreviate
addTridactylEditorClass
apropos
autocmd
autocmddelete
autocontain
autocontaindelete
back
bind
bindshow
bindurl
bindwizard
blacklistadd
bmark
bmarks
changelistjump
clearsearchhighlight
clipboard
colourscheme
comclear
command
composite
containerclose
containercreate
containerdelete
containerupdate
credits
cssparse
define
dialog
drawingerasertoggle
drawingstart
echo
editor
elementunhide
escapehatch
exclaim
exclaim_quiet
extoptions
fillcmdline
fillcmdline_nofocus
fillcmdline_notrail
fillcmdline_tmp
fillinput
find
findnext
findselect
firefoxsyncpull
firefoxsyncpush
fixamo
fixamo_quiet
focusbyid
focusinput
followpage
forward
fullscreen
get
getclip
getGotoSelectors
getinput
getInputSelector
getNativeVersion
getRssLinks
geturlsforlinks
gobble
goto
guiset
guiset_quiet
help
hidecmdline
hint
hintinput
hintstylesdirect
hintstylesnohighlights
hintstylesoverlays
home
issue
js
jsb
jsonview
jsua
jumble
jumpnext
jumpprev
keyfeed
keymap
loadaucmds
loadtheme
markadd
markaddglobal
markaddlocal
markjump
markjumpbefore
markjumpglobal
markjumplocal
mktridactylrc
mode
mouse_mode
mute
native
nativeinstall
nativeopen
neo_mouse_mode
nmode
no_mouse_mode
open
open_quiet
perfdump
perfhistogram
pied_piper_mouse_mode
pin
profilecreate
profilelaunch
profilerename
proxyadd
proxyremove
qall
quickmark
quickmarkremove
reader
readerold
recontain
reload
reloadall
reloadallbut
reloaddead
reloadhard
removepref
removeTridactylEditorClass
repeat
reset
reseturl
restart
rot13
rssexec
run_exstr
sanitise
saveas
scrollline
scrollpage
scrollpx
scrollstart
scrollstop
scrolltab
scrollto
searchsetkeyword
set
setContentStateGroup
setmode
setnull
setpref
seturl
shellescape
showcmdline
sidebaropen
sidebartoggle
sleep
snow_mouse_mode
source
source_quiet
tab
tab_helper
taball
tabaudio
tabclose
tabcloseallto
tabdetach
tabdiscard
tabduplicate
tabfirst
tabgrab
tablast
tabmove
tabnext
tabnext_gt
tabonly
tabopen
tabopenwait
tabprev
tabpush
tabqueue
tabrename
tabsort
text2qr
tgroupabort
tgroupclose
tgroupcreate
tgrouplast
tgroupmove
tgrouprename
tgroupswitch
tstattach
tstmove
tstmoveafter
ttscontrol
ttsread
ttsvoices
tutor
unabbreviate
unbind
unbindurl
undo
unfocus
unkeymap
unloadtheme
unset
unsetmode
unseturl
updatecheck
updatenative
url2args
urlincrement
urlmodify
urlmodify_js
urlparent
urlroot
version
viewconfig
viewcontainers
viewsource
winclose
winmerge
winopen
wintitle
yank
yankimage
zoom

Functions

abbreviate

abbreviate(abbreviation: string, ...expansion: string[]): Promise<any>
Parameters
- abbreviation: string
- ...expansion: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3996

addTridactylEditorClass

addTridactylEditorClass(selector: string): Promise<any>
Parameters
- selector: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:255

apropos

apropos(...helpItems: string[]): Promise<any>
Parameters
- ...helpItems: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1623

autocmd

autocmd(event: string, url: string, ...excmd: string[]): Promise<any>
Parameters
- event: string
- url: string
- ...excmd: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4428

autocmddelete

autocmddelete(event: string, url: string): Promise<any>
Parameters
- event: string
- url: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4539

autocontain

autocontain(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4475

autocontaindelete

autocontaindelete(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4493

back

back(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1296

bind

bind(...args: string[]): Promise<void>
Parameters
- ...args: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:4066

bindshow

bindshow(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4105

bindurl

bindurl(
    pattern: string,
    mode: string,
    keys: string,
    ...excmd: string[],
): Promise<void>
Parameters
- pattern: string
- mode: string
- keys: string
- ...excmd: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:4142

bindwizard

bindwizard(...args: string[]): Promise<any>
Generate a key sequence from keypresses. Once Enter is pressed, the command line is filled with a bind command with the key sequence and provided arguments, which you can choose to modify and execute.

If you have :set keyboardlayoutforce true, it will bind commands to physical keys regardless of layout.

Accepts the same arguments as bind (except for the key sequence which will be generated):
```
- `bindwizard [command]`, then press the keys you want to bind, then hit Enter.
- `bindwizard --mode=[mode] [command]` also works.
```
You can execute it without arguments to see what is bound to the keys you type.
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4123

blacklistadd

blacklistadd(url: string): Promise<any>
Parameters
- url: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4560

bmark

bmark(url?: string, ...titlearr: string[]): Promise<BookmarkTreeNode>
Parameters
- Optionalurl: string
- ...titlearr: string[]
Returns Promise<BookmarkTreeNode>
- Defined in .excmds_background.generated.ts:5367

bmarks

bmarks(opt: string, ...urlarr: string[]): Promise<any>
Parameters
- opt: string
- ...urlarr: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1388

changelistjump

changelistjump(): Promise<void>
Returns Promise<void>
- Defined in .excmds_background.generated.ts:2110

clearsearchhighlight

clearsearchhighlight(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1251

clipboard

clipboard(
    excmd?:
        | "open"
        | "tabopen"
        | "yank"
        | "yankshort"
        | "yankcanon"
        | "yanktitle"
        | "yankmd"
        | "yankorg"
        | "xselpaste",
    ...toYank: string[],
): Promise<any>
Parameters
- excmd:
      | "open"
      | "tabopen"
      | "yank"
      | "yankshort"
      | "yankcanon"
      | "yanktitle"
      | "yankmd"
      | "yankorg"
      | "xselpaste" = "open"
- ...toYank: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3757

colourscheme

colourscheme(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:457

comclear

comclear(name: string): void
Parameters
- name: string
Returns void
- Defined in .excmds_background.generated.ts:3990

command

command(name: string, ...definition: string[]): Promise<any>
Parameters
- name: string
- ...definition: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3967

composite

composite(...cmds: string[]): Promise<any>
Parameters
- ...cmds: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3523

containerclose

containerclose(...name: string[]): Promise<void>
Parameters
- ...name: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3071

containercreate

containercreate(...args: string[]): Promise<void>
Parameters
- ...args: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3086

containerdelete

containerdelete(...name: string[]): Promise<void>
Parameters
- ...name: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3096

containerupdate

containerupdate(
    name: string,
    uname: string,
    ucolor: string,
    uicon: string,
): Promise<void>
Parameters
- name: string
- uname: string
- ucolor: string
- uicon: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3118

credits

credits(): Promise<Tab>
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:1646

cssparse

cssparse(...css: string[]): void
Parameters
- ...css: string[]
Returns void
- Defined in .excmds_background.generated.ts:400

define

define(...words: string[]): Promise<any>
Parameters
- ...words: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1615

dialog

dialog(...nameArgs: string[]): Promise<void>
Parameters
- ...nameArgs: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:636

drawingerasertoggle

drawingerasertoggle(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1734

drawingstart

drawingstart(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1721

echo

echo(...str: string[]): string
Parameters
- ...str: string[]
Returns string
- Defined in .excmds_background.generated.ts:5426

editor

editor(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:302

elementunhide

elementunhide(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5809

escapehatch

escapehatch(): Promise<void>
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3586

exclaim

exclaim(...str: string[]): Promise<void>
Parameters
- ...str: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:658

exclaim_quiet

exclaim_quiet(...str: string[]): Promise<string>
Parameters
- ...str: string[]
Returns Promise<string>
- Defined in .excmds_background.generated.ts:670

extoptions

extoptions(...optionNameArgs: string[]): Promise<any>
Parameters
- ...optionNameArgs: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5769

fillcmdline

fillcmdline(...strarr: string[]): Promise<any>
Parameters
- ...strarr: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3626

fillcmdline_nofocus

fillcmdline_nofocus(...strarr: string[]): Promise<any>
Parameters
- ...strarr: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3648

fillcmdline_notrail

fillcmdline_notrail(...strarr: string[]): Promise<any>
Parameters
- ...strarr: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3637

fillcmdline_tmp

fillcmdline_tmp(ms: number, ...strarr: string[]): Promise<any>
Parameters
- ms: number
- ...strarr: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3659

fillinput

fillinput(selector: string, ...content: string[]): Promise<any>
Parameters
- selector: string
- ...content: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:220

find

find(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1222

findnext

findnext(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1241

findselect

findselect(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1264

firefoxsyncpull

firefoxsyncpull(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4339

firefoxsyncpush

firefoxsyncpush(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4351

fixamo

fixamo(): Promise<void>
Returns Promise<void>
- Defined in .excmds_background.generated.ts:534

fixamo_quiet

fixamo_quiet(): Promise<void>
Returns Promise<void>
- Defined in .excmds_background.generated.ts:516

focusbyid

focusbyid(id: string): Promise<any>
Parameters
- id: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:2142

focusinput

focusinput(nth: string | number): Promise<any>
Parameters
- nth: string | number
Returns Promise<any>
- Defined in .excmds_background.generated.ts:2084

followpage

followpage(rel?: "next" | "prev"): Promise<any>
Parameters
- rel: "next" | "prev" = "next"
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1790

forward

forward(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1281

fullscreen

fullscreen(): Promise<Window>
Returns Promise<Window>
- Defined in .excmds_background.generated.ts:2636

get

get(...keys: string[]): any
Parameters
- ...keys: string[]
Returns any
- Defined in .excmds_background.generated.ts:4826

getclip

getclip(from?: "clipboard" | "selection"): Promise<string>
Parameters
- Optionalfrom: "clipboard" | "selection"
Returns Promise<string>
- Defined in .excmds_background.generated.ts:3718

getGotoSelectors

getGotoSelectors(): Promise<
{ level: number; selector: string; title: string; y: number }[],
>
Returns Promise<{ level: number; selector: string; title: string; y: number }[]>
- Defined in .excmds_background.generated.ts:5169

getinput

getinput(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:233

getInputSelector

getInputSelector(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:244

getNativeVersion

getNativeVersion(): Promise<string>
Returns Promise<string>
- Defined in .excmds_background.generated.ts:178

getRssLinks

getRssLinks(): Promise<{ title: string; type: string; url: string }[]>
Returns Promise<{ title: string; type: string; url: string }[]>
- Defined in .excmds_background.generated.ts:186

geturlsforlinks

geturlsforlinks(reltype?: string, rel: string): Promise<any>
Parameters
- reltype: string = "rel"
- rel: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1966

gobble

gobble(
    numKeysOrTerminator: string,
    endCmd: string,
    ...args: string[],
): Promise<any>
Parameters
- numKeysOrTerminator: string
- endCmd: string
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5154

goto

goto(...selector: string[]): Promise<any>
Parameters
- ...selector: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5182

guiset

guiset(rule: string, option: string): Promise<any>
Parameters
- rule: string
- option: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:389

guiset_quiet

guiset_quiet(rule: string, option: string): Promise<any>
Parameters
- rule: string
- option: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:315

help

help(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1496

hidecmdline

hidecmdline(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3611

hint

hint(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5062

hintinput

hintinput(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:2095

hintstylesdirect

hintstylesdirect(): void
Style hintable elements directly when hinting.

Returns void
- Defined in .excmds_background.generated.ts:5936

hintstylesnohighlights

hintstylesnohighlights(): void
Disable all hilighting of hintable elements when hinting. Only hint flags will remain, Vimium style.

Returns void
- Defined in .excmds_background.generated.ts:5921

hintstylesoverlays

hintstylesoverlays(): void
Add highlights over the page when hinting and leave original elements unchanged.

Returns void
- Defined in .excmds_background.generated.ts:5928

home

home(all?: "false" | "true"): Promise<any>
Parameters
- all: "false" | "true" = "false"
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1452

issue

issue(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5632

js

js(...str: string[]): Promise<any>
Parameters
- ...str: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5583

jsb

jsb(...str: string[]): Promise<any>
Parameters
- ...str: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5624

jsonview

jsonview(...json: string[]): Promise<Tab>
Parameters
- ...json: string[]
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:4868

jsua

jsua(): Promise<void>
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3051

jumble

jumble(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5105

jumpnext

jumpnext(n?: number): Promise<any>
Parameters
- n: number = 1
Returns Promise<any>
- Defined in .excmds_background.generated.ts:959

jumpprev

jumpprev(n?: number): Promise<any>
Parameters
- n: number = 1
Returns Promise<any>
- Defined in .excmds_background.generated.ts:975

keyfeed

keyfeed(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5738

keymap

keymap(source: string, target: string): Promise<any>
Parameters
- source: string
- target: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4167

loadaucmds

loadaucmds(
    cmdType:
        | "DocBlur"
        | "DocEnd"
        | "DocFocus"
        | "DocLoad"
        | "DocStart"
        | "FullscreenChange"
        | "FullscreenEnter"
        | "FullscreenLeft"
        | "ModeEnter"
        | "ModeLeave"
        | "TabEnter"
        | "TabLeft"
        | "UriChange"
        | "HistoryState",
    target?: string,
): Promise<any>
Parameters
- cmdType:
      | "DocBlur"
      | "DocEnd"
      | "DocFocus"
      | "DocLoad"
      | "DocStart"
      | "FullscreenChange"
      | "FullscreenEnter"
      | "FullscreenLeft"
      | "ModeEnter"
      | "ModeLeave"
      | "TabEnter"
      | "TabLeft"
      | "UriChange"
      | "HistoryState"
- Optionaltarget: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:2029

loadtheme

loadtheme(themename: string): Promise<any>
Parameters
- themename: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:406

markadd

markadd(key: string): Promise<any>
Parameters
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1061

markaddglobal

markaddglobal(key: string): Promise<any>
Parameters
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1095

markaddlocal

markaddlocal(key: string): Promise<any>
Parameters
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1081

markjump

markjump(key: string): Promise<any>
Parameters
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:990

markjumpbefore

markjumpbefore(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1033

markjumpglobal

markjumpglobal(key: string): Promise<any>
Parameters
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1019

markjumplocal

markjumplocal(key: string): Promise<any>
Parameters
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1004

mktridactylrc

mktridactylrc(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:757

mode

mode(mode: string): Promise<any>
Parameters
- mode: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3444

mouse_mode

mouse_mode(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1748

mute

mute(...muteArgs: string[]): Promise<void>
Parameters
- ...muteArgs: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:2876

native

native(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:684

nativeinstall

nativeinstall(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:710

nativeopen

nativeopen(...args: string[]): Promise<void>
Parameters
- ...args: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:553

neo_mouse_mode

neo_mouse_mode(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1678

nmode

nmode(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5207

no_mouse_mode

no_mouse_mode(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1661

open

open(...urlarr: string[]): Promise<any>
Parameters
- ...urlarr: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1370

open_quiet

open_quiet(...urlarr: string[]): Promise<any>
Parameters
- ...urlarr: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1397

perfdump

perfdump(...filters: string[]): Promise<any>
Parameters
- ...filters: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5321

perfhistogram

perfhistogram(...filters: string[]): Promise<any>
Parameters
- ...filters: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5337

pied_piper_mouse_mode

pied_piper_mouse_mode(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1704

pin(index: string): Promise<Tab>
Parameters
- index: string
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:2863

profilecreate

profilecreate(profileName: string): Promise<void>
Parameters
- profileName: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:5884

profilelaunch

profilelaunch(profileName?: string): Promise<void>
Parameters
- OptionalprofileName: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:5864

profilerename

profilerename(oldName: string, newName: string): Promise<void>
Parameters
- oldName: string
- newName: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:5903

proxyadd

proxyadd(name: string, url: string): Promise<any>
Parameters
- name: string
- url: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4514

proxyremove

proxyremove(name: string): void
Parameters
- name: string
Returns void
- Defined in .excmds_background.generated.ts:4526

qall

qall(): Promise<void[]>
Returns Promise<void[]>
- Defined in .excmds_background.generated.ts:3024

quickmark

quickmark(key: string, ...addressarr: string[]): Promise<void>
Parameters
- key: string
- ...addressarr: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:4776

quickmarkremove

quickmarkremove(key: string): Promise<void>
Parameters
- key: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:4812

reader

reader(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5794

readerold

readerold(): Promise<void>
Returns Promise<void>
- Defined in .excmds_background.generated.ts:2014

recontain

recontain(...containerName: string[]): Promise<void>
Parameters
- ...containerName: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3152

reload

reload(n?: number, hard?: boolean): Promise<void[]>
Parameters
- n: number = 1
- hard: boolean = false
Returns Promise<void[]>
- Defined in .excmds_background.generated.ts:1307

reloadall

reloadall(hard?: boolean): Promise<void[]>
Parameters
- hard: boolean = false
Returns Promise<void[]>
- Defined in .excmds_background.generated.ts:1315

reloadallbut

reloadallbut(hard?: boolean): Promise<void[]>
Parameters
- hard: boolean = false
Returns Promise<void[]>
- Defined in .excmds_background.generated.ts:1325

reloaddead

reloaddead(hard?: boolean): Promise<void[]>
Parameters
- hard: boolean = false
Returns Promise<void[]>
- Defined in .excmds_background.generated.ts:1336

reloadhard

reloadhard(n?: number): Promise<void[]>
Parameters
- n: number = 1
Returns Promise<void[]>
- Defined in .excmds_background.generated.ts:1345

removepref

removepref(key: string): Promise<void>
Parameters
- key: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:506

removeTridactylEditorClass

removeTridactylEditorClass(selector: string): Promise<any>
Parameters
- selector: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:266

repeat

repeat(n?: number, ...exstr: string[]): Promise<void>
Parameters
- n: number = 1
- ...exstr: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3500

reset

reset(mode: string, key: string): Promise<any>
Parameters
- mode: string
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4635

reseturl

reseturl(pattern: string, mode: string, key: string): Promise<any>
Parameters
- pattern: string
- mode: string
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4655

restart

restart(): Promise<void>
Returns Promise<void>
- Defined in .excmds_background.generated.ts:877

rot13

rot13(n: number): Promise<any>
Parameters
- n: number
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5088

rssexec

rssexec(url: string, type?: string, ...title: string[]): Promise<any>
Parameters
- url: string
- Optionaltype: string
- ...title: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:205

run_exstr

run_exstr(...commands: string[]): Promise<any>
Parameters
- ...commands: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5120

sanitise

sanitise(...args: string[]): Promise<void>
Parameters
- ...args: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:4686

saveas

saveas(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:915

scrollline

scrollline(n?: number, mult?: number): Promise<any>
Parameters
- n: number = 1
- mult: number = 1
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1171

scrollpage

scrollpage(n?: number, count?: number): Promise<any>
Parameters
- n: number = 1
- count: number = 1
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1187

scrollpx

scrollpx(a: number, b: number): Promise<any>
Parameters
- a: number
- b: number
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1135

scrollstart

scrollstart(xVelocity: string, yVelocity: string, mult?: string): Promise<any>
Parameters
- xVelocity: string
- yVelocity: string
- Optionalmult: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5959

scrollstop

scrollstop(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5974

scrolltab

scrolltab(
    tabId: number,
    scrollX: number,
    scrollY: number,
    message: string,
): Promise<any>
Parameters
- tabId: number
- scrollX: number
- scrollY: number
- message: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1046

scrollto

scrollto(a: string | number, b?: number | "x" | "y"): Promise<any>
Parameters
- a: string | number
- b: number | "x" | "y" = "y"
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1155

searchsetkeyword

searchsetkeyword(): void
Returns void
- Defined in .excmds_background.generated.ts:4185

set

set(key: string, ...values: string[]): any
Parameters
- key: string
- ...values: string[]
Returns any
- Defined in .excmds_background.generated.ts:4300

setContentStateGroup

setContentStateGroup(name: string): Promise<any>
Parameters
- name: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3187

setmode

setmode(mode: string, key: string, ...values: string[]): Promise<any>
Parameters
- mode: string
- key: string
- ...values: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4276

setnull

setnull(...keys: string[]): Promise<any>
Parameters
- ...keys: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4933

setpref

setpref(key: string, ...value: string[]): Promise<void>
Parameters
- key: string
- ...value: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:495

seturl

seturl(pattern: string, key: string, ...values: string[]): Promise<any>
Parameters
- pattern: string
- key: string
- ...values: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4252

shellescape

shellescape(...quoteme: string[]): Promise<string>
Escape command for safe use in shell with composite. E.g: composite js MALICIOUS_WEBSITE_FUNCTION() | shellescape | exclaim ls
Parameters
- ...quoteme: string[]
Returns Promise<string>
- Defined in .excmds_background.generated.ts:3563

showcmdline

showcmdline(focus?: boolean): Promise<any>
Parameters
- focus: boolean = true
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3600

sidebaropen

sidebaropen(...urllike: string[]): Promise<void>
Parameters
- ...urllike: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3039

sidebartoggle

sidebartoggle(): Promise<void>
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3061

sleep

sleep(time_ms: number): Promise<unknown>
Parameters
- time_ms: number
Returns Promise<unknown>
- Defined in .excmds_background.generated.ts:3594

snow_mouse_mode

snow_mouse_mode(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1691

source

source(...args: string[]): Promise<void>
Parameters
- ...args: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:807

source_quiet

source_quiet(...args: string[]): Promise<void>
Parameters
- ...args: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:831

tab

tab(...id: string[]): Promise<any>
Parameters
- ...id: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3864

tab_helper

tab_helper(
    interactive: boolean,
    anyWindow: boolean,
    ...key: string[],
): Promise<any>
Parameters
- interactive: boolean
- anyWindow: boolean
- ...key: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3908

taball

taball(...id: string[]): Promise<any>
Parameters
- ...id: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3871

tabaudio

tabaudio(): Promise<Tab>
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:2273

tabclose

tabclose(...indexes: string[]): Promise<void>
Parameters
- ...indexes: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:2653

tabcloseallto

tabcloseallto(side: string): Promise<void>
Parameters
- side: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:2685

tabdetach

tabdetach(index?: string): Promise<Window>
Parameters
- Optionalindex: string
Returns Promise<Window>
- Defined in .excmds_background.generated.ts:2612

tabdiscard

tabdiscard(index: string): Promise<void>
Parameters
- index: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:2707

tabduplicate

tabduplicate(index?: number): Promise<Tab>
Parameters
- Optionalindex: number
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:2602

tabfirst

tabfirst(): Promise<Tab>
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:2170

tabgrab

tabgrab(id: string): Promise<Tab | Tab[]>
Parameters
- id: string
Returns Promise<Tab | Tab[]>
- Defined in .excmds_background.generated.ts:2327

tablast

tablast(): Promise<Tab>
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:2176

tabmove

tabmove(index?: string, tabToMove?: string): Promise<Tab | Tab[]>
Parameters
- index: string = "$"
- OptionaltabToMove: string
Returns Promise<Tab | Tab[]>
- Defined in .excmds_background.generated.ts:2777

tabnext

tabnext(...args: string[]): Promise<Tab>
Parameters
- ...args: string[]
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:2187

tabnext_gt

tabnext_gt(index?: number): Promise<any>
Parameters
- Optionalindex: number
Returns Promise<any>
- Defined in .excmds_background.generated.ts:2199

tabonly

tabonly(...args: string[]): Promise<void>
Parameters
- ...args: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:2581

tabopen

tabopen(...addressarr: string[]): Promise<Tab>
Parameters
- ...addressarr: string[]
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:2374

tabopenwait

tabopenwait(...addressarr: string[]): Promise<Tab>
Parameters
- ...addressarr: string[]
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:2382

tabprev

tabprev(...args: string[]): Promise<Tab>
Parameters
- ...args: string[]
Returns Promise<Tab>
- Defined in .excmds_background.generated.ts:2216

tabpush

tabpush(windowId?: number): Promise<Tab | Tab[]>
Parameters
- OptionalwindowId: number
Returns Promise<Tab | Tab[]>
- Defined in .excmds_background.generated.ts:2255

tabqueue

tabqueue(...addresses: string[]): Promise<unknown>
Parameters
- ...addresses: string[]
Returns Promise<unknown>
- Defined in .excmds_background.generated.ts:2509

tabrename

tabrename(index: string, ...name: string[]): Promise<any>
Parameters
- index: string
- ...name: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3891

tabsort

tabsort(...callbackchunks: string[]): Promise<void>
Parameters
- ...callbackchunks: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:2851

text2qr

text2qr(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5657

tgroupabort

tgroupabort(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3410

tgroupclose

tgroupclose(name?: string): Promise<string>
Parameters
- Optionalname: string
Returns Promise<string>
- Defined in .excmds_background.generated.ts:3322

tgroupcreate

tgroupcreate(name: string): Promise<string>
Parameters
- name: string
Returns Promise<string>
- Defined in .excmds_background.generated.ts:3214

tgrouplast

tgrouplast(): Promise<string>
Returns Promise<string>
- Defined in .excmds_background.generated.ts:3284

tgroupmove

tgroupmove(name: string): Promise<string>
Parameters
- name: string
Returns Promise<string>
- Defined in .excmds_background.generated.ts:3362

tgrouprename

tgrouprename(name: string): Promise<string>
Parameters
- name: string
Returns Promise<string>
- Defined in .excmds_background.generated.ts:3299

tgroupswitch

tgroupswitch(name: string): Promise<string>
Parameters
- name: string
Returns Promise<string>
- Defined in .excmds_background.generated.ts:3260

tstattach

tstattach(index: string): Promise<void>
Parameters
- index: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:5845

tstmove

tstmove(index: string): Promise<void>
Parameters
- index: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:5823

tstmoveafter

tstmoveafter(index: string): Promise<void>
Parameters
- index: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:5834

ttscontrol

ttscontrol(action: "pause" | "play" | "stop" | "playpause"): Promise<any>
Parameters
- action: "pause" | "play" | "stop" | "playpause"
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5270

ttsread

ttsread(mode: "-t" | "-c", ...args: string[]): Promise<any>
Parameters
- mode: "-t" | "-c"
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5239

ttsvoices

ttsvoices(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:5253

tutor

tutor(newtab?: string): Promise<any>
Parameters
- Optionalnewtab: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1631

unabbreviate

unabbreviate(abbreviation: string): Promise<any>
Parameters
- abbreviation: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4003

unbind

unbind(...args: string[]): Promise<void>
Parameters
- ...args: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:4579

unbindurl

unbindurl(pattern: string, mode: string, keys: string): Promise<any>
Parameters
- pattern: string
- mode: string
- keys: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4618

undo

undo(item?: string): Promise<number>
Parameters
- item: string = "recent"
Returns Promise<number>
- Defined in .excmds_background.generated.ts:2732

unfocus

unfocus(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1123

unkeymap

unkeymap(source: string): Promise<any>
Parameters
- source: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4177

unloadtheme

unloadtheme(themename: string): Promise<any>
Parameters
- themename: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:424

unset

unset(...keys: string[]): Promise<any>
Parameters
- ...keys: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4923

unsetmode

unsetmode(mode: string, key: string): Promise<any>
Parameters
- mode: string
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4910

unseturl

unseturl(pattern: string, key: string): Promise<any>
Parameters
- pattern: string
- key: string
Returns Promise<any>
- Defined in .excmds_background.generated.ts:4888

updatecheck

updatecheck(
source?: "manual" | "auto_polite" | "auto_impolite",
): Promise<boolean>
Parameters
- source: "manual" | "auto_polite" | "auto_impolite" = "manual"
Returns Promise<boolean>
- Defined in .excmds_background.generated.ts:5677

updatenative

updatenative(interactive?: boolean): Promise<void>
Parameters
- interactive: boolean = true
Returns Promise<void>
- Defined in .excmds_background.generated.ts:845

url2args

url2args(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1416

urlincrement

urlincrement(count?: number, multiplier?: number): Promise<any>
Parameters
- count: number = 1
- multiplier: number = 1
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1806

urlmodify

urlmodify(
    mode:
        | "-t"
        | "-s"
        | "-r"
        | "-g"
        | "--safe"
        | "-q"
        | "-Q"
        | "-tu"
        | "-ru"
        | "-su"
        | "-qu"
        | "-Qu"
        | "-gu",
    ...args: string[],
): Promise<any>
Parameters
- mode:
      | "-t"
      | "-s"
      | "-r"
      | "-g"
      | "--safe"
      | "-q"
      | "-Q"
      | "-tu"
      | "-ru"
      | "-su"
      | "-qu"
      | "-Qu"
      | "-gu"
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1933

urlmodify_js

urlmodify_js(
    mode:
        | "-t"
        | "-s"
        | "-r"
        | "-g"
        | "-q"
        | "-Q"
        | "-tu"
        | "-ru"
        | "-su"
        | "-qu"
        | "-Qu"
        | "-gu",
    ...args: string[],
): Promise<any>
Parameters
- mode:
      | "-t"
      | "-s"
      | "-r"
      | "-g"
      | "-q"
      | "-Q"
      | "-tu"
      | "-ru"
      | "-su"
      | "-qu"
      | "-Qu"
      | "-gu"
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1950

urlparent

urlparent(count?: number): Promise<any>
Parameters
- count: number = 1
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1830

urlroot

urlroot(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1818

version

version(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3423

viewconfig

viewconfig(...key: string[]): void
Parameters
- ...key: string[]
Returns void
- Defined in .excmds_background.generated.ts:4848

viewcontainers

viewcontainers(): Promise<any>
Returns Promise<any>
- Defined in .excmds_background.generated.ts:3131

viewsource

viewsource(url?: string): Promise<any>
Parameters
- url: string = ""
Returns Promise<any>
- Defined in .excmds_background.generated.ts:1434

winclose

winclose(...ids: string[]): Promise<void[]>
Parameters
- ...ids: string[]
Returns Promise<void[]>
- Defined in .excmds_background.generated.ts:3000

winmerge

winmerge(...windowIds: string[]): Promise<void>
Parameters
- ...windowIds: string[]
Returns Promise<void>
- Defined in .excmds_background.generated.ts:2286

winopen

winopen(...args: string[]): Promise<any>
Parameters
- ...args: string[]
Returns Promise<any>
- Defined in .excmds_background.generated.ts:2943

wintitle

wintitle(...title: string[]): Promise<Window>
Parameters
- ...title: string[]
Returns Promise<Window>
- Defined in .excmds_background.generated.ts:3015

yank

yank(...content: string[]): Promise<any[]>
Parameters
- ...content: string[]
Returns Promise<any[]>
- Defined in .excmds_background.generated.ts:3674

yankimage

yankimage(url: string): Promise<void>
Parameters
- url: string
Returns Promise<void>
- Defined in .excmds_background.generated.ts:3835

zoom

zoom(level?: number, rel?: string, tabId?: string): Promise<void>
Parameters
- level: number = 0
- rel: string = "false"
- tabId: string = "auto"
Returns Promise<void>
- Defined in .excmds_background.generated.ts:1986

Tridactyl help page

How to use this help page

Caveats

Getting help

Functions

Functions

abbreviate

Parameters

Returns Promise<any>

addTridactylEditorClass

Parameters

Returns Promise<any>

apropos

Parameters

Returns Promise<any>

autocmd

Parameters

Returns Promise<any>

autocmddelete

Parameters

Returns Promise<any>

autocontain

Parameters

Returns Promise<any>

autocontaindelete

Parameters

Returns Promise<any>

back

Parameters

Returns Promise<any>

bind

Parameters

Returns Promise<void>

bindshow

Parameters

Returns Promise<any>

bindurl

Parameters

Returns Promise<void>

bindwizard

Parameters

Returns Promise<any>

blacklistadd

Parameters

Returns Promise<any>

bmark

Parameters

Returns Promise<BookmarkTreeNode>

bmarks

Parameters

Returns Promise<any>

changelistjump

Returns Promise<void>

clearsearchhighlight

Returns Promise<any>

clipboard

Parameters

Returns Promise<any>

colourscheme

Parameters

Returns Promise<any>

comclear

Parameters

Returns void

command

Parameters

Returns Promise<any>

composite

Parameters

Returns Promise<any>

containerclose

Parameters

Returns Promise<void>

containercreate

Parameters

Returns Promise<void>

containerdelete

Parameters

Returns Promise<void>

containerupdate