Skip to content

A photo album organizer written in Python/Django.


Notifications You must be signed in to change notification settings


Repository files navigation


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
$ pip install -r requirements.txt

Next steps:

  1. Copy webxiang/ to webxiang/ and modify it to your needs.
  2. Optionally, run python compilemessages (if you have gettext installed).
  3. python collectstatic

Web Application Deployment

See for usual Django applications deployment.

Docker Deployment

[adjust files in the `run` folder]
docker-compose up

Tools -- generate albums from photo files.

$ tools/ --album-dir=albums/ ~/photos/vacation/ ~/webxiang/static/data/vacation
$ tools/ --help
next, adjust the generated vacation.yaml -- convert albums between different file formats (YAML, JSON).

$ tools/ 'albums/*.yaml' tmp/

Static Site Generator

$ tools/ ~/photos/vacation/ ~/tmp/vacation
$ tools/ --quick=~/tmp/vacation --copy
$ tools/ --help

Sample Galleries