wshot 1.0.2
Professional automated web screenshot tool for multiple devices - Visual auditing and responsive testing
Requires Python: >=3.8

# 📸 Wshot

Automated web screenshot tool for multiple devices. Perfect for visual audits, responsive testing, and web project documentation.

## 🚀 Quick Installation

### **Method 1: Standard Installation (Recommended)**
```bash
pip install wshot
playwright install chromium
```

### **Method 2: Isolated Installation (pipx)**
```bash
pipx install wshot
pipx inject wshot playwright requests
playwright install chromium
```

### **Verify Installation**
```bash
wshot --help
```

<details>
<summary>Install from source</summary>

```bash
pip install git+https://github.com/DanielMartinezSebastian/wshot.git
playwright install chromium
```
</details>

<details>
<summary>🔧 Installation Troubleshooting</summary>

**pipx users**: If you get dependency errors, inject the required packages:
```bash
pipx inject wshot playwright requests
```

**Virtual environments**: Always install in a virtual environment for isolation:
```bash
python -m venv wshot-env
source wshot-env/bin/activate  # Linux/Mac
# wshot-env\Scripts\activate     # Windows
pip install wshot
playwright install chromium
```
</details>

> Installation issues? See [DOCS.md](https://github.com/DanielMartinezSebastian/wshot/blob/main/DOCS.md#-detailed-installation) or [TROUBLESHOOTING.md](https://github.com/DanielMartinezSebastian/wshot/blob/main/TROUBLESHOOTING.md)

## ⚡ Basic Usage

```bash
# Capture on all devices
wshot https://example.com -all

# Specific device
wshot https://example.com --device mobile
wshot https://example.com --device desktop

# Super mode (recommended)
wshot https://example.com --super
```

> See all commands and options in [DOCS.md](https://github.com/DanielMartinezSebastian/wshot/blob/main/DOCS.md#️-complete-parameters-list)

## 📱 Main Devices

| Device | Dimensions | Usage |
|--------|------------|-------|
| `mobile` | 393×852 | iPhone 15 (mobile standard) |
| `tablet` | 768×1024 | iPad (tablet standard) |
| `laptop` | 1280×800 | 13" Laptop (standard) |
| `desktop` | 1920×1080 | Full HD Monitor (standard) |
| `desktop-4k` | 3840×2160 | 4K Professional Monitor |

> See complete list in [DEVICES.md](https://github.com/DanielMartinezSebastian/wshot/blob/main/DEVICES.md)

## 📂 Output Structure

```
~/Pictures/WSHOT/
└── example.com/
    ├── mobile/
    │   ├── example.com_mobile-20241005_142958.png
    │   └── example.com_mobile-complete-20241005_142958.png
    └── desktop/
        ├── example.com_desktop-20241005_142958.png
        └── example.com_desktop-complete-20241005_142958.png
```

## ⚙️ Main Options

```bash
# All devices
wshot https://example.com -all

# Specific device
wshot https://example.com --device mobile

# Super mode (recommended for complex sites)
wshot https://example.com --super

# Custom wait time
wshot https://example.com --device desktop --wait-time 5

# Auto-dismiss cookie banners
wshot https://example.com --device desktop --auto-dismiss

# Extract OpenGraph metadata
wshot https://example.com --device desktop --og

# Open file explorer when finished
wshot https://example.com --super --open
```

## 📖 Help

```bash
wshot --help      # Quick help
wshot --info      # Complete guide
```

## 📚 Documentation

- **[DOCS.md](https://github.com/DanielMartinezSebastian/wshot/blob/main/DOCS.md)** - Complete documentation and advanced features
- **[DEVICES.md](https://github.com/DanielMartinezSebastian/wshot/blob/main/DEVICES.md)** - Complete list of available devices
- **[TROUBLESHOOTING.md](https://github.com/DanielMartinezSebastian/wshot/blob/main/TROUBLESHOOTING.md)** - Common problem solutions
- **[ROADMAP.md](https://github.com/DanielMartinezSebastian/wshot/blob/main/ROADMAP.md)** - Project evolution and future plans

## 📄 License

MIT License - see [LICENSE](https://github.com/DanielMartinezSebastian/wshot/blob/main/LICENSE) for details.