Mejiro

Pastebin for your photos

View the Project on GitHub dmpop/mejiro

About Mejiro

Mejiro is an easy-to-use PHP web app for instant photo publishing.

Mejiro

The Linux Photography book provides detailed information on using Mejiro. Get your copy at Google Play Store or Gumroad.

Features

Requirements

Installation and usage

  1. Install the required packages. On Debian and Ubuntu, this can be done by running the following command as root: apt install apache2 php php-gd php-imagick php-exif git
  2. In the terminal, switch to the root directory of the server (e.g., /var/www/html) and use the git clone https://github.com/dmpop/mejiro.git command as root to fetch the latest source code. Alternatively, you can download the ZIP archive and extract it into the document root of the server.
  3. Open the config.php file in a text editor and edit settings.
  4. Put photos into the photos directory (.jpg, jpeg, .JPG, and .JPEG as well as RAW files).
  5. Make the mejiro directory writable by the server using the chown www-data -R mejiro command as root.
  6. 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

  1. Install Podman and Buildah.
  2. Create a directory for your photos on the host machine.
  3. Switch to the mejiro directory and build an image using the ./buildah.sh command.
  4. 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).
  5. 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 (dmpop@linux.com)

License

Mejiro is released under the GNU General Public License version 3 license.