app/README.md

ADM PURCHASING TOOLS

A browser-based control panel for the AdultDVDMarketplace automation bot.

What it does

• Opens a dashboard in your browser
• Lets you enter username, password, studio name or studio URL, and minimum price
• Starts the automation in the background
• Shows live logs and progress
• Lets you download the latest CSV when the run finishes

Quick start

Windows

1. Install Python 3 from https://www.python.org/downloads/
2. Double-click run_windows.bat
3. Your browser opens to http://localhost:5000
4. Enter your login details and studio
5. Click Start Bot
6. Watch the live logs and click Download Last CSV

The first launch installs the Python dependencies and Playwright Chromium, so it may take a few minutes.

Mac

1. Install Python 3 from https://www.python.org/downloads/
2. Double-click run_mac.command
3. Your browser opens to http://localhost:5000
4. Enter your login details and studio
5. Click Start Bot
6. Download the CSV when the job completes

The first launch installs the Python dependencies and Playwright Chromium, so it may take a few minutes.

Manual run

If you want to start it from a terminal:

python -m venv .venv
. .venv\Scripts\Activate.ps1
pip install -r requirements.txt
.venv\Scripts\playwright.exe install chromium
python web_app.py

Then open:

http://localhost:5000

Dashboard fields

• Username
• Password
• Studio Name or URL
• Minimum Price

Dashboard buttons

• Start Bot
• Stop Bot
• Download Last CSV
• Save Settings

CSV output

The exported CSV uses these columns:

• Title
• UPC
• Price
• Studio
• ScrapedAt

How it works

The web dashboard reuses the existing automation modules instead of replacing them:

• auth_handler.py handles login
• studio_navigator.py opens Top Studios, View All Studios, and the target studio
• listing_scraper.py scans the studio listing and paginates results
• product_scraper.py extracts product details
• services/exporter.py writes the CSV file

Saved settings

The dashboard can save the last entered values to config.json in the project folder.

Legacy CLI mode

The original command-line bot is still available through main.py.