# VTR [Vim Tmux Runner] A simple, vimscript only, command runner for sending commands from vim to tmux. ## Usage VTR provides a handful of commands for managing and interacting with [tmux][], the terminal multiplexer. The main command is: ``` vim VtrSendCommandToRunner ``` This command will prompt for a command to run, then send it to the runner pane for execution. If one doesn't currently exist, a new runner pane will be created. Subsequent calls to `VtrSendCommandToRunner` will reuse the provided command. VTR provides configuration options that allow for control over the size and location of the VTR runner pane. In addition, VTR provides commands to resize, reorient, and even detach the runner pane making the interaction as painless as possible. For a complete summary of the available commands and configuration options in VTR, check [the included doc file][]. ## Installation The easiest way to install VTR is to add the git repo as a bundle, then use [Pathogen][], [Vundle][] or similar plugin management option to add it to Vim's runtime path. ``` shell cd ~/.vim mkdir bundles # only cd bundles git clone https://github.com/christoomey/vim-tmux-runner.git ``` ## Development Status This plugin is currently very much an alpha. Although the major features are implemented, the API is subject to change any time up until v1.0. ## Inspiration This plugin is heavily inspired by the functionality in the [Vimux][] plugin. This plugin aims to implement a similar feature set while not requiring Vim with ruby requirement. In addition a few new commands not found in Vimux have been added to provide additional control over the tmux runner pane. [the included doc file]: https://github.com/christoomey/vim-tmux-runner/blob/master/doc/vim-tmux-runner.txt [Pathogen]: https://github.com/tpope/vim-pathogen [Vundle]: https://github.com/gmarik/vundle [tmux]: http://tmux.sourceforge.net/ [Vimux]: https://github.com/benmills/vimux