How senhan07/v2ph works
Project type and purpose
• This is a CLI-driven, open-source Python “scraping” tool whose sole purpose is to log in to V2PH, iterate through model albums, pull out image URLs, and download the images.
• The README confirms it’s not a web service or full-stack app but a standalone script with these capabilities:
• Album URL scraping by model name
• Image URL extraction per album
• Image downloading via aria2c
• Account token management, headless Selenium automation, proxy support stub
File structure
Top-level:
• main.py – the entry-point CLI orchestrator
• requirements.txt – dependency list (Selenium, requests, etc.)
• accounts/ – JSON files representing login credentials & token state
• albums_url/ – output folder for scraped album URLs
module/ package:
• driver.py – Selenium WebDriver wrapper (Chrome headless toggles)
• proxy.py – stub for proxy support
• login.py, create_accounts.py, history.py – account lifecycle & token reset
• scrape_album.py – fetches album page URLs by model name
• get_image.py – visits album pages to extract image URLs
• download_image.py – invokes aria2c or HTTP download logic
• user.py – parses CLI arguments and routes commands
Extract architecture hints from the README
• Token-bucket style account rotation: track “last login” and “tokens left” in JSON
• Sequential pipeline: album → image URL → download
• External dependencies: V2PH website, ChromeDriver, aria2c utility
Detail is critical
• Module separately rather than lumping them together
• File storage locations and formats
• Retry/account-rotation loops in the Account Manager