Quantcast

How to install SVN plugin for Mac’s Finder?

Do you missed the TortoiseSVN plugin for Windows Explorer? I missed it terribly. I was living with RapidSVN for quite sometime. It is not that bad but I needed a bit more satisfaction than that. I was really wishing that I can get SVN integration right in the File Browser – The Finder. Eclipse Projects are well taken care of by Sublipse. What about the other projects that do not necessarily come under Eclipse – where I just monitor the codes, file hierarchy, et al and not really get involved with.

The solution came in with 2 free software – SVN Client and the SCPlugin.

Step 1 – Downloads

Before we start on How to install/use SVN plugin for Finder, let us download the following files

a) SVN Client – get this easy to install Package from Metissian. For the bravehearts, they can compile the source from Subversion.
b) SCPlugin

Step 2 – SVN Client Installation & Confirmation

a) Double click the SVNClient Installer and follow the steps to install it.
b) Add to PATH & Confirm SVNClient Install (follow steps below)

(i) Open Terminal (it is located under Applications > Utilities)
(ii) Type the following without quotes in a single line — “pico .bash_profile”
(iii) Type the following 2 lines –

PATH=”/usr/local/bin:/usr/local/subversion/bin:$PATH”
export PATH

(iv) Save this using Control + O in the Pico Window
(v) Restart your Terminal
(vi) Type “svn” without the quotes to confirm, it should says something like “Type ’svn help’ for Usage”
(vii) That’s it, SVNClient is now installed and functional on your system.

Step 3 – SCPlugin Installation

a) Double Click the SCPlugin Installer and follow the steps to install it.
b) Restart Finder. Well, you really cannot restart Finder, so either Restart your OS or Force Quite (Command + Option + Escape) Finder and Relaunch.

Step 4 – SCPlugin Setup

a) SCPlugin is installed under System Preferences – Screenshot
b) Enable Finder Integration and follow the steps below to set the path to the SVNClient – Screenshot

(i) Click “Open” and Press Command + Shift + G to invoke “Go to Folder” and enter the following line without the quotes – “/usr/local/bin/”
(ii) Select “SVN” and thus your path will look like – “/usr/local/bin/svn”
(iii) Close the System Preferences because you are done!

Now, right click on any folder to start “Subversion > Checkout”. Well, you can then sit back and enjoy.

