2018-12-04 05:38:25 +08:00
# PiGallery2
2020-01-03 05:28:18 +08:00
2020-01-03 05:11:59 +08:00
[](https://lgtm.com/projects/g/bpatrik/pigallery2/context:javascript)
2017-07-04 01:17:49 +08:00
[](https://travis-ci.org/bpatrik/pigallery2)
2020-01-03 05:28:18 +08:00
[](https://coveralls.io/github/bpatrik/pigallery2?branch=master)
2019-12-24 06:17:05 +08:00
[](https://github.com/bpatrik/pigallery2/actions)
2018-11-30 22:36:42 +08:00
[](https://david-dm.org/bpatrik/pigallery2)
2020-01-03 05:28:18 +08:00
2018-12-06 20:50:55 +08:00
2018-12-04 05:38:25 +08:00
Homepage: http://bpatrik.github.io/pigallery2/
2021-05-24 17:17:27 +08:00
This is a **fast** (like faster than your PC fast) **directory-first photo gallery website** , optimised for running on low resource servers (especially on raspberry pi).
2022-12-11 23:10:23 +08:00
✔️ Strengths:
2022-12-11 23:11:21 +08:00
* ⚡ Fast, like for real.
* ✔️ Simple. Point to your photos folder and to a temp folder and you are good to go.
2021-05-24 17:17:27 +08:00
⛔ Weakness:
* 😥 Its simple. Shows what you have that's it. No gallery changes (photo delete, rotate, enhance, tag, organize, etc), your gallery folder is read-only.
2022-12-11 23:11:21 +08:00
* 📁 Optimized for galleries with < 100K photos with < 5k photos / folder .
* It will work on bigger galleries, but it will start to slow down.
2022-12-11 23:10:23 +08:00
[You wrote about pigallery2 ](docs/references/README.md ).
2016-03-14 20:30:15 +08:00
2017-06-04 21:25:22 +08:00
## Live Demo
2022-12-09 17:10:59 +08:00
Live Demo @ render: https://pigallery2.onrender.com/
2018-12-03 05:30:49 +08:00
- the demo page **first load** might take up **30s** : the time while the free webservice boots up
2017-03-23 02:38:39 +08:00
2019-12-13 00:22:41 +08:00
2018-05-16 08:01:11 +08:00
## Table of contents
2020-01-02 05:25:45 +08:00
1. [Getting started ](#1-getting-started-also-works-on-raspberry-pi )
2018-12-22 07:29:05 +08:00
2. [Translate the page to your own language ](#2-translate-the-page-to-your-own-language )
3. [Feature list ](#3-feature-list )
2019-02-25 18:50:27 +08:00
4. [Suggest/endorse new features ](#4-suggestendorse-new-features )
2019-02-25 18:41:56 +08:00
5. [Known errors ](#5-known-errors )
6. [Credits ](#6-credits )
2016-03-14 20:30:15 +08:00
2017-03-23 02:38:39 +08:00
2018-05-16 08:01:11 +08:00
2019-12-24 04:07:34 +08:00
## 1. Getting started (also works on Raspberry Pi)
2020-09-13 20:51:48 +08:00
### 1.1 [Install and Run with Docker (recommended)](docker/README.md)
2020-01-02 05:25:45 +08:00
2020-09-11 05:49:52 +08:00
[Docker ](https://www.docker.com/ ) with [docker-compose ](https://docs.docker.com/compose/ ) is the official and recommend way of installing and running *Pigallery2* .
2020-01-02 05:25:45 +08:00
It contains all necessary dependencies, auto restarts on reboot, supports https, easy to upgrade to newer versions.
2022-12-11 23:10:23 +08:00
For configuration and docker-compose files read more [here ](docker/README.md ) or check all builds [here ](https://hub.docker.com/r/bpatrik/pigallery2/tags/ ).
2019-12-24 04:07:34 +08:00
2020-09-11 05:49:52 +08:00
### 1.2 Direct Install (if you are familiar with Node.js and building npm packages from source)
2022-08-26 17:34:10 +08:00
As an alternative, you can also directly [install Node.js ](https://www.scaler.com/topics/javascript/install-node-js/ ) and the app and run it natively.
2020-09-11 05:49:52 +08:00
### 1.2.0 [Install Node.js](https://nodejs.org/en/download/)
2017-06-04 21:25:22 +08:00
Download and extract
```bash
2019-12-24 04:07:34 +08:00
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
2018-12-03 05:15:39 +08:00
sudo apt-get install -y nodejs
2017-06-04 21:25:22 +08:00
```
2018-12-03 05:15:39 +08:00
2018-12-06 16:52:04 +08:00
Full node install on raspberry pi description: https://www.w3schools.com/nodejs/nodejs_raspberrypi.asp
2017-06-04 21:25:22 +08:00
2019-12-24 04:07:34 +08:00
### 1.2.1 Install PiGallery2
#### 1.2.1-a Install from release
2017-07-13 00:35:23 +08:00
2017-06-04 21:25:22 +08:00
```bash
cd ~
2021-09-03 18:49:39 +08:00
wget https://github.com/bpatrik/pigallery2/releases/download/1.9.0/pigallery2-release.zip
2021-09-06 19:07:38 +08:00
unzip pigallery2-release.zip -d pigallery2
2018-05-16 08:01:11 +08:00
cd pigallery2
2017-07-13 00:35:23 +08:00
npm install
```
2019-12-24 04:07:34 +08:00
#### 1.2.1-b Install from source
2020-01-02 04:18:35 +08:00
**Note:** A build requires a machine with around 2GB or memory.
2020-01-02 05:25:45 +08:00
2017-07-13 00:35:23 +08:00
```bash
cd ~
wget https://github.com/bpatrik/pigallery2/archive/master.zip
unzip master.zip
2018-05-16 08:01:11 +08:00
cd pigallery2-master # enter the unzipped directory
2017-06-04 21:25:22 +08:00
npm install
2020-01-02 01:29:44 +08:00
npm run build
2017-06-04 21:25:22 +08:00
```
2020-01-02 05:25:45 +08:00
2020-09-11 05:49:52 +08:00
**Note**: It is recommended to create a release version with `npm run create-release` on a more powerful machine and deploy that to you server.
2020-01-02 05:25:45 +08:00
2020-09-11 05:49:52 +08:00
**Note**: you can use `npm run create-release -- --languages=fr,ro` to restrict building to the listed languages (English is added by default)
2017-07-13 00:35:23 +08:00
2019-12-24 04:07:34 +08:00
#### 1.2.2 Run PiGallery2
2017-06-04 21:25:22 +08:00
```bash
npm start
```
2018-12-06 04:55:11 +08:00
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.
2021-03-16 04:52:50 +08:00
2022-11-30 03:58:23 +08:00
Default user: `admin` pass: `admin` . (It is not possible to change the admin password, you need to create another user and delete the default `admin` user, see [#220 ](https://github.com/bpatrik/pigallery2/issues/220 ))
2017-06-04 21:25:22 +08:00
2019-12-29 19:09:08 +08:00
**Note**: First run, you might have file access issues and port 80 issue, see [#115 ](https://github.com/bpatrik/pigallery2/issues/115 ).
2019-12-29 17:45:01 +08:00
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 ).
2018-12-06 20:50:55 +08:00
2020-09-13 20:51:48 +08:00
##### 1.2.2.1 Run on startup
You can run the app up as a service to run it on startup. Read more at [#42 ](https://github.com/bpatrik/pigallery2/issues/42#issuecomment-458340945 )
2018-12-06 20:50:55 +08:00
### 1.3 Advanced configuration
2022-12-11 23:10:23 +08:00
You can set up the app any of the following ways:
1. Using the UI (recommended)
2. Manually editing the `config.json`
3. Through switches
* Like: `node start -- --Server-port=3000 --Client-authenticationRequired=false`
* You can check the generated `config.json` for the config hierarchy
4. Through environmental variable
* like set env. variable `Server-port` to `3000`
2018-12-06 20:50:55 +08:00
2020-09-11 05:49:52 +08:00
Full list of configuration options are available at the [MANPAGE.md ](MANPAGE.md ).
2020-02-07 20:59:36 +08:00
2018-12-06 20:50:55 +08:00
### 1.4 Useful links/tips:
2018-05-16 08:01:11 +08:00
#### using nginx
2018-12-06 20:50:55 +08:00
It is recommended to use a reverse proxy like nginx before node
2017-07-30 05:39:06 +08:00
https://stackoverflow.com/questions/5009324/node-js-nginx-what-now
2017-10-20 00:08:07 +08:00
2018-05-16 08:01:11 +08:00
#### making https
2018-12-06 20:50:55 +08:00
With cerbot & nginx it is simple to set up secure connection. You have no excuse not doing so.
2017-07-30 05:39:06 +08:00
https://certbot.eff.org/
2018-05-16 08:01:11 +08:00
#### node install error:
2017-10-20 00:08:07 +08:00
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++
```
2018-12-06 16:52:04 +08:00
## 2. Translate the page to your own language
2020-09-06 16:11:30 +08:00
1. [Install Pigallery2 ](#121-b-install-from-source ) from source (with the release it won't work)
2018-05-16 08:01:11 +08:00
2. add your language e.g: fr
2021-04-18 00:32:32 +08:00
* copy `src/frontend/translate/messages.en.xls` to `src/frontend/translate/messages.fr.xls`
* add the new translation to the `angular.json` `projects->pigallery2->i18n->locales` section
3. translate the file by updating the `<target>` tags
2018-05-16 08:01:11 +08:00
4. test if it works:
build and start the app
```bash
npm install
2020-01-02 05:28:09 +08:00
npm run build
2018-05-16 08:01:11 +08:00
npm start
```
2018-12-22 07:20:03 +08:00
5. (optional) create a pull request at github to add your translation to the project.
2020-01-02 05:28:09 +08:00
**Note**: you can also build your own release with as described in [1.1.1-b Install from source ](#121-b-install-from-source );
2018-05-16 08:01:11 +08:00
2018-12-06 16:52:04 +08:00
## 3. Feature list
2017-06-04 21:25:22 +08:00
2023-09-22 05:17:50 +08:00
See: http://bpatrik.github.io/pigallery2/
2019-02-25 18:41:56 +08:00
2019-02-25 18:49:37 +08:00
## 4. Suggest/endorse new features
2022-12-11 23:10:23 +08:00
Unfortunately, lately I only have a limited time for this hobby project of mine.
So, I mostly focus on those features that are align with my needs. Sorry :(.
Although, I try to fix bugs ASAP (that can still take from a few days to months).
I also try to implement some feature requests that have a lots of 'likes' (i.e.: `+1` -s or thumbs ups) on it.
2021-04-25 15:58:18 +08:00
If you have a feature that you really would like to happen, I welcome contributions to the app. See [CONTRIBUTING.md ](https://github.com/bpatrik/pigallery2/blob/master/CONTRIBUTING.md ) for more details.
2018-03-30 08:30:23 +08:00
2019-02-25 18:41:56 +08:00
## 5. Known errors
2021-04-04 15:46:23 +08:00
* IOS map issue
* Map on IOS prevents using the buttons in the image preview navigation, see #155
2018-12-03 03:57:16 +08:00
* Video support on weak servers (like raspberry pi) with low upload rate
2022-12-11 23:10:23 +08:00
* video playback may use up too much resources and the server might not respond for a while. Enable video transcoding in the app, to transcode the videos to lover bitrate.
2023-06-07 01:50:41 +08:00
* When using an Apache proxy, sub folders are not accessible
* add `AllowEncodedSlashes On` in the configuration of the proxy
2022-12-11 23:10:23 +08:00
## 6. Supporting the project
I'm making this app for my own entertainment,
but I like to share it with others as the contributions and bug reports make the app better
and it also does not cost anything to me :)
There is [no way to donate ](https://github.com/bpatrik/pigallery2/discussions/328#discussioncomment-894546 ) to this project at the moment. And I'm also not planning on monetizing it.
But it warms my hearth [seeing that it is useful for some people ](docs/references/README.md ).
2019-02-25 18:41:56 +08:00
## 6. Credits
2018-05-16 08:01:11 +08:00
Crossbrowser testing sponsored by [Browser Stack ](https://www.browserstack.com )
[<img src="https://camo.githubusercontent.com/a7b268f2785656ab3ca7b1cbb1633ee5affceb8f/68747470733a2f2f64677a6f7139623561736a67312e636c6f756466726f6e742e6e65742f70726f64756374696f6e2f696d616765732f6c61796f75742f6c6f676f2d6865616465722e706e67" alt="Browser Stack" height="31px" style="background: cornflowerblue;"> ](https://www.browserstack.com )
