Skip to content

Latest commit

 

History

History
82 lines (60 loc) · 7 KB

newtab.md

File metadata and controls

82 lines (60 loc) · 7 KB

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. There's a wiki too - feel free to add to it. You may find :apropos useful for finding relevant settings and commands.

  • You can view your current configuration with :viewconfig.

  • Breaking change: lots of searchurls have been removed because it seems that people were using them by accident more often than on purpose. If you miss one, see :help searchurls for how to add it back.

  • Tridactyl funding 👀: donate via GitHub sponsors here. Please consider starting a recurring donation to bovine3dom (me) if you find Tridactyl useful :) With inflation and churn, I am getting about 30% less than I was last year, so any help would be greatly appreciated!

  • All GitHub and Patreon donors get a nice little newsletter every now and then; for people who donate at least 10USD a month I briefly did a "tips & tricks" newsletter roughly once a month (see an example here) but now I'm open to other ideas for saying thanks. You can also donate via PayPal, but they charge fairly high fees and you won't get any newsletters. Donations currently aim to ensure that bovine3dom can work one day a week on Tridactyl at minimum wage. Previously the donations have funded an in-person developer retreat.

REPLACE_ME_WITH_THE_CHANGE_LOG_USING_SED

Highlighted features:

  • f/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 or Ctrl-Alt-Escape — enter "ignore mode" to send all key presses to the web page you are on. Press Shift + Insert or Ctrl-Alt-Escape 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.
  • <C-,> — "escape hatch": get to a place where you can use Tridactyl. Works anywhere in the browser.
  • / — open the find search box. Use ctrl + g/G to cycle through search results.
  • b — 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 your own commands with, e.g., :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".
  • <C-v> – send a single keystroke to the current website, bypassing bindings by entering ignore mode temporarily
  • <C-o> – run a single normal mode binding when in ignore mode
  • :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.
  • :colours [dark|quake|...] to change Tridactyl's theme (and the colour of this page)
  • :set keyboardlayoutforce true to pretend that your keyboard layout is always QWERTY - very useful for, e.g., Cyrillic keyboards

Important limitations due to WebExtensions

  • You can only navigate to most about: and file: pages if you have Tridactyl's native executable installed.
  • Firefox will not load Tridactyl on about:*, some file:* URIs, view-source:*, or data:*. On these pages Ctrl-Comma (that's <C-,> in Tridactyl-speak) is your escape hatch.
  • You can change the Firefox GUI with 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.
  • Tridactyl cannot capture key presses until web pages are loaded. You can use :reloadall to reload all tabs to make life more bearable, or flip browser.sessionstore.restore_tabs_lazily to false in about:config.

Why do I see this here?

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.

How can I get rid of it?

  • :set newtab [URL]
    • e.g, :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.

Alternatively, if you don't need Tridactyl to work on the new tab page, you can install the beta build without new tab page. You can get it here. To migrate your configuration across builds, see this comment or this issue.

FAQ

You have more questions? Have a look at our FAQ or search our issues.