Comments 41

  1. jimwoolum wrote:

    After installing the software per Step 1, I opened Terminal, then pasted:
    PATH=?/usr/local/bin:/usr/local/subversion/bin:$PATH?

    Then I pasted:
    export PATH
    (After the first paste, I had some funky looking characters that looked like “^”.) 

    Then I typed Control + O to save.

    Now whenever I launch Terminal I get this error:
    “-bash: pico: No such file or directory”

    Can anyone tell me how to correct this? 
    (And maybe tell me what the heck I did wrong.)

    Thanks very much for your help,
    Jim

    Posted 11 Aug 2006 at 9:41 pm
  2. Brajeshwar wrote:

    Well, then let us reset and redo the steps. In your terminal, type this –

    pico .bash_profile
    and delete the two lines that we added.
    Now Press Control + O to save it.

    It might be a good idea to restart Terminal and redo the steps. Remember to type them and the two lines are separeted by a return (I mean they are 2 lines). Save it and close Terminal.

    Posted 12 Aug 2006 at 10:33 am
  3. jimwoolum wrote:

    I launched Terminal and entered:
    pico .bash_profile

    Then Terminal says:
    -bash: pico: No such file or directory

    I think this is a bad sign. Could I have nuked the file? Maybe I need to locate a tutorial somewhere that tells you how to create the profile …

    Posted 17 Aug 2006 at 11:45 pm
  4. Brajeshwar wrote:

    Try – bash on Mac OS X

    Posted 18 Aug 2006 at 11:06 am
  5. jimwoolum wrote:

    Fixed … before I studied enough to figure it out, a couple of people at MacOSXHints recognized the problem and sent me a fix. The problem was that I copied and pasted from the web page to the Terminal, and the web page text has curly quotes that Unix choked on – it wanted ASCII double quote characters.

    Once I knew how to get around the “No such file or directory” problem by going directly to the bash profile ( /usr/bin/pico .bash_profile ), I was able to delete what I pasted and then type the line in correctly.

    Now it works! And I have my Terminal back. Whew.

    Posted 29 Aug 2006 at 9:30 pm
  6. Brajeshwar wrote:

    Cool, nice to know that you got it working.

    Posted 29 Aug 2006 at 9:33 pm
  7. Mark wrote:

    Does this not work with 10.4.8?

    Posted 11 Oct 2006 at 8:06 am
  8. Brajeshwar wrote:

    I am also on 10.4.8 and it does work for me.

    Posted 11 Oct 2006 at 11:51 am
  9. Chris Kelley wrote:

    When I installed the plugin, I went to open up the system preferences panel for it, and I got the following error message:

    You cannot open SCPlugin preferences pane on this computer. Contact the developer of this software for a newer version.

    Any Ideas?

    Posted 12 Oct 2006 at 6:31 am
  10. Chris Kelley wrote:

    I should also note that I’m on 10.4.8 / Macbook Pro

    Posted 12 Oct 2006 at 6:32 am
  11. Brajeshwar wrote:

    Oh! I am not sure then, I’m on a PPC and it works for me. Why not try and inform the developer of SCPlugin through his link?

    Posted 12 Oct 2006 at 11:56 am
  12. Marc wrote:

    Anyone know if this will this work using svn+ssh?

    Posted 20 Oct 2006 at 10:28 am
  13. Brajeshwar wrote:

    Hi Marc,

    I am not sure but if you mean https thingy then, it does not work so far.

    Posted 20 Oct 2006 at 7:00 pm
  14. Marc wrote:

    No, most SVN clients have the ability to tunnel svn through ssh. TortoiseSVN can do this out of the box just by using “svn+ssh://” in the URL for the repository. This allows for instance me to access my SVN at home while only having the ssh port open on my firewall.

    Posted 22 Oct 2006 at 4:17 am
  15. Brajeshwar wrote:

    Hi Marc,

    Well, that is cool then. I’ve never tried it before.

    Posted 22 Oct 2006 at 9:39 am
  16. Marc wrote:

    I just picked up a new Mac Book Pro to travel with. It looks like I’ll have to find something now, so I’ll give it a try.

    Posted 24 Oct 2006 at 7:54 pm
  17. Brajeshwar wrote:

    Marc, congrats on your New Mac Book Pro.

    Posted 24 Oct 2006 at 10:01 pm
  18. Nagra wrote:

    Ok, I’m the biggest Mac rookie, so maybye what I’m about to ask is trivial.

    When I donwload SCPlugin, the zip file gets decompressed and I’m left with a package called “SCFinderPlugin.plugin”. How do I install that???
    Double clicking doesn’t work:
    “There is no default application specified to open the document SCFinderPlugin.plugin”

    I tried to put the file in
    Library | Contextual Menu Items
    and
    System | Library | Contextual Menu Items
    but it doesn’t seem to work…

    Posted 02 Nov 2006 at 6:27 pm
  19. Tim wrote:

    http://scplugin.tigris.org/servlets/ProjectDocumentList

    Dropping the plugin file into the “Library | Contextual Menu Items” folder within your home folder works. You may have to create the “Contextual Menu Items” folder though. Also you will need to open “Force Quit” from the apple menu and restart the Finder.

    If you are on an intel mac then there is a new intel binary on the plugin; http://scplugin.tigris.org/servlets/ProjectDocumentList

    For a more stable and fully featured svn client I wither use the command line or svnX; http://www.lachoseinteractive.net/en/community/subversion/

    Posted 17 Nov 2006 at 1:06 pm
  20. Pierce wrote:

    What I want to do on my blog, is every few hours take the oldest post and move it to the
    front of the queue, all automatically. Anyone know if there is a plugin that can do this or
    a simple way to set up another plugin to do this (use my own feed perhaps)?
    Thanks.

    Posted 13 Dec 2006 at 1:58 am
  21. Sanna wrote:

    well, I made all fine so far until this:
    Now, right click on any folder to start “Subversion > Checkout”. Well, you can then sit back and enjoy.
    -> when I do this and add the url of one sourceforge project I, it asks me username and password and then it comes only a blank screen… nothing really happens.

    Posted 19 Dec 2006 at 3:33 am
  22. Brajeshwar wrote:

    Well, I have to wait for sometime most of the times and it does works for me. Of course, the first time sync show nothing as there are nothing to sync.

    Posted 23 Dec 2006 at 12:21 am
  23. Erik D wrote:

    You can restart Finder! Simply hold alt and right-click on the Finder icon in the dock; you’ll see a relaunch option. (Holding down alt changes a good few menus in case you never tried…)

    I like the subversion package from http://www.codingmonkeys.de/mbo/

    Posted 25 Apr 2007 at 8:14 pm
  24. ckatyal wrote:

    I installed SCPLugin .I already had svn client installed on my machine.
    I get the menu for Subversion -> checkout on right clicking the mouse.But whenever I check out, it gives me error about prop finds.I can checkout from command line successfully though.

    I also removed all the files from by using cd ~/.subversion/auth/svn.simple.

    I also never get the SCplugin in my System Preferences pane.

    I would appreciate if anybody has any insight into this.

    Posted 13 Aug 2007 at 8:26 am
  25. Jack Repenning wrote:

    I’m the Project Owner and release engineer for SCPlugin. We’ve just released a new version, 0.7, which has substantially more features, and substantially less hassle, than the one discussed here. Two things of particular importance:

    1. There is no long a Preferences Panel. Just run the installer, log out and in, and you’re in business.

    2. You probably no longer need a command-line client: we’ve added dialogs to collect your name and password during checkout. Once you’ve done that, they’re cached in the OS X Keychain, a very secure place, and you don’t need to enter them again.

    This is still a beta release, but it seems to be pretty solid. Feedback on version 0.7 has identified these bugs and notes that might interest you:

    1. If you access Subversion through an https:// URL, and if your server uses an improperly certified certificate, you’ll still need a command line client (sigh! missed one case!). Just do “svn ls https://…”; once to your server. You’ll be prompted about the improper certificate, and given the option to “p”ermanently accept it. After that, you won’t need the command line again.

    2. The 0.7 installer installs into /Library, so all users can use it. This requires administrator user name and password. We’re debating whether that was the right choice right now, over in users@scplugin.tigris.org, we may switch to private installation (which would not require authentication). If you have an opinion, drop on by that list (email users-subscribe@scplugin.tigris.org) and let us know!

    3. You may sometimes find that the special icon “badging” doesn’t work. If so, put the window into icon mode and issue the “refresh icons” command in the submenu, and things should be good again.

    Posted 29 Aug 2007 at 1:55 am
  26. Brajeshwar wrote:

    Hey Jack, this is an awesome news. I’ll be checking it out.

    Posted 29 Aug 2007 at 1:52 pm
  27. Annie wrote:

    I actually get this same issue. I pasted from previous post. Any ideas??

    I installed SCPLugin .I already had svn client installed on my machine.
    I get the menu for Subversion -> checkout on right clicking the mouse.But whenever I check out, it gives me error about prop finds.I can checkout from command line successfully though.

    I also removed all the files from by using cd ~/.subversion/auth/svn.simple.

    I also never get the SCplugin in my System Preferences pane.

    I would appreciate if anybody has any insight into this.

    Posted 10 Sep 2007 at 8:14 pm
  28. Jack Repenning wrote:

    Annie – can you provide the rest of the error message? PROPFIND isn’t actually an error (even though it is shown all in caps!), it’s just one of the operations in the WebDAV protocol used by Subversion — one of the more common ones, so I can’t even guess where things are breaking down for you based on that one word!

    Posted 27 Sep 2007 at 4:31 am
  29. Annie wrote:

    When I tried to svn update it gives:

    Subversion Error
    PROPFIND request failed on ‘/svn’
    PROPFIND of ‘/svn’: authorization failed (http://………..)

    Posted 04 Oct 2007 at 6:59 pm
  30. Jack Repenning wrote:

    OK, “authorization failed” means something pretty specific. Good. Well, it means one of several specific things; not so good. But anyway, it’s progress.

    Quick review:

    1. If you’re upgrading from some 1.3 or earlier version of Subversion to a 1.4 or later version (and SCPlugin is 1.4), or if you ever did that in the past and didn’t know about or do what I’m about to tell you, then you should clean out all the files in ~/.subversion/auth/svn.simple/* (as ckatyal mentions). Older Subversions stored your password here; newer ones store it in the OS X keychain (visible with the Keychain Access tool), a vastly more secure place. The old ones in svn.simple/ can still be used, but at the very least this cleanup will make the present debugging conversation simpler.

    2. SCPlugin presently only handles the passwords for Subversion itself. If you’re using “svn+ssh”, you’ll have to arrange matters so that no password is required for the SSH part. (We know that any “PROPFIND … authorization failed” message is not this, but I mention it just for completeness.)

    3. SCPlugin presently only accepts passwords at the check out interface. It’s possible to configure a Subversion repository so that checkouts do not require a password, and in that case SCPlugin’s lovely username / password fields turn out to be utterly useless (so sad!). We clearly need to fix this, but that’s the state of SCPlugin at the moment. If your repository is, indeed, configured to allow anonymous check outs but require authorization for check in, SCPlugin alone can’t handle the task. You will need, one time, to do a check in (or other operation that requires credentials) using a command line copy of Subversion (version 1.4 or greater!). In case you haven’t got one handy, we’ve helpfully included one for you in your SCPlugin installation, at the quite unhelpfully long path:

     /Library/Contextual\ Menu\ Items/SCFinderPlugin.plugin/Contents/Resources/SCPluginUIDaemon.app/Contents/bin/svn

    (Sorry about the way the line gets broken, there.)

    If you can use that copy of “svn”, and make it ask you for a password, then it will stow it into the Keychain, and SCPlugin will be able to use it.

    Posted 04 Oct 2007 at 10:43 pm
  31. Mikhail Gurevich wrote:

    Anyone knows if and if yes when svn+ssh feature will be added? SCPlugin is a beautiful solution to the command line on the mac and I hate to see it go to waste.

    Posted 06 Oct 2007 at 8:56 am
  32. Jack Repenning wrote:

    We don’t have that work scheduled at the moment, unfortunately — this is an open-source project, and a small one at that; “scheduled” basically means “someone’s working on it.” We’re always open to new community members with an interest in implementing cool stuff like this!

    Posted 08 Oct 2007 at 10:19 pm
  33. Michael wrote:

    I´ve tried the SCplugin and the subversion-client. basicly following the guide at the top of the page. I maneged to gain acces to the server I´m supposed to be linked up, but its a read-only connection. Is there any way I can get able to submit my work to the servers folder? Im kind of a newbee – go easy on me :-)

    - Michael

    Posted 13 Oct 2007 at 1:37 pm
  34. Mikhail wrote:

    To those that need svn+ssh access and are running an Intel powered Mac you can install Tortoise SVN on Windows with Parallels. To get file sharing working check out the post by e7sharp9 at http://forum.parallels.com/archive/index.php/t-142.html

    Good luck.

    Posted 14 Oct 2007 at 10:21 pm
  35. Jack Repenning wrote:

    Michael: what do you mean “it’s a read-only connection”? What do you see when you try to “commit”?

    There are a couple things that might be what you mean. One would be if whoever set up your repository intentionally set it up so that you can only read, not write. That sort of configuration is possible, so you might want to make sure you’re actually granted the necessary permissions.

    The other thing is that some repositories are set up so that anyone can read them, but you have to log in to make changes. Despite the fact that this makes a fair amount of sense, I have to admit that we on the SCPlugin project just completely forgot about the possibility in the current release. If you have such a configuration, you will have to log in to the Subversion server once from the command line. When you do that, Subversion will store your credentials in the OS X Keychain, and then SCPlugin will be able to use them, too.

    Here’s how to do that.

    First, check out some files from the server, using SCPlugin. Sounds like you’ve already done that.

    Next, open Terminal (it’s in /Applications/Utilities).

    OK, this next part’s kind of ugly, sorry about that. In the Terminal window, type
    PATH=”/Library/Contextual Menu Items/SCFinderPlugin.plugin/Contents/Resources/SCPluginUIDaemon.app/Contents/bin:$PATH” 
    That all has to go on one line; I know it’s been broken into two or more lines, to display in your browser but pull it all up onto one, and be sure to leave the spaces in “Contextual Menu Items”.

    Now, type “cd XXX“, where XXX is the directory where you checked out those files.

    Now, type “svn update” (you may see some newer files come over, or you may see nothing at all if there aren’t any new files, but you should not see an error message).

    Now, make some change to some versioned file (if you haven’t already), and type “svn commit”.

    What should happen is:
    1. an editor will appear, asking for your commit comments, describing this change you’re committing. Type in whatever’s appropriate. Save the result, and exit the editor.

    2. the commit should begin, and you should be asked to provide your password. Do so.

    3. the commit should complete

    4. and now, you should be able to use SCPlugin for all operaitons.

    Posted 16 Oct 2007 at 1:01 pm
  36. Michael wrote:

    When I try “svn update” in the terminal I get an error message:

    svn: Can’t convert string from native encoding to ‘UTF-8′:
    svn: Gruppem?\195?\184der

    I´ve tried to type the command:

    pico .bash_profile

    but i get the error:

    -bash: pico: command not found

    Can anybody help me?

    - Michael

    Posted 17 Oct 2007 at 1:23 pm
  37. Jack Repenning wrote:

    Michael -

    That’s interesting. Do you have some other raw text editor you’re familiar with, vi or emacs or something like that? You can use any text editor on the .bash_profile file.

    As to why you have no pico …

    Try this: type “/usr/bin/pico .bash_profile”, see if that works.

    If not, do you have a file named /Library/Receipts/BSD.pkg? (Type “file /Library/Receipts/BSD.pkg”, does it say ”/Library/Receipts/BSD.pkg: directory”?) If not: you have not installed the BSD package (which I guess is optional).

    Try this instead:
    open -a /Applications/TextEdit.app .bash_profile

    Posted 18 Oct 2007 at 1:06 am
  38. Jason Belec wrote:

    Well I thought this was cool some time ago. So I thought I’d try it under Leopard. I downloaded the beta plugin. So far so good!

    Might I suggest updating the instructions to represent the current version improvements like not in System Preferences. I had to read quite a bit more to catch this, nice that at least it was present.

    Again – very cool. One less thing to open!!!!

    Posted 13 Dec 2007 at 5:48 am
  39. Mike Lynch wrote:

    Thanks! That information on the second copy of svn being inside the plug in was priceless!

    Posted 18 Jun 2008 at 4:16 pm
  40. babu prakash wrote:

    I able to see all option under more on right click, as soon as i select checkout , i am getting error “/.subversion/config:13:option expected”. please help.

    Posted 16 Jul 2008 at 12:45 pm
  41. Jack Repenning wrote:

    The message “~/.subversion/config:13:option expected” suggests that there is an error in your Subversion configuration file. Check that file, at line 13, to see what might be wrong.

    Posted 16 Jul 2008 at 5:47 pm

Trackbacks & Pingbacks 4

  1. From   How To: install SVN plugin for Finder by Apple Gazette on 19 Oct 2006 at 11:02 pm

    [...] Brajeshwar sent us a useful How To for those of you looking for a way to get SVN integration right in Finder. This is a good tutorial, including screenshots to help you along, so if you’re wanting to get “under the hood” of your Mac and intergrate SVN into Finder, now’s your chance: Do you missed the TortoiseSVN plugin for Windows Explorer? I missed it terribly. I was living with RapidSVN for quite sometime. It is not that bad but I needed a bit more satisfaction than that. I was really wishing that I can get SVN integration right in the File Browser ? The Finder. Eclipse Projects are well taken care of by Sublipse. What about the other projects that do not necessarily come under Eclipse ? where I just monitor the codes, file hierarchy, et al and not really get involved with. [...]

  2. From Le blog » Archive du blog » Subversion et Mac, c’est pas le pied on 01 Nov 2006 at 9:12 pm

    [...] Supposons que, par exemple, j’aie envie de filer un coup de main au type qui d?veloppe Pimki. Comme mon ordinateur principal est un Mac, je me dis logiquement que je vais installer Subversion pour Mac et un client sympa. Donc, je vais chez The tao of Mac, ? la page Subversion. L?, je me rends compte avec stupeur que ?a n’est pas aussi simple que sous Windows, o? TortoiseSVN et Subclipse s’’installent sans probl?me et fonctionnent de m?me. Je choisis donc un Subversion 1.4 chez Martin Ott apr?s quoi il me faut, de mani?re ind?pendante, t?l?charger SCPlugin qui n’est pas disponible en version compil?e sur le site de tigris.org. Du coup, encore un google de plus pour constater que certains fournissent une version compil?e, comme par exemple le funkablog. Et encore, apr?s, il faut le configurer Pfff … tout ?a pour faire en mieux ce que propose Jason. Bon, l’av antage du Mac, c’est quand m?me par exemple d’avoir des scripts comme GrowlSVNNotifier. [...]

  3. From marcus’ tagebuch » Blog Archive » Subversion und MAC on 10 Dec 2007 at 7:29 pm

    [...] verspricht eine Finder-Integration für Subversion. Eine Installationsanleitung findet sich unter: http://www.odetoapple.com/2006/svn-plugin-for-finder/. Für einen ersten Eindruck findet man hier einen Screenshot – sieht doch schon mal ganz nett aus [...]

  4. From lab.joelGillman.com › SVN For Beginners, no really. on 09 Feb 2009 at 3:43 am

    [...] install done. There are several graphical interfaces for SVN but I’ve found that none of them can really compare to the command line interface [...]

Post a Comment

Your email is never published nor shared. Required fields are marked *