====== Tridactyl ======


======Tridactyl Cheat Sheet======

Tridactyl is a Firefox WebExtension that brings Vim-like keybindings and commands to your browser, allowing for highly efficient keyboard-only navigation. Here's a cheat sheet covering some of the most common and useful commands:

=====Core Navigation & Scrolling=====

  * **gg:** Scroll to the top of the page
  * **G:** Scroll to the bottom of the page
  * **H:** Go back in history
  * **L:** Go forward in history
  * **r:** Reload page
  * **R:** Hard reload page (clears cache)
  * **f:** Enter "hint mode" to follow a link (type the displayed hint characters)
  * **F:** Enter "hint mode" to open a link in a background tab
  * **gF:** Repeatedly open links in hint mode until you hit `<Escape>`
  * **gi:** Focus the last-used input field on the page
  * **yy:** Copy the current page URL to the clipboard
  * **gu:** Go to the parent of the current URL
  * **gU:** Go to the root domain of the current URL
  * **zi / zo / zz:** Zoom in / zoom out / reset zoom

=====Tab Management=====

  * **d:** Close the current tab
  * **u:** Reopen the last closed tab (or window)
  * **gt:** Go to the next tab
  * **gT:** Go to the previous tab
  * **g^ / g0:** Go to the first tab
  * **g$:** Go to the last tab
  * **b:** List all open tabs (you can type to filter and navigate the list)
  * **ga:** Go to the tab playing audio

=====Opening New Pages/Tabs/Windows=====

  * **o / O:** Open a URL (or default search) in the current tab (O pre-loads current URL)
  * **t / T:** Open a URL (or default search) in a new tab (T pre-loads current URL)
  * **w / W:** Open a URL (or default search) in a new window (W pre-loads current URL)
  * **p / P:** Open clipboard content in the current/new tab
  * **s / S:** Perform an engine search in the current/new tab

=====Command Line (Ex-commands)=====

  * **:** Activate the command line
    * `:help [command]`: Get help on a specific command
    * `:set [setting] [value]`: Set a Tridactyl setting
    * `:bind [key_sequence] [ex_command]`: Bind a key sequence to an ex-command
    * `:tabopen [URL]`: Open a URL in a new tab
    * `:winopen [URL]`: Open a URL in a new window
    * `:mkt ~/filename.rc`: (Requires native Tridactyl installation) Save current configuration to a file.
    * `:viewconfig nmaps`: View current normal mode keybindings
    * `:tabdetach`: Detach the current tab into a new window

=====Visual Mode (v)=====

  * **v:** Enter visual mode
    * **h / l:** Expand/reduce selection by one character
    * **0 / $:** Expand selection to beginning/end of line
    * **e / b:** Expand selection to next/previous word
    * **j / k:** Expand selection to next/previous line
    * **=:** Expand progressively to whole page
    * **s / S:** Search for selection (current/new tab)
    * **y:** Yank (copy) selection to clipboard

=====Extended Hint Modes (prefixed with `;`)=====

  * **;i / ;I:** Open an image (current/new tab)
  * **;s / ;a:** Save/save-as the linked resource
  * **;S / ;A:** Save/save-as the selected image
  * **;p.**: Copy an element's text to the clipboard
  * **;P.**: Copy an element's title/alt text to the clipboard
  * **;y:** Copy an element's link URL to the clipboard
  * **;#:** Copy an element's anchor URL to the clipboard
  * **;r:** Read the element's text with text-to-speech
  * **;k:** Delete an element from the page
  * **;;:** Focus an element

=====Other Important Commands=====

  * **Shift + Insert:** Enable/disable "ignore mode" (pass all keys to the website)
  * **Ctrl + Alt + Escape:** Temporarily disable/enable Tridactyl (similar to ignore mode)
  * **.**: Repeat the last command
  * **Ctrl-i (in a text box):** Open the text in an external editor (requires native Tridactyl installation)
  * **[[ / ]]**: Navigate forward/backward through paginated pages (e.g., search results, multi-part articles)

=====Important Notes=====

  * **Case Sensitivity:** Hint characters (when using `f` or `F`) should be typed in lowercase.
  * **Firefox Keybinds:** Tridactyl cannot override some native Firefox key combinations (e.g., `Ctrl-T` for new tab, `Ctrl-W` to close tab).
  * **Configuration:** You can customize keybindings and settings extensively using the command line (e.g., `:bind`, `:set`).
  * **`:` (Command Mode):** Many actions are available as "ex-commands" by typing a colon first.
  * **`Ctrl-v`:** Bypass Tridactyl bindings for the next single keystroke (useful for passing a key directly to the website).

This cheat sheet provides a solid foundation for using Tridactyl. For a complete and up-to-date list of commands and their descriptions, consult the official Tridactyl documentation by typing `:help` in your browser with Tridactyl installed.


navigation:
  * f: show links with labels
  * F: show links with labels and open them in new tab
  * t: open new tab
  * o: open in current tab
  * s: open web search in current tab
  * S: open web search in new tab
  * b: list tabs
  * H: back history
  * L: forward history
  * P: open current clipboard url in new tab
  
search and select:
  * /: search word (C-g to jump from match to match)
  * v: search with labels
  * y: yank selected text

others:
  * zi: zoom in
  * zo: zoom out
  * zz: reset zoom