How shdwofm/vk-album-downloader works
VK Album Downloader is a local web app that accepts a VK access token and album link, downloads the album’s photos, and offers them as a ZIP. The main flow runs from the browser through job creation and background processing to ZIP download; status requests expose progress. Internal stages include URL parsing, VK photo listing, image retrieval, and in-memory ZIP assembly. The implementation is concentrated in app.py; index.html is identified by the tree and its role in serving the browser UI is documented, but its contents were not sampled.
Main entry points: app.py Download worker · index.html Browser UI
Components 13
Web interface
- Browser UI
index.html
Job handling
- API routes
app.py - Start job
app.py - Album URL parser
app.py - In-memory jobs
app.py - Job status
app.py - ZIP download
app.py
Album download
- Download worker
app.py - VK API
- Photo URLs
app.py - Image hosting
- ZIP archive
app.py
Other components
- User
Connections 15
- User → Browser UI: provides inputs
README.md - Browser UI → Start job: starts download
README.md - Browser UI → Job status: checks progress
README.md - Browser UI → ZIP download: saves ZIP
README.md - Start job → Album URL parser: parses link
app.py - Start job → In-memory jobs: creates job
app.py - Start job → Download worker: starts thread
app.py - Download worker → VK API: requests photos
app.py - Download worker → Photo URLs: collects URLs
app.py - Download worker → Image hosting: fetches images
app.py - Download worker → ZIP archive: assembles archive
app.py - Download worker → In-memory jobs: updates progress
app.py - Job status → In-memory jobs: reads progress
app.py - ZIP download → In-memory jobs: reads completed job
app.py - ZIP download → ZIP archive: serves archive
app.py