== Welcome to Balder photo gallery

Made by Espen Antonsen.

Version 1.2.0rc1 for Rails3

Issues:
- carrierwave not saving to model, only to disk (testet on ubuntu)
- jpg files not being upload, no error written to log (testet on osx)

http://balderapp.com

== Features

* Stores photos to disk in folders or on S3 (can run from Heroku...yay)
* Create multiple thumbnails of custom sizes
* Read and writes EXIF/IPTC title, description and keywords
* Organize in albums (as events in iPhoto)
* Combine albums in collections (as albums in iPhoto)
* Upload multiple photos
* Tag photos. Can also tag albums (actually all photos in album is tagged)
* User management with roles and permissions
* Geo-location of albums & photos with Google Maps integration.

== License

Free for personal use. Contact me for commercial license.

== Requirements

Rails 3.0

Software
- ImageMagicK (required for Carrierwave resizing). Can also use ImageScience
Optional:
	- ExifTool (required for Mini_EfixTool)

Ruby Gems
- AuthLogic
- Mime-Types
- Carrierwave
Optional:
	- AWS/S3 (if saving to Amazon s3)
	- Mini_Exiftool (to read exif info to database. See photo.rb model)

== Installation

1. Clone the project from GitHub or Gitorious:
	GitHub: git clone git://github.com/espen/balder.git
2. Install required software listed above
3. 'bundle install' to install required gems.
4. Adjust the settings in balder.rb
5. Copy database file (not needed when hosting on Heroku):
	cp config/database.example.yml config/database.yml
6. Create database user and edit database file. (unless on Heroku or using SQLite3)
7. rake db:create
8. rake db:migrate
9. Start up the project with your preferred web-server

=== Optional: add photos directly to disk

The gallery has a web-based upload tool using Flash. Alternatively you can upload files directly by doing this:

Put photos in containing folders(albums) in the specified gallery folder.
Hierarchy of folders is not fully supported.

This format is recommended:

./ski weekend in hemsedal/snow.jpg
./ski weekend in hemsedal/afterski.jpg
./trip to iran/beautiful girls in tehran.jpg
./trip to iran/mosque in yazd.jpg
./trip to iran/powder snow in dizin.jpg

Every time you manually add photos to disk you must scan by visiting /photos/scan

In future releases the scan will be automated.

== Copyright and license info

This code is copyrighted by Espen Antonsen. The source code is available free under the GNU General Public License version 3 (GPLv3).

If the GPLv3 is not suitable for you please contact me for an alternative license for a fee.