Skip to content

Commit

Permalink
Update index.md
Browse files Browse the repository at this point in the history
  • Loading branch information
dmpop committed Apr 13, 2023
1 parent 6e8d509 commit b02de50
Showing 1 changed file with 22 additions and 16 deletions.
38 changes: 22 additions & 16 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@

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

<img src="https://raw.githubusercontent.com/dmpop/mejiro/main/mejiro.png" alt="Mejiro">
<img src="mejiro.png" alt="Mejiro">

The [Linux Photography](https://gumroad.com/l/linux-photography) book provides detailed information on using Mejiro. Get your copy at [Google Play Store](https://play.google.com/store/books/details/Dmitri_Popov_Linux_Photography?id=cO70CwAAQBAJ) or [Gumroad](https://gumroad.com/l/linux-photography).
The [Mejiro for photographers](https://dmpop.gumroad.com/l/mejiro-for-photographers) book provides detailed information on installing and using Mejiro. Get your copy at [Gumroad](https://dmpop.gumroad.com/l/mejiro-for-photographers).

<img src="https://i.imgur.com/qP9Z9mQ.jpg" title="Linux Photography book" width="200"/>
<img src="https://cameracode.coffee/uploads/mejiro-for-photographers.png" title="Mejiro for photographers" width="300"/>

## Features

Expand All @@ -15,30 +15,31 @@ The [Linux Photography](https://gumroad.com/l/linux-photography) book provides d
- **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.
- **Geo URI links** For geotagged photos, Mejiro displays geo URI links you can use to see the exact locations where the photos were taken in the default map application.
- **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.
- **Password protection** Mejiro allows you to protect the published contents with a password. The application supports multiple passwords, so you can grant and revoke temporary access.
- **Support for subfolders** Photos inside the default photo directory can be organized into subfolders.
- **Statistics** View basic statistics: camera models and the total number of photos and RAW files.
- **Access keys** The application supports access keys for common actions.
- **Internationalization** support. The application automatically detects and picks the right language. Localizing Mejiro is a matter of translating a handful of text strings in a dedicated _.ini_ file.
- **GoatCounter integration** Mejiro can be used with [GoatCounter](https://www.goatcounter.com/) web analytics.

## Requirements

* A web server with PHP5 or higher (Tested with Apache and lighttpd)
* PHP libraries: gd, exif, imagick
* A web server with PHP7 or higher (tested with Apache and lighttpd)
* PHP libraries: GD, EXIF
* Git (optional)

## 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).
1. 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.
2. Open the *config.php* file in a text editor and edit settings.
3. Put photos into the *photos* directory (_.jpg_, _.jpeg_, _.JPG_, and _.JPEG_ as well as RAW files).
4. Make the _mejiro_ directory writable by the server by running `chown www-data -R mejiro` as root.
5. 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.
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

Expand All @@ -50,7 +51,12 @@ You can add descriptions to photos by creating accompanying *.txt* files. For ex

## Author

Dmitri Popov ([dmpop@linux.com](mailto:dmpop@linux.com))
Dmitri Popov ([dmpop@cameracode.coffee](mailto:dmpop@cameracode.coffee))

## Acknowledgments

- Icons: [Teeny icons](https://teenyicons.com/)
- Internationalization: [php-i18n](https://github.com/Philipp15b/php-i18n)

## License

Expand Down

0 comments on commit b02de50

Please sign in to comment.