2016-03-12 19:46:42 +08:00
# PiGallery2
2017-06-04 04:35:47 +08:00
[](https://badge.fury.io/js/pigallery2)
2017-07-04 01:17:49 +08:00
[](https://travis-ci.org/bpatrik/pigallery2)
2017-07-07 04:54:36 +08:00
[](https://coveralls.io/github/bpatrik/PiGallery2?branch=master)
2016-05-02 16:07:42 +08:00
[](https://pigallery2.herokuapp.com)
2017-07-04 01:17:49 +08:00
[](https://codeclimate.com/github/bpatrik/pigallery2)
[](https://david-dm.org/bpatrik/pigallery2)
[](https://david-dm.org/bpatrik/pigallery2#info=devDependencies)
2016-03-12 21:21:25 +08:00
2017-03-23 02:38:39 +08:00
This is a directory-first photo gallery website, optimised for running on low resource servers (especially on raspberry pi)
2016-03-14 20:30:15 +08:00
2017-06-04 21:25:22 +08:00
## Live Demo
Live Demo @ heroku: https://pigallery2.herokuapp.com/
2017-03-23 02:38:39 +08:00
2016-03-14 20:30:15 +08:00
2017-03-23 02:38:39 +08:00
2017-06-04 21:25:22 +08:00
## Install (on Raspberry Pi 1)
### Install NodeJs
Download and extract
```bash
cd ~
wget https://nodejs.org/dist/v6.10.3/node-v6.10.3-linux-armv6l.tar.gz
tar -xzf node-v6.10.3-linux-armv6l.tar.gz
```
Copy it to /usr/local:
```bash
cd node-v6.10.3-linux-armv6l/
sudo cp -R * /usr/local/
```
Add to path. Add the following line to `~/.bashrc`
```bash
PATH=$PATH:/usr/local/bin
```
Full node install description: https://raspberrypi.stackexchange.com/questions/48303/install-nodejs-for-all-raspberry-pi
### Install PiGallery2
```bash
cd ~
2017-07-12 04:23:07 +08:00
wget https://github.com/bpatrik/pigallery2/releases/download/1.0.0-beta.3/pigallery2.zip
tar -xzvf pigallery2.zip
unzip pigallery2
2017-06-04 21:25:22 +08:00
npm install
npm run build
```
### Run PiGallery2
```bash
npm start
```
To configure it. Run `PiGallery2` first to create `config.json` file, then edit it and restart.
## Feature list
2017-03-23 02:38:39 +08:00
* **Rendering directories as it is**
* Listing subdirectories recursively
* Listing photos in a nice grid layout
* supporting most common image formats
* showing **tag/keywords, locations, GPS coordinates** for photos
* rendering photos on demand (on scroll)
2017-03-23 02:41:32 +08:00
* **On the fly thumbnail generation** in several sizes
2017-03-23 02:38:39 +08:00
* prioritizes thumbnail generation (generating thumbnail first for the visible photos)
* saving generated thumbnails to TEMP folder for reuse
* supporting several core CPU
2017-06-12 05:33:47 +08:00
* supporting hardware acceleration ([sharp](https://github.com/lovell/sharp) and [gm ](https://github.com/aheckmann/gm ) as optional and JS-based [Jimp ](https://github.com/oliver-moran/jimp ) as fallback)
2017-03-23 02:38:39 +08:00
* Custom lightbox for full screen photo viewing
2017-07-09 18:03:17 +08:00
* keyboard support for navigation
2017-03-23 02:38:39 +08:00
* showing low-res thumbnail while full image loads
2017-07-10 04:00:42 +08:00
* Information panel for showing **Exif info**
2017-07-12 04:23:07 +08:00
* Automatic playing
2017-03-23 02:41:32 +08:00
* Client side caching (directories and search results)
2017-03-23 02:38:39 +08:00
* Rendering **photos** with GPS coordinates **on google map**
2017-07-09 18:03:17 +08:00
* .gpx file support - `future plan`
2017-03-23 02:41:32 +08:00
* **Two modes: SQL database and no-database mode**
* both modes supports
* user management
* password protection can be disabled/enabled
2017-03-23 02:38:39 +08:00
* database mode supports:
* faster directory listing
* searching
* instant search, auto complete
2017-07-09 18:03:17 +08:00
* sharing
2017-03-23 02:38:39 +08:00
* setting link expiration time
* Nice design - `In progress`
* responsive design (phone, tablet desktop support)
* Setup page - `In progress`
2017-07-09 18:03:17 +08:00
* **Markdown based blogging support** - `future plan`
2017-03-23 02:41:32 +08:00
* you can write some note in the blog.md for every directory
2017-03-23 02:38:39 +08:00
* bug free :) - `In progress`
