Spaces:
Sleeping
Sleeping
| # 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`. | |