1
0
mirror of https://github.com/bpatrik/pigallery2.git synced 2024-12-04 10:34:45 +02:00
A fast directory-first photo gallery website, with rich UI, optimized for running on low resource servers (especially on raspberry pi)
Go to file
2018-05-27 13:02:51 -04:00
backend handling broken directory path 2018-05-26 21:44:32 -04:00
common migrating to bootstrap v4 2018-05-13 16:59:57 -04:00
demo/images adding more photos to demo directory 2017-07-21 00:28:39 +02:00
frontend removing hardcoded languages 2018-05-27 13:02:51 -04:00
test improving tests 2018-03-30 15:30:30 -04:00
.editorconfig adding angular-cli support (causes major refactoring) 2017-06-10 22:32:56 +02:00
.gitignore simplifying deployment 2017-07-20 23:49:27 +02:00
.npmignore improving release scripts 2017-06-02 23:48:46 +02:00
.travis.yml package fixes 2018-05-23 22:42:50 -04:00
angular.json upgrading to angular 6 2018-05-22 20:27:07 -04:00
COMPARE.md package update 2017-10-19 12:08:07 -04:00
gulpfile.js improving hungarian translation 2018-05-27 13:02:20 -04:00
karma.conf.js upgrading to angular 6 2018-05-22 20:27:07 -04:00
LICENSE Initial commit 2016-03-12 12:46:42 +01:00
package.json package update 2018-05-26 21:54:22 -04:00
Procfile fixing sharing settings error 2018-05-24 21:29:05 -04:00
protractor.conf.js folder settings bugfix 2017-07-15 17:48:29 +02:00
README.md Update README.md 2018-05-15 20:01:11 -04:00
tsconfig.json improving tests 2018-03-30 15:30:30 -04:00
tslint.json upgrading to angular 6 2018-05-22 20:27:07 -04:00
USERRIGHTS.md improving sharing 2017-07-09 12:03:17 +02:00

PiGallery2

npm version Build Status Coverage Status Heroku Dependency Status devDependency Status

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/

Table of contents

  1. Getting started
  2. Translate the page to your own language
  3. Feature list
  4. Credits

Getting started (on Raspberry Pi 1)

Install NodeJs

Download and extract

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:

cd node-v6.10.3-linux-armv6l/
sudo cp -R * /usr/local/

Add to path. Add the following line to ~/.bashrc

PATH=$PATH:/usr/local/bin

Full node install description: https://raspberrypi.stackexchange.com/questions/48303/install-nodejs-for-all-raspberry-pi

Install PiGallery2

Install from release

cd ~
wget https://github.com/bpatrik/pigallery2/releases/download/1.1.0/pigallery2.zip
unzip pigallery2.zip
cd pigallery2
npm install

Install from source

cd ~
wget https://github.com/bpatrik/pigallery2/archive/master.zip
unzip master.zip
cd pigallery2-master # enter the unzipped directory
npm install

Run PiGallery2

npm start

To configure it. Run PiGallery2 first to create config.json file, then edit it and restart. Default user: admin pass: admin

Useful links/tips:

using nginx

https://stackoverflow.com/questions/5009324/node-js-nginx-what-now

making https

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

apt-get install build-essential  libkrb5-dev gcc g++

Translate the page to your own language

  1. download / clone the repo (the source not the packed release!)
  2. add your language e.g: fr
    npm run add-translation -- --fr
    
    it creates a new messages.fr.xls file at 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
    npm install
    npm start
    
  5. create a pull request at github to add your translation to the project.

Feature list

  • 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)
  • 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 several core CPU
    • supporting hardware acceleration (sharp and gm as optional and JS-based Jimp as fallback)
  • Custom lightbox for full screen photo 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)
  • Client side caching (directories and search results)
  • Rendering photos with GPS coordinates on google map
    • .gpx file support - future plan
  • 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
  • internalization / translation support
  • Nice design
    • responsive design (phone, tablet desktop support)
  • Setup page
  • video support - future plan
  • Markdown based blogging support - future plan
    • you can write some note in the blog.md for every directory
  • bug free :) - In progress

Credits

Crossbrowser testing sponsored by Browser Stack Browser Stack