AstPhotos

A static single-page photo gallery website generator

The README file is still under construction…

Get started

Interactive Editor

The new Interactive Editor is now available!

1. Run command astphoto.py editor
2. Open the browser and go to http://localhost:81
3. Create albums, add photos, modify photos’ metadata easily!

CLI

1. astphoto.py init Astphoto ( you can replace “Astphoto” to the name you like )
2. astphoto.py create album "My Family"
3. Copy your photos/images to img/my_family/
4. astphoto.py gen
5. You will get the complied static files under complied/! You can put them into your static website host and enjoy it!

Configure

Directory Structure:

img
├── _site.json
├── about.md
└── Album_A
    ├── _album.json
    ├── A.jpg
    ├── B.jpg
    ├── C.jpg
    └── ...

• Edit config_overridde.py file base on config_default.py
• Create /img/_site.json, write and save:

{
  "title": "anthony.f",
  "des": "photography",
  "me": "anthony",
  "me_link": "https://antnf.com"
}

• Create /img/[album_name]/_album.json, write and save:

{
  "name": "Family",
  "des": "My family and I.",
  "photographer": "anthony.f",
  "location": "Hangzhou",
  "cover": "13.jpg",
  "photo_orderby": "shuffle"
}

• Regenerate the website

Todos

• CLI

  • init [name]
  • gen -static -index
  • clear
  • album [new|modify] [name]
  • host
  • Interaction json generator

• Generator

  • Use EXIF-Thumbail to calc default color ~~Use EXIF-Thumbail to calc default color~~ Use random samples (for better performance)
  • Folder copy
  • Windows Unicode support
  • Template/theme support
  • Minify
  • Markdown
  • Overview
  • Thumbails
  • Backgound set
  • About portrait
  • Photographer links dictionrary
  • Source->Target filepath table
  • Image data's cache
  • ProgessBar / Logs
  • Imporve infodict
  • Logo support
  • Auto create root folder if not exists

• Template

  • Javascripts decoupling
  • Hash Router
  • Horizontal / Vertical view auto switch
  • Photo details toggle

• Interactive Metadata Editor

  • Metadata Edit
  • Photo uploading
  • Upload progress bar
  • New album
  • Update after uploads
  • Reconsider UI
  • Configure settings in Editor