FooBarWidget / mikuru
watch download tarball
public
Forks0Right
Watchers5Right
Description: Mikuru static image gallery generator
Homepage:
Clone URL: git://github.com/FooBarWidget/mikuru.git 
Improve Readme.
Hongli Lai (Phusion) (author)
Tue Jun 16 11:24:07 -0700 2009
commit  695a1d1b0e858b6763c43076822ad655fd139178
tree    cf362d4c09d98b4d052506db7b734562ac302f9c
parent  81de87d203b007f026b362fa86d57b68c2b97332
mikuru /
name age
history
message
file .gitignore Tue Jun 17 04:46:52 -0700 2008 Add git ignore file. [Hongli Lai (Phusion)]
file License.txt Tue Jun 17 13:13:52 -0700 2008 It's 2008 now. [Hongli Lai (Phusion)]
file Rakefile Tue Jun 17 04:51:02 -0700 2008 Split gem specification to an external file, fo... [Hongli Lai (Phusion)]
file Readme.markdown Tue Jun 16 11:24:07 -0700 2009 Improve Readme. [Hongli Lai (Phusion)]
directory bin/ Tue Jun 17 02:38:21 -0700 2008 Refactor stuff. [Hongli Lai (Phusion)]
directory data/ Tue Jun 17 05:49:55 -0700 2008 Fix URL generation. [Hongli Lai (Phusion)]
directory lib/ Thu Jul 24 16:44:56 -0700 2008 Get rid of mutex. The bug seems to be solved in... [Hongli Lai (Phusion)]
file mikuru.gemspec Tue Jun 17 04:51:02 -0700 2008 Split gem specification to an external file, fo... [Hongli Lai (Phusion)]
Readme.markdown

Introduction

Mikuru is an extremely simple and easy to use static image gallery generator. Features:

  • Generates static HTML and image files.
  • Easy to use and easy to set up.
  • No dependencies on PHP, databases or other dynamic software.
  • The generated gallery has a simple, to the point, quick and easy to user interface.

I wrote after once having taken several hundred pictures and not feeling like setting up a full blown gallery system such as Gallery.

Installation

Run the following command:

gem install FooBarWidget-mikuru -s http://gems.github.com

Mikuru requires RMagick.

How does it work?

You put a bunch of pictures in a folder, run Mikuru, and it'll generate an 'index.html' as well as a set of thumbnails. There are no other generated files. Simply upload index.html, the thumbnails and the pictures to a web server, and you're ready to go.

Here’s an example usage session:

$ ls
DSCN001.JPG   DSCN002.JPG   DSCN003.JPG
DSCN004.JPG   DSCN005.JPG   DSCN006.JPG
$ mikuru
MKDIR      thumbnails
WRITE      thumbnails/DSCN001.JPG
WRITE      thumbnails/DSCN002.JPG
WRITE      thumbnails/DSCN003.JPG
WRITE      thumbnails/DSCN004.JPG
WRITE      thumbnails/DSCN005.JPG
WRITE      thumbnails/DSCN006.JPG
WRITE      index.html
$ scp -r * www.somehost.com:public_html/my_gallery/