This small project turns accessible(!) input fields on macOS into full vim buffers. It should behave and feel like native vim, because, under the hood I synchronize the text field with a real vim buffer.
You can use all modes (even commandline etc.) and all commands included in vim.
It is also possible to load a custom svimrc
file, which can contain
custom vim configurations, e.g. remappings (see the examples folder).
Additionally, you can edit the blacklist
file in the ~/.config/svim/
folder
to manually exclude applications from being handled by svim.
You will likely want to blacklist your terminal emulator and gvim, such that there
is no conflict.
Every time the vim mode changes, or a commandline update is issued, the script
svim.sh
in the folder ~/.config/svim/
is executed where you can handle
how you want to process this information. I have a small popup in my SketchyBar
which shows me the command line output on demand for example.
(!): Accessible means, that the input field needs to conform to the accessibility standards for text input fields, else there is nothing we can do.
You can install this using brew from my tap:
brew tap FelixKratz/formulae
brew install svim
and then you can start the brew service using:
brew services start svim
where you will be asked to grant accessibility permissions.
You can change the macOS selection color to anything you like with this command (which is my green):
defaults write NSGlobalDomain AppleHighlightColor -string "0.615686 0.823529 0.454902"
Please tell me if you encounter issues.
- Multikey remappings are not recognized (e.g. jk for esc)
- Some text fields break the accessibility api and this leads to bugs, be sure to blacklist all apps that are affected by this. Sometimes it helps to switch to a "raw" or "markdown" editing mode on websites, such that there is no interference. Generally, Safari seems to make most text fields available, while Firefox does not.
- Comments in svimrc break the config (#18)
Pull requests are welcome. If you improve the code for your own use, consider creating a pull request, such that all people (including me) can enjoy those improvements.
- I use the libvim library which is a compact and minimal c library for the vim core.
- Many prior projects tried to accomplish a similar vision by rebuilding the vim movements by hand, those have inspired me to create this project.