fastgallery/README.md

# gogallery - Static photo gallery generator

Creates a static gallery of your photo and video library.

- Super fast (100% Go, concurrent, uses fastest image/video libraries, 4-8 times faster than others)
- Both photo and video support
- Deals with any file formats (ncluding HEIC, HEVC)
- Only updates changed files, runs incrementally
- Uses relative paths (safe for subdirectories or S3)

N.B. deletes all unused media files in gallery directory

## Install

For dependencies, on Ubuntu, install libvips42 and ffmpeg (if you need video support)

`apt-get install libvips42 ffmpeg`

Image and video format support will depend on the support compiled in these libraries. For HEIC+HEVC support check out my PPA for a recompiled libvips42 for Ubuntu (to be published...)

## Usage

`VIPS_WARNING=0 gogallery -o /var/www/html ~/Dropbox/Pictures`

## Backlog

Before 0.1 Alpha release, still to do:
- Convert thumbnail and full-size pictures
- Add triangle overlay on video thumbnails to indicate video
- Clean up half-finished thumbnail/fullsize/symlink if program is halted midway
- Use all of thumb/full/symlink in detecting changes required

Before 0.1 Beta release:
- Clean function names
- Refactor functions into internal packages
- Create unit tests (blargh)
- Packaging for Ubuntu
- Set up Ubuntu repository (Github? PPA?)
- Finger swiping for web frontend
- Arrow key navigation for web frontend

Other stuff on the roadmap:
- Allow copying instead of symlinking originals
- Lots of options / config file to tweak defaults
- Patch bimg library so it doesn't log to console without VIPS_WARNING (https://github.com/h2non/bimg/issues/355)
- Add logging to file, better bimg and ffmpeg error handling, when to panic
- Add 'force_divisible_by=2' to ffmpeg encoding (when feature is available in next ffmpeg release)
- Go through the rest of the minor annoyances (TODOs in code)