Installation depends on operation system and ruby version. Installation includes the following applications:
- piggy
- directory_diff
- ftp_browser
Windows NT/2000/XP/Vista/7
Install Ruby 1.8.x (not Ruby 1.9) by using the Ruby Windows Installer.
You can now install piggy with the gem install command:
gem install Piggy
Rubygems will check if the required gems fxruby, rubyzip and exifr are installed on your system.
Ubuntu 11.4
Use the software center to install the following software:
- libruby
- libruby-extras
- libfox-1.6-dev
Now open a terminal and continue with gem installation of Piggy:
$ sudo gem install Piggy
Now manually add a new item to your menu. The command to start Piggy is:
/var/lib/gems/1.8/bin/piggyChange the icon in the menu, the piggy icon can be found within the gem directory:
/var/lib/gems/1.8/gems/Piggy-<version>/lib/icons/gallery.jpg
Mac OS X 10.5
Leopard already includes Ruby (as a prerequisite for Ruby on Rails)
FXRuby is availiable as Macport (aka darwinport): rb-fx-ruby.
Installation of Macports: Macports installation
Installation of FXRuby:
$ sudo port install rb-fx-ruby
Continue with gem installation of Piggy:
$ sudo gem install Piggy
Things that can go wrong
Admin rights fro gem installation
Gem installation might fail if you don't have the rights to write the gem directories. You'll need to become admin to get rid of these errors. (Note that you admin rights are not necessary to run Piggy once it is sucessfully installed.)
Internet connection settings
Remote gem installation may fail if you are sitting behind an internet proxy. In most cases, setting the HTTP_PROXY environment variable will help:
http_proxy=http://URL:PORT
For more information on this topic see GemRails.
If remote gem installation still doesn't work: Download the gem and install it with:
gem install Piggy-<version>.gem
X-Server
FXRuby requires a running X-Server on Linux and Mac OS X. There is nothing to do if you are using Linux with a desktop environment like KDE or Gnome. Mac users might have to start the server as described in ruby-talk.
Finding special folders on Windows
Piggy trys to find two special folders on your system:
- LOCALAPPDATA: This is where Piggy stores its config file
- MYPICTURES: Piggy opens on this directory