fastgallery/README.md

43 lines
1.6 KiB
Markdown
Raw Normal View History

2020-09-20 15:38:22 +00:00
# gogallery - Static photo gallery generator
2020-09-28 21:30:14 +00:00
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
- Uses relative paths (safe for subdirectories or S3)
2020-09-28 21:30:14 +00:00
N.B. deletes all unused media files in gallery directory
## Install
2020-09-28 21:30:14 +00:00
For dependencies, on Ubuntu, install libvips42 and ffmpeg
2020-09-28 21:32:07 +00:00
`apt-get install libvips42 ffmpeg`
2020-09-28 21:30:14 +00:00
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 (to be published...)
## Usage
2020-09-28 21:32:07 +00:00
`VIPS_WARNING=0 gogallery -o /var/www/html ~/Dropbox/Pictures`
2020-09-28 21:30:14 +00:00
## Backlog
Before 0.1 beta release, still to do:
- HTML templates
- CSS
- Rudimentary lightbox JS
2020-09-29 20:50:12 +00:00
- Add triangle overlay on video thumbnails to indicate video
2020-09-28 21:30:14 +00:00
- Clean up half-finished thumbnail/fullsize/symlink if program is halted midway
- Use all of thumb/full/symlink in detecting changes required
- Packaging for Ubuntu
- Set up Ubuntu repository (Github? PPA?)
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
- 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)