photomix/README
Espen Antonsen d1ec020ab1 license
2009-07-29 17:52:55 +02:00

78 lines
2.3 KiB
Plaintext

== Welcome to Balder photo gallery
Made by Espen Antonsen.
http://balderapp.com
== Features
* Stores photos to disk in folders
* 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.
== Todo
* Theme support?
* Multiple galleries?
* Support for ImageMagick in addition to FreeImage?
== Requirements
Rails 2.3
Software
- FreeImage (required for Image_Science)
- ExifTool (required for Mini_EfixTool)
Ruby Gems
- AuthLogic
- Mime-Types
- Image_Science
- RubyInline (required for Image_Science)
- Mini_ExifTool
== Installation
1. Clone the project from GitHub or Gitorious:
GitHub: git clone git://github.com/espen/balder.git
Gitorious: git clone git://gitorious.org/gallery-without-a-name/gallery-without-a-name.git
2. install required software listed above
3. Copy settings file:
cp gallery/config/database.example.yml gallery/config/database.yml
cp gallery/config/settings.example.yml gallery/config/settings.yml
4. Create databsae user and edit settings files.
5. rake db:create
6. rake db:migrate
7. 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. 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 Eclipse Public License.
If the EPL is not suitable for you please contact me for an alternative license for a fee.