Window Control¶

Pytonium provides a comprehensive set of methods for controlling the browser window's position, size, state, and appearance from Python.

Window Position¶

Getting the Position¶

x, y = p.get_window_position()
print(f"Window is at ({x}, {y})")

Returns a tuple[int, int] of the top-left corner coordinates in screen pixels.

Setting the Position¶

p.set_window_position(100, 200)

Moves the window so its top-left corner is at screen coordinates (100, 200).

Window Size¶

Getting the Size¶

width, height = p.get_window_size()
print(f"Window size: {width}x{height}")

Returns a tuple[int, int] of the window's width and height in pixels.

Setting the Size¶

p.set_window_size(1280, 720)

Resizing with an Anchor¶

resize_window() resizes the window while keeping a specific corner fixed.

p.resize_window(1920, 1080, anchor=0)

Window State¶

Minimize, Maximize, Restore¶

p.minimize_window()   # Minimize to taskbar
p.maximize_window()   # Maximize to fill screen
p.restore_window()    # Restore from maximized state

Checking Maximized State¶

if p.is_maximized():
    p.restore_window()
else:
    p.maximize_window()

Closing the Window¶

p.close_window()

Fullscreen¶

Pytonium supports true fullscreen mode (borderless, filling the entire monitor).

p.set_fullscreen(True)    # Enter fullscreen
p.set_fullscreen(False)   # Exit fullscreen
p.toggle_fullscreen()     # Toggle between states

if p.is_fullscreen():
    print("Currently in fullscreen")

Window Dragging¶

For frameless windows, drag_window() moves the window by a relative offset.

p.drag_window(delta_x=10, delta_y=5)

This is typically bound to JavaScript and driven by mouse events on a custom title bar. See the Frameless Windows guide for a complete example.

Native Window Handle¶

Get the OS-level window handle for advanced interop with native APIs.

hwnd = p.get_native_window_handle()
print(f"Window handle: {hwnd}")

Returns 0 if the browser is not initialized.

Parent Window¶

Set a parent window handle to create the browser as a child window.

# Create the browser as a child of another window
p.set_parent_window(parent_hwnd)
p.initialize("https://example.com", 800, 600)

# Clear parent (standalone mode)
p.set_parent_window(0)

Loading URLs¶

Navigate to a new URL after the browser is already initialized.

p.initialize("https://example.com", 800, 600)

# Later, navigate to a different page
p.load_url("https://example.org/dashboard")

Custom Icon¶

Set a custom window icon (appears in the title bar and taskbar).

p.set_custom_icon_path("./assets/icon.ico")
p.initialize("app://index.html", 800, 600)

Complete Example¶

import time
from Pytonium import Pytonium, returns_value_to_javascript

p = Pytonium()

@returns_value_to_javascript("object")
def get_position():
    x, y = p.get_window_position()
    return {"x": x, "y": y}

@returns_value_to_javascript("object")
def get_size():
    w, h = p.get_window_size()
    return {"width": w, "height": h}

def move_to(x: int, y: int):
    p.set_window_position(x, y)

def resize_to(width: int, height: int):
    p.set_window_size(width, height)

def center_window():
    # Simple centering on a 1920x1080 screen
    w, h = p.get_window_size()
    p.set_window_position((1920 - w) // 2, (1080 - h) // 2)

p.bind_function_to_javascript(get_position, javascript_object="win")
p.bind_function_to_javascript(get_size, javascript_object="win")
p.bind_function_to_javascript(move_to, javascript_object="win")
p.bind_function_to_javascript(resize_to, javascript_object="win")
p.bind_function_to_javascript(center_window, name="center", javascript_object="win")

p.add_custom_scheme("app", "./web/")
p.initialize("app://index.html", 800, 600)

while p.is_running():
    p.update_message_loop()
    time.sleep(0.016)

p.shutdown()

async function showWindowInfo() {
    const pos = await Pytonium.win.get_position();
    const size = await Pytonium.win.get_size();
    console.log(`Position: (${pos.x}, ${pos.y})`);
    console.log(`Size: ${size.width}x${size.height}`);
}

// Move window to top-left corner
Pytonium.win.move_to(0, 0);

// Resize to 1280x720
Pytonium.win.resize_to(1280, 720);

// Center on screen
Pytonium.win.center();

API Reference Summary¶

Pre-init = "Yes" means the method must be called before initialize().