# 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:

```powershell
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:

```text
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`.