VimFx can optionally be customized by a config file.
This is the boilerplate needed to set it up.
- config.js is you actual config file.
- frame.js is needed if you add custom commands that access web page content.
- The rest of the files are there to get config.js and frame.js up and running. You don’t need to touch them (but advanced users can for maximum customizability).
-
Download all files as a .zip and extract it. That should result in a directory called
VimFx-config--vimfx.org
containing seven files. RenameVimFx-config--vimfx.org
toVimFx-config@vimfx.org
. (Github don’t allow@
in their .zip names.) -
Find the
extensions
directory in your profile directory. -
Move the
VimFx-config@vimfx.org
directory into the extensions directory.
That’s it! To check if it works:
-
Restart Firefox.
-
Open the browser console. You should see the message “Hello, World! This is vimfx:” followed by an inspection of VimFx’s public API.
Note: Since Mozilla added extension signing things have gotten a bit more complicated.
Now check out the config file documentation to get started customizing!
If you’d like to put your config file somewhere else, you can! There are two ways to go:
-
Create a plain text file called
VimFx-config@vimfx.org
in the extensions directory (a proxy file). Put the absolute path to your config file directory inside it, such as/home/you/.vimfx/
orC:\users\you\vimfx\
. -
Use a symlink. For example:
ln -s /home/you/.vimfx/ /home/you/.mozilla/firefox/dgof8r37.default/extensions/VimFx-config@vimfx.org