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.New features:
Rapid hinting bound to gF
. One of our most requested features.
Add DocLoad
autocmd which triggers after all HTML is downloaded (it fires on DOMContentLoaded).
All clipboard commands on Linux now support X-selection if you have the native messenger installed. Simply set yankto
and putfrom
to selection
.
Add private window indicator to bufferall
; add container icons to buffer{,all}
.
Add fillcmdline_tmp
, useful for temporary messages. A few commands now use this (e.g, yy
).
tabmove
bound to <<
and >>
à la Vimium.
Add mute
to mute tabs. Bound to <A-m>
by default.
Add <A-p>
bind for pin
.
Add {fixamo,guiset}_quiet
for non-interactive use; normal {fixamo,guiset}
now inform you that you must restart.
Add url2args
ex-command to retrieve search terms from Tridactyl search engines, for use with O
. help url2args
for more information.
Add autocmddelete
to delete an autocmd.
Add binds for yankmd and yanktitle to yt
and ym
irrespectively.
Our GitHub has a new troublehooting guide and issue template (#522).
Bug fixes:
Fix race condition in state.mode synchronization (#613).
set newtab about:blank
should work once again (#678).
Make tabprev
synchronous: it now works better in composite
commands (i.e, D
is less janky).
Fix guiset hoverlink *
in Firefox 61 (#763).
Make source
ignore visually empty lines.
Completions will now be properly deselected upon typing (#833).
guiset
now gives helpful errors if given the wrong arguments (#844).
History completion insertion with space no longer inserts an extra space (#838).
Ctrl-y actually scrolls up now
Arguments now ignored on history completions (-private, -c, -b
etc.).
Native messenger:
Windows install script now complains if you do not have the requisite PowerShell version.
Windows install script should now work if you have a non-ASCII username/directory
Windows install script no longer rage-quits if Python is not found.
installnative
again.Fix focus hijacking again (#768).
Fix scrolling on bugzilla.mozilla.org (#762).
Fix race condition in :sanitise (#724).
Make sure bind/unbind use the same binding format: previously, modifiers on binds were case-sensitive for some commands.
Container commands are now more case-insensitive.
Fix jumplist not being correctly restored on reloads (#680).
Update 1.13.1 release date in time for 1.13.2
Boring internal stuff
Thanks to all of our contributors for this release: Oliver Blanthorn, glacambre, Anton Vilhelm Ásgeirsson, Babil Golam Sarwar, Jeff King, Bzly, WorldCodeCentral, Colin Caine, Vladimir Macko, Bodo Graumann, Chris Pickard, Matt Friedman, Susexe, jcrowgey.
Extra special thanks go to Chris Pickard, Matt Friedman, Susexe, Vladimir Macko, WorldCodeCentral, all of whom were first time contributors!
And thanks to anyone who reported issues.
New features
bufferall
bound to B
by default shows you tabs in all windows.container{create,close,update,delete}
, viewcontainers
and tabopen -c [container name] URL
help containercreate
for more informationset hintnames numeric
for sequential numeric hints. Best used with set hintfiltermode vimperator-reflow
.guiset navbar none
removes the navbar totally. Not for the faint-of-heart: you could potentially get trapped if Tridactyl stops working.Bug fixes
nativeopen
now puts tabs in the same place that tabopen
wouldsantise tridactyllocal tridactylsync
now works in RC files<C-i>
editor will now always update the field you started in, not just the one you currently have focused.urlincrement
no longer throws errors if a link cannot be found.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=pandoc
native
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
~/.tridactylrc
source [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
guiset
Bug 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 auto
Minor bug fixes
which
focusinput
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
noiframeon
noiframeon
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 :help
composite
and ex-parser more sequentialD
binding: close current tab and tabprev
tab
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>
)tutor
viewconfig
command to open the current configuration in Firefox's native JSON viewer (which Tridactyl doesn't work in)clipboard yanktitle|yankmd
fullscreen
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|last
tabclose #
now worksset key.subkey.subsubkey value
now worksbind
and get
autocmd [event] [filter] [ex command]
DocStart
autocmd DocStart mail.google.com mode ignore
command [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 hintorder
set 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:blank
Also, 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.