Skip to main content

​
Take Screenshots with Narada SDK

The Narada Python SDK makes it easy to capture screenshots of web pages during automation tasks. When you ask Narada to take a screenshot, it automatically saves the image to your local Downloads folder with a timestamped filename for easy organization.

​
How to Take Screenshots with the SDK

1

Basic Screenshot Capture

Use the SDK to capture screenshots with a simple command:
import asyncio
from narada import Narada

async def main() -> None:
    async with Narada() as narada:
        window = await narada.open_and_initialize_browser_window()

        # Take a screenshot of the current page
        response = await window.agent(
            prompt='take a screenshot of this page'
        )

        print("Screenshot captured!")
        print("Response:", response.text)

if __name__ == "__main__":
    asyncio.run(main())
The SDK automatically handles screenshot capture and file organization for you.
2

Automatic Directory Creation

Narada automatically creates a directory structure for your screenshots:
  1. Main Directory: Narada Downloads in your machine’s Downloads folder
  2. Request Directory: Directory named after your request_id from the SDK response
  3. File: Screenshot saved as a .jpeg file with timestamp
If the Narada Downloads directory doesn’t exist, it will be created automatically.
3

Find Your Screenshot File

Navigate to your Downloads folder and look for:
Downloads/
└── Narada Downloads/
    └── req_abc123def456/
        └── save-screenshot-20250828232853.jpeg
Each screenshot request gets its own directory named after the request_id for easy correlation with your SDK calls. The screenshot file is automatically named with a timestamp for unique identification.

​
Screenshot Organization

JPEG Format

All screenshots are saved as JPEG files for optimal file size and universal compatibility.

Request Correlation

Each screenshot directory is named after the request_id from the SDK response, allowing you to easily track which SDK request generated which files.

Timestamp Naming

Screenshots are automatically named with timestamps (e.g., save-screenshot-20250828232853.jpeg) to prevent filename conflicts and maintain chronological order.

​
Example Use Cases

  • Documentation: Capture screenshots of web interfaces for user guides
  • Quality Assurance: Take screenshots during automated testing workflows
  • Monitoring: Capture visual evidence of web page states
  • Reporting: Include screenshots in automated reports and summaries
  • Debugging: Visual documentation of automation steps and results
You can take a screenshot of any page that’s currently visible in your browser. The screenshot captures the full viewport at the time of capture.

​
Next Steps

Learn about other Narada SDK capabilities: