gslide

CLI tool for automating Google Slides' "Help me visualize" feature via browser automation. Generate slides, infographics, and images from the command line using Gemini's built-in generation capabilities.

Prerequisites

• Node.js >= 16
• A Google account with access to Google Slides

Installation

npm install -g @champpaba/gslide

The postinstall script automatically sets up:

• uv (installed if not found)
• Python 3.10+ (installed via uv if not found)
• A virtual environment with the gslide Python package
• Chromium browser (via Playwright)

Getting Started

1. Log in to Google

gslide auth login

This opens a Chromium browser for you to sign in to your Google account. The session is saved locally as a persistent Chromium profile (~/.gslide/profile) and reused on future runs, so Google's rotating session cookies stay fresh.

2. Check auth status

gslide auth status

3. Generate content

Single slide:

gslide gen slide --presentation <ID_OR_URL> --prompt "Timeline of the Apollo program"

Single infographic:

gslide gen infographic --presentation <ID_OR_URL> --prompt "Key metrics for Q1 2026"

Image on a specific slide:

gslide gen image --presentation <ID_OR_URL> --prompt "A futuristic cityscape" \
  --slide-index 2 --insert-as image

--insert-as can be image (default) or background.

4. Batch generation

Create a prompts.json file:

{
  "presentation_id": "your-presentation-id",
  "slides": [
    { "tab": "slide", "prompt": "Introduction to machine learning" },
    { "tab": "infographic", "prompt": "ML model comparison chart" }
  ],
  "images": [
    { "prompt": "Neural network diagram", "slide_index": 1, "insert_as": "image" }
  ]
}

Preview what will be generated:

gslide gen batch --file prompts.json --dry-run

Run the batch:

gslide gen batch --file prompts.json --continue-on-error

Commands

Command	Description
gslide auth login	Launch browser for Google login
gslide auth status	Check if saved session is valid
gslide auth logout	Delete saved session
gslide gen slide	Generate a slide
gslide gen infographic	Generate an infographic
gslide gen image	Generate and insert an image
gslide gen batch	Generate from a prompts.json file
gslide update	Update to the latest version

How It Works

gslide uses Playwright to automate the Google Slides web interface. It interacts with the "Help me visualize" panel (powered by Gemini) to generate slides, infographics, and images based on your text prompts. Generation typically takes 30–60 seconds per item.

License

MIT