# PiGallery2 [![npm version](https://badge.fury.io/js/pigallery2.svg)](https://badge.fury.io/js/pigallery2) [![Build Status](https://travis-ci.org/bpatrik/pigallery2.svg?branch=master)](https://travis-ci.org/bpatrik/pigallery2) [![Heroku](https://heroku-badge.herokuapp.com/?app=pigallery2&style=flat)](https://pigallery2.herokuapp.com) [![Docker build](https://github.com/bpatrik/pigallery2/workflows/docker-buildx/badge.svg)](https://github.com/bpatrik/pigallery2/actions) [![dependencies Status](https://david-dm.org/bpatrik/pigallery2/status.svg)](https://david-dm.org/bpatrik/pigallery2) [![devDependencies Status](https://david-dm.org/bpatrik/pigallery2/dev-status.svg)](https://david-dm.org/bpatrik/pigallery2?type=dev) Homepage: http://bpatrik.github.io/pigallery2/ This is a directory-first photo gallery website, optimised for running on low resource servers (especially on raspberry pi) ## Live Demo Live Demo @ heroku: https://pigallery2.herokuapp.com/ - the demo page **first load** might take up **30s**: the time while the free webservice boots up ![PiGallery2 - Animated gif demo](docs/demo.gif) ## Table of contents 1. [Getting started](#1-getting-started-also-works-on-raspberry-pi) 2. [Translate the page to your own language](#2-translate-the-page-to-your-own-language) 3. [Feature list](#3-feature-list) 4. [Suggest/endorse new features](#4-suggestendorse-new-features) 5. [Known errors](#5-known-errors) 6. [Credits](#6-credits) ## 1. Getting started (also works on Raspberry Pi) ### 1.1 Install and Run with Docker (recommended) [Docker](https://www.docker.com/) with [docker-compose](https://docs.docker.com/compose/) is the offitial and recommend way of installing and running *Pigallery2*. It contains all necessary dependencies, auto restarts on reboot, supports https, easy to upgrade to newer versions. For configuration and docker-compose files read more [here](docker/README.md) or check all builds: https://hub.docker.com/r/bpatrik/pigallery2/tags/ ### 1.2 Direct Install (if you are familiar with nodejs and building npm packages from source) As an alternative, you can also directly install nodejs and the app and run it natively. ### 1.2.0 [Install NodeJs](https://nodejs.org/en/download/) Download and extract ```bash curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash - sudo apt-get install -y nodejs ``` Full node install on raspberry pi description: https://www.w3schools.com/nodejs/nodejs_raspberrypi.asp ### 1.2.1 Install PiGallery2 #### 1.2.1-a Install from release ```bash cd ~ wget https://github.com/bpatrik/pigallery2/releases/download/1.8.0/pigallery2.zip unzip pigallery2.zip -d pigallery2 cd pigallery2 npm install ``` #### 1.2.1-b Install from source **Note:** A build requires a machine with around 2GB or memory. ```bash cd ~ wget https://github.com/bpatrik/pigallery2/archive/master.zip unzip master.zip cd pigallery2-master # enter the unzipped directory npm install npm run build ``` **Note**: It is recommended to create a release version with `npm run create-release` on a more powerful mashine and deploy that to you server. **Note**: you can use `npm run create-release -- --languages=fr,ro` to restrict building to the listed languages (english is added by default) #### 1.2.2 Run PiGallery2 ```bash npm start ``` To configure it, run `PiGallery2` first to create `config.json` file, then edit it and restart. The app has a nice UI for settings, you may use that too. Default user: `admin` pass: `admin` **Note**: First run, you might have file access issues and port 80 issue, see [#115](https://github.com/bpatrik/pigallery2/issues/115). Running `npm start -- --Server-port=8080` will start the app on port 8080 that does not require `root` Adding read/write permissions to all files can solve the file access issue `chmod -R o-w .`, see [#98](https://github.com/bpatrik/pigallery2/issues/98). ### 1.3 Advanced configuration You can set up the app the following ways: * Using the UI * Manually editing the `config.json` * Through switches * Like: `node start -- --Server-port=3000 --Client-authenticationRequired=false` * You can check the generated `config.json` for the config hierarchy * Note: you can run the app to generate the config file only, by running `npm start -- --config-only` * Through environmental variable * like set env. variable `Server-port` to `3000` ### 1.4 Useful links/tips: #### using nginx It is recommended to use a reverse proxy like nginx before node https://stackoverflow.com/questions/5009324/node-js-nginx-what-now #### making https With cerbot & nginx it is simple to set up secure connection. You have no excuse not doing so. https://certbot.eff.org/ #### node install error: If you get error during module installation, make sure you have everything to build node modules from source ```bash apt-get install build-essential libkrb5-dev gcc g++ ``` ## 2. Translate the page to your own language 1. [Install Pigallery2](#111-b-install-from-source) from source (with the release it won't work) 2. add your language e.g: fr ```bash npm run add-translation -- --fr ``` it creates a new `messages.fr.xls` file at `src/frontend/translate` folder, it will already contain dummy translation with google translate. 3. 'fix' the dummy translation 4. test if it works: build and start the app ```bash npm install npm start ``` 5. (optional) create a pull request at github to add your translation to the project. **Note**: you can also build your own release with as described in [1.1.1-b Install from source](#111-b-install-from-source); ## 3. Feature list * supported formats [full list here](https://github.com/bpatrik/pigallery2/blob/master/src/common/SupportedFormats.ts): * images: **jpg, jpeg, jpe, webp, png, gif, svg** * videos: **mp4, ogg, ogv, webm** * with (built-in) transcoding: avi, mkv, mov, wmv, flv, mts, m2ts, mpg, 3gp, m4v, mpeg, vob, divx, xvid, ts * **Rendering directories as it is** * Listing subdirectories recursively * Listing photos in a nice grid layout * showing **tag/keywords, locations, GPS coordinates** for photos * rendering photos on demand (on scroll) * **On the fly thumbnail generation** in several sizes * prioritizes thumbnail generation (generating thumbnail first for the visible photos) * saving generated thumbnails to TEMP folder for reuse * supporting multi-core CPUs * supporting hardware acceleration ([sharp](https://github.com/lovell/sharp) * Custom lightbox for full screen photo and video viewing * keyboard support for navigation * showing low-res thumbnail while full image loads * Information panel for showing **Exif info** * Automatic playing * gesture support (swipe left, right, up) * shortcut support * On the fly photo downscaling for faster load [#50](https://github.com/bpatrik/pigallery2/issues/50) * on zoom, the original photo loads * Client side caching (directories and search results) * Rendering **photos** with GPS coordinates **on open street maps** * .gpx file support: rendering paths to map * supports [OSM](https://www.openstreetmap.org) and [Mapbox](https://www.mapbox.com) by default, but you can add any provider that has a tile url * **Two modes: SQL database and no-database mode** * both modes supports * user management * password protection can be disabled/enabled * database mode supports: * faster directory listing * searching * instant search, auto complete * sharing * setting link expiration time * Faces (persons) support * reads Adobe's XMP Face region metadata. (It is defined by the Metadata Working Group (MWG).) * shows face bounding box over images * internalization / translation support * currently supported languages: eng, hun, ro, ru, fr * Nice design * responsive design (phone, tablet desktop support) * Setup page * Random photo url * You can generate an url that returns a random photo from your gallery. You can use this feature to develop 3rd party applications, like: changing desktop background * duplicate photo detection * video support * fully supports `*.mp4` files and partially (might have errors with safari and IE) supports `*.ogg`, `*.ogv`, `*.webm` files * uses ffmpeg and ffprobe to generate video thumbnails * can transcode videos to mp4 for better support * job sceduling support, with the following supported task: [#92](https://github.com/bpatrik/pigallery2/issues/92) * converting/transcoding videos [#66](https://github.com/bpatrik/pigallery2/issues/66) [#71](https://github.com/bpatrik/pigallery2/issues/71) * generating thumbnails * generating converted photos * cleaning up temp folder * indexing db * folder ignoring [#87](https://github.com/bpatrik/pigallery2/issues/87) * Dockerized * **Markdown based blogging support** - `future plan` * you can write some note in the blog.md for every directory * bug free :) - `In progress` ## 4. Suggest/endorse new features You are welcome to suggest new features to the application via [github issues](https://github.com/bpatrik/pigallery2/issues). I cannot garantie any dealine with the development of a new feature. (I usually fix bugs within week/weeks.) I will give a higher priority to a feature that has more 'likes' (i.e.: `+1`-s or thumbs ups) on it. ## 5. Known errors * EXIF orientation tag: * There is no nice way to handle EXIF orientation tag properly. The page handles these photos, but might cause same error in the user experience (e.g.: the pages loads those photos slower. See issue [#11](https://github.com/bpatrik/pigallery2/issues/11)) * Video support on weak servers (like raspberry pi) with low upload rate * video playback may use up too much resources and the server might not response for a while. Enable video transcoding in the app, to transcode the videos to lover bitrate. ## 6. Credits Crossbrowser testing sponsored by [Browser Stack](https://www.browserstack.com) [Browser Stack](https://www.browserstack.com)