Subversion Scripts for Mac OS X Finder

~ created by Adam Byrtek ~

Collection of scripts for Finder to make the most frequent operations on Subversion repositories easier. Now you don't have to switch from Finder to another application (either Terminal or some heavy-weight GUI client) to handle common repository tasks.

#1 Watch the Screencast

Watch the screencast to see how to install and use the scripts, it's only 5 minutes long and demonstrates most of the features.

#2 Download

You can download the stable version or use a development code from the Subversion repository of the project

#3 Reviews

Until I found these scripts, I continued to do all my svn'ing via the Terminal. I have tried many svn utilities that purport to make svn easy to use via some sort of GUI and I haven't liked any of them. I discovered these scripts a couple of weeks ago and they make svn a joy (rather than a bit of a pain) to use. Gary L. Gray, MacUpdate review

#4 Installation

Command-line Subversion client is still required, and has to be installed from one of the following sources.

The scripts should be installed in the Script Menu. The following simple steps are also presented in the installation and usage screencast.

  1. Script Menu should be active, if it's not:
  2. Unzip the SVN Scripts for Finder.
  3. Open the Script Menu when Finder is active and select Open Finder Scripts Folder.
  4. Copy all SVN Scripts to the Finder scripts folder.
  5. SVN Scripts should be visible in the Script Menu when Finder is active.

#5 Quicksilver and Keyboard Shortcuts

Quicksilver automatically indexes all scripts in ~/Library/Scripts/ directory. This means that without any extra configuration you can invoke Subversion Scripts on the current Finder selection. Just activate Quicksilver, type svup to find SVN Update script with intelligent search, and confirm to run default Run action.


If you would like to run the scripts even easier, you can setup keyboard shortcuts with Quicksilver triggers. Select Triggers in Quicksilver configuration and in Custom Triggers use the plus icon to setup hotkeys for the scripts.

Quicksilver triggers

#6 Feedback

Questions about the project can be posted on the mailing list. You can either subscribe to the list or post directly to the address, without subscribing.

Feel free to use the issue tracker to report bugs and feature requests. However please note that the main assumption of the project is that it will stay AppleScript only, so many potentially useful but more complex features are out of its scope.

If you like the project, please spread the word. You can let others know that you use it at iusethis or write a review on MacUpdate or VersionTracker.

Please be aware of the fact that this collection of lightweight scripts is meant to handle the most frequent use cases well, and serves a different purpose than more complex standalone Subversion tools. Use the right tool for the job.

#7 Known Issues

Finder is blocked until the running script ends, so you should take this into account when commiting or updating large amounts of data — all other operations work on local copy, so should finish fast. This issue might be addressed in the future release.

#8 License

This software is licensed under the CC-GNU GPL.

#9 Hosting Logo

Hosted at SourceForge, you can visit the project page at SourceForge.