gallery/README.adoc

40 lines
1.2 KiB
Plaintext
Raw Permalink Normal View History

2024-01-21 12:41:35 +01:00
gallery
=======
2023-12-08 02:16:04 +01:00
This is gallery software designed to maintain a shadow structure
of your filesystem, in which you can attach metadata to your media,
and query your collections in various ways.
All media is content-addressed by its SHA-1 hash value, and at your option
also perceptually hashed. Duplicate search is an essential feature.
2024-01-27 18:28:21 +01:00
The gallery is designed for simplicity, and easy interoperability.
sqlite3, curl, jq, and the filesystem will take you a long way.
Prerequisites: Go, ImageMagick, xdg-utils
ImageMagick v7 is preferred, it doesn't shoot out of memory as often.
2023-12-08 02:16:04 +01:00
2024-01-27 18:28:21 +01:00
Getting it to work
------------------
# apt install build-essential git golang imagemagick xdg-utils
$ git clone https://git.janouch.name/p/gallery.git
$ cd gallery
$ make
$ ./gallery init G
$ ./gallery sync G ~/Pictures
$ ./gallery thumbnail G # parallelized, with memory limits
$ ./gallery -threads 1 thumbnail G # one thread only gets more memory
$ ./gallery dhash G
$ ./gallery web G :8080
2023-12-08 02:16:04 +01:00
The intended mode of use is running daily automated sync/thumbnail/dhash/tag
2024-01-27 18:28:21 +01:00
batches in a cron job, or from a systemd timer.
The _web_ command needs to see the _public_ directory,
and is friendly to reverse proxying.
Demo
----
https://holedigging.club/gallery/