##About Mejiro
Mejiro is a forgetful single-file PHP web app for instant photo publishing. The app features expiration functionality. When enabled, it deletes photos older than a user-defined number of days -- hence the forgetful moniker.
##Features
- Simplicity The entire app consists of a single PHP file (plus a fav icon). Mejiro requires no installation, and it can be deployed on any web server with PHP5 and the GD library.
- Instant and easy photo publishing Upload photos, and Mejiro does the rest.
- Automatic thumbnail generation Mejiro automatically generates thumbnails for faster preview.
- Expiration functionality The app can automatically delete photos older than a specific number of days.
- Basic EXIF data The app extracts and displays basic EXIF info for each photo, including aperture, shutter speed, and ISO.
- IPTC keywords Mejiro parses IPTC metadata and displays keywords assigned to photos.
- Display geographical coordinates on OpenStreetMap For geotagged photos, you can view their exact locations on OpenStreetMap.
- Optional description You can add a description to each photo by creating an accompanying .php file. The app can also read and display descriptions from the photo's UserComment EXIF field.
##Requirements
- A web server with PHP5 and the GD library. (Tested with Apache and lighttpd)
- Git (optional)
##Installation and Usage
- Install the required packages. On Debian and Ubuntu, this can be done by running the following command as root:
apt-get install apache2 php5 php5-gd git
- In the terminal, switch to the root directory of the server (e.g., /var/www) and use the
git clone git clone https://github.com/dmpop/mejiro.git
command to fetch the latest source code. Alternatively, you can download the ZIP archive and extract it into the document root of the server. - Open the index.php file in a text editor and edit settings. This step is optional.
- Put photos into the photos directory (.jpg, jpeg, .JPG, and .JPEG files only).
- Point the browser to http://127.0.0.1/mejiro/ (replace 127.0.0.1 with the actual IP address or domain name of your server).
You can add descriptions to photos by creating accompanying .txt files. For example, to add a description to the F994362-R1-14-15.jpg photo, create the F994362-R1-14-15.txt file containing a short text. You can use HTML markup for formatting the text.
To enable the expiration feature, change the $expire = false; line in the index.php script to $expire = true; and specify the desired expiration period by modifying the $days variable.
##Demo
A Mejiro demo is available for your viewing pleasure.