Sandbox

​

Sandbox

class Sandbox(SandboxBase)

​

create

@classmethod
def create(cls,
           template: Optional[str] = None,
           resolution: Optional[Tuple[int, int]] = None,
           dpi: Optional[int] = None,
           display: Optional[str] = None,
           timeout: Optional[int] = None,
           metadata: Optional[Dict[str, str]] = None,
           envs: Optional[Dict[str, str]] = None,
           secure: bool = True,
           allow_internet_access: bool = True,
           **opts: Unpack[ApiParams]) -> Self

• template: Sandbox template name or ID
• resolution: Startup the desktop with custom screen resolution. Defaults to (1024, 768)
• dpi: Startup the desktop with custom DPI. Defaults to 96
• display: Startup the desktop with custom display. Defaults to “:0”
• timeout: Timeout for the sandbox in seconds, default to 300 seconds. The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
• metadata: Custom metadata for the sandbox
• envs: Custom environment variables for the sandbox
• secure: Envd is secured with access token and cannot be used without it
• allow_internet_access: Allow sandbox to access the internet, defaults to True.

​

beta_create

@classmethod
def beta_create(cls,
                template: Optional[str] = None,
                resolution: Optional[Tuple[int, int]] = None,
                dpi: Optional[int] = None,
                display: Optional[str] = None,
                timeout: Optional[int] = None,
                auto_pause: Optional[bool] = False,
                metadata: Optional[Dict[str, str]] = None,
                envs: Optional[Dict[str, str]] = None,
                secure: bool = True,
                allow_internet_access: bool = True,
                **opts: Unpack[ApiParams]) -> Self

• template: Sandbox template name or ID
• resolution: Startup the desktop with custom screen resolution. Defaults to (1024, 768)
• dpi: Startup the desktop with custom DPI. Defaults to 96
• display: Startup the desktop with custom display. Defaults to “:0”
• timeout: Timeout for the sandbox in seconds, default to 300 seconds. The maximum time a sandbox can be kept alive is 24 hours (86_400 seconds) for Pro users and 1 hour (3_600 seconds) for Hobby users.
• auto_pause: Automatically pause the sandbox after the timeout expires. Defaults to False.
• metadata: Custom metadata for the sandbox
• envs: Custom environment variables for the sandbox
• secure: Envd is secured with access token and cannot be used without it
• allow_internet_access: Allow sandbox to access the internet, defaults to True.

​

screenshot

@overload
def screenshot(format: Literal["stream"]) -> Iterator[bytes]

​

screenshot

@overload
def screenshot(format: Literal["bytes"]) -> bytearray

​

screenshot

def screenshot(format: Literal["bytes", "stream"] = "bytes")

• format: The format of the screenshot. Can be ‘bytes’, ‘blob’, or ‘stream’.

​

left_click

def left_click(x: Optional[int] = None, y: Optional[int] = None)

​

double_click

def double_click(x: Optional[int] = None, y: Optional[int] = None)

​

middle_click

def middle_click(x: Optional[int] = None, y: Optional[int] = None)

​

scroll

def scroll(direction: Literal["up", "down"] = "down", amount: int = 1)

• direction: The direction to scroll. Can be “up” or “down”.
• amount: The amount to scroll.

​

move_mouse

def move_mouse(x: int, y: int)

• x: The x coordinate.
• y: The y coordinate.

​

mouse_press

def mouse_press(button: Literal["left", "right", "middle"] = "left")

​

mouse_release

def mouse_release(button: Literal["left", "right", "middle"] = "left")

​

get_cursor_position

def get_cursor_position() -> tuple[int, int]

• RuntimeError: If the cursor position cannot be determined

​

get_screen_size

def get_screen_size() -> tuple[int, int]

• RuntimeError: If the screen size cannot be determined

​

write

def write(text: str, *, chunk_size: int = 25, delay_in_ms: int = 75) -> None

• text: The text to write.
• chunk_size: The size of each chunk of text to write.
• delay_in_ms: The delay between each chunk of text.

​

press

def press(key: Union[str, list[str]])

• key: The key to press (e.g. “enter”, “space”, “backspace”, etc.).

​

drag

def drag(fr: tuple[int, int], to: tuple[int, int])

• from: The starting position.
• to: The ending position.

​

wait

def wait(ms: int)

• ms: The amount of time to wait in milliseconds.

​

open

def open(file_or_url: str)

• file_or_url: The file or URL to open.

​

get_current_window_id

def get_current_window_id() -> str

​

get_application_windows

def get_application_windows(application: str) -> list[str]

​

get_window_title

def get_window_title(window_id: str) -> str

​

launch

def launch(application: str, uri: Optional[str] = None)