philc/textmatevim is tracked by TopGit as an open-source project, with 177 stars on GitHub, written primarily in Ruby. The beauty of TextMate meets the power of Vim.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
TextMateVim - The beauty of TextMate meets the power of Vim
TextMateVim is a plugin for TextMate. It lets you define keystrokes to move about and edit your text files with ease, in the spirit of the Vim command-line editor. If a grizzled Vim hacker and a TextMate-using hipster had children, this is the editor their kids would use.
If you've never used Vim before but you've heard that it's a way to type less to get things done, then this is a great chance to try out the elegant editing model that Vim uses while still being able to leverage OSX's normal text-editing shorcuts.
Installation instructions
You can install the latest release of this plugin by downloading and double-clicking it.
Alternatively, you can install it from source:
Clone this git repo
run rake build from within the git repo (you'll need the XCode Developer tools install for this)
Copy or symlink build/Debug/TextMateVim.bundle into ~/Library/Application\ Support/TextMate/PlugIns/
Basic Vim usage
There are three modes: insert, command, and visual. In insert mode, you can type text as you normally would. Hit <esc> to enter command mode (your cursor will change appearance). In command mode, you can use the keybindings described below to quickly move about the document with very few keystrokes. Type "i" to enter insert mode again.
In visual mode, you can use the command mode shortcuts to select text.
Keyboard bindings
Modifier keys are specified as <C-x>, <M-x>, <A-x> for CTRL+x, META+x, and ALT+x
respectively. You can customize all of these.
Switching modes
Esc enter Command Mode.
i enter Insert mode
v enter Visual mode. While in Visual mode, you can select text using the various movement keys and cut/copy it.
Movement
h move backward
l move forward
j move down
k move up
b move backward by one word
w move forward by one word
0 move to the beginning of the line
$ move to the end of the line
gg move to the beginning of the document
G move to the end of the document
<C-d> scroll a half page down
<C-u> scroll a half page up
Cutting, copying and pasting
x cut forward
dd cut the current line
D cut to the end of the line
dw cut the next whole word ("d" works with any of the movement modifiers,
e.g. "d$" cuts to the end of the current line)
yy copy line ("y" works with any of the movements modifiers,
e.g. "y0" copies to the beginning of the line)
Tabs
J previous_tab
K next_tab
Other
u undo
TextMateVim supports command repetition so, for example, typing "5j" will move the cursor down by 5 lines.
Create your own key mappings
You can define your own custom keybindings by creating a .textmatevimrc file in your home directory. It's a Ruby file which looks like this:
# In command mode, map "n" to be "move down":
mode(:command) do
map "n", "move_down"
end
See default_config.rb for lots of hints and examples. Note that shifts are automatically detected: <C-F> is understood to be Ctrl+Shift+f.
Tips
Prefer using "u" in command mode instead of CMD+Z to undo your edits. This is because when editing in command mode, TextMateVim saves the cursor position prior to the edit and will restore it when you use "u". TextMate's default undo system does not.
Contributing
Your contributions are welcome.
If there is an inconsistency with Vim that troubles you, feel free to file a bug. Before making deep changes to TextMateVim to emulate some behavior of Vim, file a bug and discuss the proposal on the issue tracker.
When you're done hacking, send a pull request on Github. Feel free to include a change to the credits with your patch.
Read DEVELOPERS.markdown for more information about hacking and debugging TextMateVim. There is a list of some bigger projects on the wiki.
Release notes
0.2 (April 2, 2011)
TextMateVim now checks automatically for new versions.
Added support for systems running Ruby 1.9.
Added y0 and y$ (copy to the beginning or end of line).
Tab switching (shift+J and shift+K) now works reliably.
Bugfixes.
0.1 (March 24, 2011)
Initial release.
License
Copyright (c) 2011 Phil Crosby. Licensed under the MIT license.
Credits
Phil Crosby (twitter @philcrosby)
Kevin Fitzpatrick (who wrote VimMate, which inspired TextMateVim).
The most recent commit recorded on philc/textmatevim was 15.6 years ago, based on the GitHub push timestamp. The repository has 9 forks — one of the better signals of community interest.
How many stars does philc/textmatevim have?
philc/textmatevim has 177 GitHub stars — refresh the page for the live number, or check github.com/philc/textmatevim. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is philc/textmatevim open source?
TopGit's metadata for philc/textmatevim does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What is philc/textmatevim?
philc/textmatevim (philc/textmatevim) is a Ruby project on GitHub. From the project's own README: The beauty of TextMate meets the power of Vim.
What language is philc/textmatevim written in?
philc/textmatevim is written primarily in Ruby. GitHub's language field is based on the largest share of bytes in the default branch.
Where do I read more about philc/textmatevim?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/philc/textmatevim is the definitive source.
Read full README in the tab above.
Want a second opinion on textmatevim?
Ask an AI that can read this page — one click and you get its take on textmatevim.