WebXiangpianbu is a photo album organizer written in Python/Django. It can work as a dynamic web application photo gallery or as a static site generator.
- Free, self-hosted web application
- No database required
- Highly customizable (albums, templates, styles)
- Mobile friendly
- EXIF and Geotagging extracting
- Map feature (Leaflet, Mapbox)
- Language localization
Install all needed dependencies using Poetry or PIP.
$ poetry install
or
$ pip install -r requirements.txt
Next steps:
- Copy
webxiang/settings_sample.py
towebxiang/settings.py
and modify it to your needs. - Optionally, run
python manage.py compilemessages
(if you havegettext
installed). - python manage.py collectstatic
See https://docs.djangoproject.com/en/dev/howto/deployment/ for usual Django applications deployment.
./scripts/build-docker.sh
[adjust files in the `run` folder]
docker-compose up
generate.py -- generate albums from photo files.
$ tools/generate.py --album-dir=albums/ ~/photos/vacation/ ~/webxiang/static/data/vacation
$ tools/generate.py --help
next, adjust the generated vacation.yaml
convert.py -- convert albums between different file formats (YAML, JSON).
$ tools/convert.py 'albums/*.yaml' tmp/
$ tools/generate.py ~/photos/vacation/ ~/tmp/vacation
$ tools/staticgen.py --quick=~/tmp/vacation --copy
$ tools/staticgen.py --help