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.fixamo
added: you can now use Tridactyl on addons.mozilla.org. Requires a restart
.
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 pathPotentially 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
now uses String.prototype.search
for matching, so you can use regular expressions such as /www\.amazon\.co.*/
Add internal functions for editing user.js
- we'll probably add a nice interface to this some day.
Add restart
command to restart Firefox.
Add new themes
shydactyl
and greenmat
, covering both ends of the design spectrum.Make themes apply to {newtab, mode indicator, tutor}
Add new internal structure for themes - check out contributing.md on the repository if you want to add your own
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 curent 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.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. :) ).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
You have more questions? Have a look at our FAQ.