Stars: 127
Forks: 14
Pull Requests: 16
Issues: 17
Watchers: 12
Last Updated: 2022-05-23 10:01:49
Pastebin for your photos
License: GNU General Public License v3.0
Languages: PHP, Shell, CSS
http://dmpop.github.io/mejiro/
About Mejiro
Mejiro is an easy-to-use PHP web app for instant photo publishing.
The Linux Photography book provides detailed information on using Mejiro. Get your copy at Google Play Store or Gumroad.
Features
- Simplicity Mejiro requires no installation, and it can be deployed on any web server with PHP.
- Instant and easy photo publishing Upload photos, and Mejiro does the rest.
- Responsive design Mejiro works well on mobile devices.
- Pagination Mejiro automatically splits photo collection into pages. You can specify the desired number of photos per page.
- Basic EXIF data The app extracts and displays basic EXIF info for each photo, including aperture, shutter speed, and ISO.
- Display geographical coordinates on OpenStreetMap or Google Maps For geotagged photos, you can view their exact locations on OpenStreetMap.
- Optional description text You can add a description to each photo by creating an accompanying .txt file. The app can also read and display descriptions from the photo's UserComment EXIF field.
- Automatic language detection Mejiro automatically detects the browser language and picks the description text file with the appropriate language prefix.
- Link to RAW For each photo in the JPEG format, you can upload the accompanying RAW file, and Mejiro automatically adds a link to it. This feature can be disabled.
- Support for subfolders Photos inside the default photo directory can be organized into subfolders.
- Access keys The application supports access keys for common actions.
Requirements
- A web server with PHP7 or higher (tested with Apache and lighttpd)
- PHP libraries: GD, EXIF
- Git (optional)
Installation and usage
- On Debian, Ubuntu, and Raspberry Pi, install Mejiro by running the following command as root:
curl -sSL https://raw.githubusercontent.com/dmpop/mejiro/main/install.sh | bash
. On other distributions, install the required packages and clone the project's Git repository using the command git clone https://github.com/dmpop/mejiro.git
as root. Alternatively, you can download the ZIP archive and extract it into the document root of the server.
- Open the config.php file in a text editor and edit settings.
- Put photos into the photos directory (.jpg, .jpeg, .JPG, and .JPEG as well as RAW files).
- Make the mejiro directory writable by the server by running
chown www-data -R mejiro
as root.
- 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 add description files in other languages, use the appropriate language prefix as follows: de-F994362-R1-14-15.txt (for German), ja-F994362-R1-14-15.txt (for Japanese), etc.
Run Mejiro in a container
- Install Podman and Buildah.
- Create a directory for your photos on the host machine.
- Switch to the mejiro directory and build an image using the
./buildah.sh
command.
- Run a container on port 8000:
podman run -d --rm -p 8000:8000 -v /path/to/photos:/usr/src/mejiro/photos:rw mejiro
(replace /path/to/photos with the actual path to the directory on the host containing photos).
- Point the browser to http://127.0.0.1:8000 (replace 127.0.0.1 with the actual IP address or domain name of the machine running the container).
Author
Dmitri Popov ([email protected])
License
Mejiro is released under the GNU General Public License version 3 license.