1
0
mirror of https://github.com/xuthus83/pigallery2.git synced 2024-11-03 21:04:03 +08:00

Update README.md

This commit is contained in:
Patrik J. Braun 2020-01-01 22:25:45 +01:00 committed by GitHub
parent 8001e80ce1
commit c47879f34c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -18,7 +18,7 @@ Live Demo @ heroku: https://pigallery2.herokuapp.com/
![PiGallery2 - Animated gif demo](docs/demo.gif) ![PiGallery2 - Animated gif demo](docs/demo.gif)
## Table of contents ## Table of contents
1. [Getting started](#1-getting-started-on-raspberry-pi) 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) 2. [Translate the page to your own language](#2-translate-the-page-to-your-own-language)
3. [Feature list](#3-feature-list) 3. [Feature list](#3-feature-list)
4. [Suggest/endorse new features](#4-suggestendorse-new-features) 4. [Suggest/endorse new features](#4-suggestendorse-new-features)
@ -29,14 +29,15 @@ Live Demo @ heroku: https://pigallery2.herokuapp.com/
## 1. Getting started (also works on Raspberry Pi) ## 1. Getting started (also works on Raspberry Pi)
### 1.1 Run with Docker (recommended) ### 1.1 Install and Run with Docker (recommended)
If you have `docker` and don't want to install all the dependencies, you can use one of our docker build.
[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/ For configuration and docker-compose files read more [here](docker/README.md) or check all builds: https://hub.docker.com/r/bpatrik/pigallery2/tags/
**Note**: You dont need to do the rest of the installation steps if you are using docker.
### 1.2 Direct Install ### 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. 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/) ### 1.2.0 [Install NodeJs](https://nodejs.org/en/download/)
Download and extract Download and extract
@ -61,6 +62,7 @@ npm install
**Note:** A build requires a machine with around 2GB or memory. **Note:** A build requires a machine with around 2GB or memory.
```bash ```bash
cd ~ cd ~
wget https://github.com/bpatrik/pigallery2/archive/master.zip wget https://github.com/bpatrik/pigallery2/archive/master.zip
@ -69,8 +71,10 @@ cd pigallery2-master # enter the unzipped directory
npm install npm install
npm run build npm run build
``` ```
**Note**: if you run `npm run create-release`, it creates a clean, minified, production ready version from the app in the `release` folder, that is ready to deploy.
**Note2**: you can use `npm run create-release -- --languages=fr,ro` to restrict building to the listed languages (english is added by default) **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 #### 1.2.2 Run PiGallery2
```bash ```bash
@ -135,20 +139,20 @@ apt-get install build-essential libkrb5-dev gcc g++
## 3. Feature list ## 3. Feature list
* supported formats: * supported formats [full list here](https://github.com/bpatrik/pigallery2/blob/master/src/common/SupportedFormats.ts):
* images: **jpg, jpeg, jpe, webp, png, gif, svg** * images: **jpg, jpeg, jpe, webp, png, gif, svg**
* videos: **mp4, ogg, ogv, webm** * 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** * **Rendering directories as it is**
* Listing subdirectories recursively * Listing subdirectories recursively
* Listing photos in a nice grid layout * Listing photos in a nice grid layout
* supporting most common image formats
* showing **tag/keywords, locations, GPS coordinates** for photos * showing **tag/keywords, locations, GPS coordinates** for photos
* rendering photos on demand (on scroll) * rendering photos on demand (on scroll)
* **On the fly thumbnail generation** in several sizes * **On the fly thumbnail generation** in several sizes
* prioritizes thumbnail generation (generating thumbnail first for the visible photos) * prioritizes thumbnail generation (generating thumbnail first for the visible photos)
* saving generated thumbnails to TEMP folder for reuse * saving generated thumbnails to TEMP folder for reuse
* supporting multi-core CPUs * supporting multi-core CPUs
* 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) * supporting hardware acceleration ([sharp](https://github.com/lovell/sharp)
* Custom lightbox for full screen photo and video viewing * Custom lightbox for full screen photo and video viewing
* keyboard support for navigation * keyboard support for navigation
* showing low-res thumbnail while full image loads * showing low-res thumbnail while full image loads
@ -156,6 +160,8 @@ apt-get install build-essential libkrb5-dev gcc g++
* Automatic playing * Automatic playing
* gesture support (swipe left, right, up) * gesture support (swipe left, right, up)
* shortcut support * 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) * Client side caching (directories and search results)
* Rendering **photos** with GPS coordinates **on open street maps** * Rendering **photos** with GPS coordinates **on open street maps**
* .gpx file support: rendering paths to map * .gpx file support: rendering paths to map
@ -174,15 +180,24 @@ apt-get install build-essential libkrb5-dev gcc g++
* reads Adobe's XMP Face region metadata. (It is defined by the Metadata Working Group (MWG).) * reads Adobe's XMP Face region metadata. (It is defined by the Metadata Working Group (MWG).)
* shows face bounding box over images * shows face bounding box over images
* internalization / translation support * internalization / translation support
* currently supported languages: eng, hun * currently supported languages: eng, hun, ro, ru, fr
* Nice design * Nice design
* responsive design (phone, tablet desktop support) * responsive design (phone, tablet desktop support)
* Setup page * Setup page
* Random photo url * 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 * 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 * video support
* fully supports *.mp4 files and partially (might have errors with safari and IE) supports *.ogg, *.ogv, *.webm files * 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 * 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 * Dockerized
* **Markdown based blogging support** - `future plan` * **Markdown based blogging support** - `future plan`
* you can write some note in the blog.md for every directory * you can write some note in the blog.md for every directory
@ -199,7 +214,8 @@ apt-get install build-essential libkrb5-dev gcc g++
* There is no nice way to handle EXIF orientation tag properly. * 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)) 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 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. A solution might be to down scale / convert the video files to lower bitrate. * 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 ## 6. Credits
Crossbrowser testing sponsored by [Browser Stack](https://www.browserstack.com) 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) [<img src="https://camo.githubusercontent.com/a7b268f2785656ab3ca7b1cbb1633ee5affceb8f/68747470733a2f2f64677a6f7139623561736a67312e636c6f756466726f6e742e6e65742f70726f64756374696f6e2f696d616765732f6c61796f75742f6c6f676f2d6865616465722e706e67" alt="Browser Stack" height="31px" style="background: cornflowerblue;">](https://www.browserstack.com)