Tridactyl has to override your new tab page due to WebExtension limitations. You can learn how to change it at the bottom of the page, otherwise please read on for some tips and tricks.
You can view the main help page by typing :help, and access the tutorial with :tutor.
You can view your current configuration with :viewconfig.
You can contact the developers, other users and contributors for support or whatever on Matrix, Gitter, or IRC.
If you're enjoying Tridactyl (or not), please leave a review on addons.mozilla.org.
Breaking change to composite: composite now tries to pass the return value from each preceding function to its ancestor. This might break some of your binds to composite, or cause them to act in unexpected ways.
:installnative to get going, and then Ctrl-i <C-i> in a text box to open your editor.Potentially breaking changes
composite now send return values to the following ex command. Use semi-colons if you want the old behaviour back (see bind D).DocStart autocommand now uses String.prototype.search for matching, so you can use regular expressions such as /www\.amazon\.co.*/.editor now includes the hostname of the site you are on in the temporary filename.
au BufReadPost *github.com* set syntax=pandocnative support for Windows: just do what installnative tells you to.
gvim is on your path.New autocommand events:
New commands:
:js and :jsb let you execute arbitrary javascript.:restart will restart Firefox if you have installed Tridactyl's native executable.:fixamo will make Tridactyl work on addons.mozilla.org. Requires a :restart.Hint improvements:
:hint -P.hint -; now accepts selectors.Multiple improvements for the mode indicator. It will:
There is now a jumplist:
<C-o> or :jumpprev will go to your previous location.<C-i> or :jumpnext will go to the next location in your jumplist.Themes:
shydactyl, greenmat, quake were added.Add new internal structure for themes - check out contributing.md on the repository if you want to add your own
The long awaited blacklist to automatically enter ignore mode on some websites is now available! See :h blacklistadd.
Ignore mode can now also be toggled with <CA-`>.
A colon is shown at the beginning of the command line.
:set setting will now display the setting's value.
The command line should work again on image documents.
Urlmodify doesn't add the websites you're leaving to your history anymore.
An experimental smoothscroll setting has been added. You can turn it on by using :set smoothscroll true. Be warned, this can make scrolling slower on some websites.
credits added to show off all the wonderful contributors we have.
help now displays relevant aliases and key bindings, and help [key sequence / alias] will take you to the relevant help.
hint will now open links in the current containerset tabopencontaineraware [false|true], which will make tabopen open new tabs in the current container<CA-Esc> bind to toggle ignore mode by popular demandAdd "tridactylrc" support
$XDG_CONFIG_DIR/tridactyl/tridactylrc~/.config/tridactyl/tridactylrc~/.tridactylrcsource [absolute path to file]. Bonus points if you can think of something sensible to do with source in an autocmd.sanitise tridactyllocal tridactylsync to the top of your rc file.Native messenger updated to 0.1.3
source)Readme updated
guisetBug fixes
guiset can now cope with multiple Firefox instances running simultaneously provided they are started with profiles explicitly via the command line.Deprecations
I of the new bindYou can now edit the Firefox GUI from Tridactyl with guiset. You must restart Firefox after using guiset to see the effects.
guiset gui none or guiset gui full.help guiset and following the links.You can now choose to bypass CSP on all sites with set csp clobber. If you change your mind, just unset csp, and restart your browser.
Tridactyl will no longer update while the browser is running in an attempt to fix issues where the add-on would be unresponsive after an update; instead, it will only update on browser launch.
about:addons. You'll need to restart the browser after clicking "Check for updates".set newtab news.bbc.co.uk etc. now looks much less janky
Minor new features
termite and terminator support with set editorcmd autoMinor bug fixes
whichfocusinput is now better at finding elements to focusgx0 and gx$Native messenger (for OSX/Linux only, for now)! On Linux/OSXRun :installnative to install, then:
<Ctrl-I> in a text field will open Vim, probably. Set it with set editorcmd but make sure that the command stays in the foreground till the programme is exited.:! [shell command] or :exclaim [shell command] will run the command and give you STDOUT/STDERR back in the command line./bin/sh should workcommand ! exclaim fish -c (but be aware that some shells require quotes around arguments given to -c)nativeopen will try to open a new tab or window using the native messenger. It is used in {,win,tab}open automatically when you try to open about:_ or file:_ URIs.Add hint -W [exstr] to execute exstr on hint's href
hint -W exclaim_quiet mpv works particularly well.Breaking change: change ignore mode binds to be symmetric and resolve Jupyter conflict
<S-Insert> to enter and leave it.I and <S-Esc> are unboundMore scrolling fixes
G/gg will now work on more sitesCompletion improvements
set historyresults to, e.g, 500.Mode indicator is now print friendly (#453)!
Fiddled with help theme
viewsource improved
gf by defaultBind help to F1
Changelog changelog:
Misc fixes
noiframeonnoiframeon for websites that are still broken by our iframe ("ServiceNow", for example: #279)set noiframeon [space separated URLs] to blacklist URLs:installnative once you are in.G/gg work on more pages (#382)set modeindicator false:h for :helpcomposite and ex-parser more sequentialD binding: close current tab and tabprevtab in inputmodeg;hint -W [exstr] to execute exstr on hint's hreftutor for that nowset newtab [url]set newtab about:blank now works thanks to a Mozilla bug fix!^ bind to <c-6> (matches vim)<C-u>) and binds of special keys (e.g. <F1>) and both together (e.g. <SA-Escape>)tutorviewconfig command to open the current configuration in Firefox's native JSON viewer (which Tridactyl doesn't work in)clipboard yanktitle|yankmdfullscreen command (not quite #376)viewsource commandset allowautofocus false to stop pages stealing focus on load (#266, #369)^ now switches to last used tab by defaultSpace now puts the URL from the selected completion into the command line (#224)hint -wp to open hint in a private window (#317)set theme dark (#230)tabopen (#342)set {related,tab}openpos next|lasttabclose # now worksset key.subkey.subsubkey value now worksbind and getautocmd [event] [filter] [ex command]DocStartautocmd DocStart mail.google.com mode ignorecommand [alias] [ex_command]. Many aliases have been ported from Pentadactyl. (#236)]] and [[ to allow use with foreign languagesset newtab foo.bar now changes all new tab pages (#235)tabopen now opens tabs to the right of the current tabxx binding (#262)hintorder setting. to repeat last actiongi and then Tab will cycle you between all input fields on a page;k for removing elements of a webpage such as dickbarsz{i,z,o} bindssanitize excmd for deleting browsing/Tridactyl datasearchsetkeyword [keyword] [url]: define your own search engines (#194)set newtab failing to set newtabq, qa, and quit synonymsunset failing to take effect without reloading pagehelp prefacehintchars and hintorderset searchengine bing (#60)set newtab [url] (#59)gh and gH and "homepages" setting (#96)ys now works on some older pageshint -c [selector]: add hints that match CSS selector;r;p to yank any element which contains text;# hint yank anchor modetabonly commandf/F — enter the "hint mode" to select a link to follow. F to open it in a background tab. (Note: hint characters should be typed in lowercase.)Shift + Insert — enter "ignore mode" to send all key presses to the web page you are on. Press Shift + Insert again to return to the highly productive "normal mode".H/L — go back/forward in the history.o/O — open a URL in this tab (O to pre-load current URL).t/T — open a URL in a new tab (T to pre-load current URL).gt/gT — go to the next/previous tab.d — close the current tab./ — open the find search box.A — bookmark the current pageb — bring up a list of open tabs in the current window.s — if you want to search for something that looks like a domain name or URL.gi — scroll to and focus the last-used input on the page.gr — open Firefox reader mode (note: Tridactyl will not work in this mode).:bind J tabprev. Type :help bind to see help on custom binds.yy — copy the current page URL to your clipboard.[[/]] — navigate forward/backward though paginated pages.ZZ — close all tabs and windows, but it will only "save" them if your about:preferences are set to "show your tabs and windows from last time".:help hint to see all the other useful hint modes (this is the f magic. :) ).:help <keybinding> to learn more about what a specific key binding does.guiset (e.g. guiset gui none and then restart) if you have the native messenger installed, or you can do it yourself by changing your userChrome. There is an example file available on our repository [2].:reloadall to reload all tabs to make life more bearable, or flip browser.sessionstore.restore_tabs_lazily to false in about:config.Tridactyl overrides your newtab page because it cannot insert its content script on the default about:newtab. Without the content script, our shortcuts won't work, even if you're just passing through the page. We're working with Firefox on improvements to the WebExtension APIs that will remove this restriction.
:set newtab [URL]:set newtab about:blankAlso, if you want to use a new tab page provided by another extension, make sure to install said extension after Tridactyl. Uninstalling and re-installing the other extension should work too.
You have more questions? Have a look at our FAQ.