BlurShot API Documentation

import base64
import json
import urllib.parse
import webbrowser
from pathlib import Path

def sanitize_screenshot_with_blurshot(image_path: str, auto_open: bool = True) -> str:
    """
    Generate a BlurShot share URL for a local image file.

    Args:
        image_path: Path to the image file to sanitize
        auto_open: Whether to automatically open the URL in browser

    Returns:
        The BlurShot share URL

    Example:
        >>> sanitize_screenshot_with_blurshot('screenshot.png')
        'https://blurshot.io/#s=eyJpIjoiL...'
    """
    # Read and encode the image file
    image_file = Path(image_path)
    if not image_file.exists():
        raise FileNotFoundError(f"Image not found: {image_path}")

    # Read image as base64
    with open(image_file, 'rb') as f:
        image_data = base64.b64encode(f.read()).decode('utf-8')

    # Create share payload matching BlurShot's format
    share_state = {
        "i": image_data,              # Image data (base64)
        "n": image_file.name,         # Filename
        "c": 0                        # Edit count (0 for new)
    }

    # Encode and create share URL
    encoded = base64.b64encode(
        json.dumps(share_state).encode('utf-8')
    ).decode('utf-8')

    blurshot_url = f"https://blurshot.io/#s={urllib.parse.quote(encoded)}"

    if auto_open:
        webbrowser.open(blurshot_url)

    return blurshot_url


# Batch processing example
def batch_sanitize_screenshots(directory: str, pattern: str = "*.png"):
    """
    Process multiple screenshots in a directory.

    Example:
        >>> batch_sanitize_screenshots('./screenshots', '*.png')
    """
    screenshots_dir = Path(directory)
    results = []

    for image_file in screenshots_dir.glob(pattern):
        try:
            url = sanitize_screenshot_with_blurshot(
                str(image_file),
                auto_open=False
            )
            results.append({
                "file": image_file.name,
                "url": url,
                "status": "success"
            })
            print(f"✓ Generated URL for {image_file.name}")
        except Exception as e:
            results.append({
                "file": image_file.name,
                "error": str(e),
                "status": "failed"
            })
            print(f"✗ Failed to process {image_file.name}: {e}")

    # Save URLs to file for team distribution
    with open('blurshot_urls.json', 'w') as f:
        json.dump(results, f, indent=2)

    return results


if __name__ == "__main__":
    # Single screenshot example
    url = sanitize_screenshot_with_blurshot('bug-report-screenshot.png')
    print(f"BlurShot URL: {url}")

    # Batch processing example
    # batch_sanitize_screenshots('./support-tickets/', '*.png')