# rsub ## Description Rsub is an implementation of TextMate 2's '[rmate](https://github.com/textmate/rmate)' feature for Sublime Text 2, allowing files to be edited on a remote server using SSH port forwarding / tunnelling. Included in this repository are two implementations of the 'rmate' command, the original written in Ruby, and another version written using bash scripting. You will need to choose and copy one of these up to your server, usually with scp, sftp, or plain FTP. See the README file inside rmate-bash for more detail. ## Installation You can install this plugin using sublime package control. It will keep all your plugins up to date. http://wbond.net/sublime_packages/package_control ------------------------- OR You can also clone this repository into the Sublime Text 2 'Packages' directory, but you will have to update it manually. On Mac OS X, this is located at `~/Library/Application Support/Sublime Text 2/Packages`. Run the following commands in Terminal, then restart Sublime Text 2: cd ~/Library/Application\ Support/Sublime\ Text\ 2/Packages git clone git://github.com/henrikpersson/rsub.git rsub ## SSH tunneling Due to security reasons, rsub is only listening for local connections. Simply put this in your ~/.ssh/config to enable remote forwarding for your server(s): Host example.com RemoteForward 52698 127.0.0.1:52698 ## Usage Once you have `rmate` installed on your remote server (installation instructions can be found [here](https://github.com/textmate/rmate)), `rsub` installed on your local machine and an ssh tunnel open, execute the following command on your __remote server__ to edit files in SublimeText: rmate More information on command line options can be found in the [rmate repository](https://github.com/textmate/rmate).