Skip to main content
Read and write clipboard content for desktop automation. Clipboard operations enable copying and pasting data between applications.

​
Overview

Clipboard operations enable:
  • Reading clipboard content
  • Setting clipboard content
  • Accessing clipboard history
  • Copying data between applications
Desktop automation requires a template with desktop support. Ensure your sandbox has desktop capabilities enabled.

​
Getting Clipboard Content

Read the current clipboard content:
  • Python
  • JavaScript
from hopx_ai import Sandbox

sandbox = Sandbox.create(template="desktop")

# Get clipboard content
text = sandbox.desktop.get_clipboard()
print(f"Clipboard: {text}")

​
Setting Clipboard Content

Set clipboard content:
  • Python
  • JavaScript
# Set clipboard content
sandbox.desktop.set_clipboard("Hello from clipboard!")

# Verify
text = sandbox.desktop.get_clipboard()
print(text)  # "Hello from clipboard!"

​
Clipboard History

Get clipboard history (if supported):
  • Python
  • JavaScript
# Get clipboard history
history = sandbox.desktop.get_clipboard_history()

for item in history:
    print(f"History item: {item}")

​
Copy-Paste Workflow

Complete copy-paste automation:
  • Python
  • JavaScript
from hopx_ai import Sandbox

sandbox = Sandbox.create(template="desktop")

try:
    # Select text (using mouse/keyboard)
    sandbox.desktop.click(100, 100)
    sandbox.desktop.drag(100, 100, 300, 100)
    
    # Copy (Ctrl+C)
    sandbox.desktop.combination(['ctrl'], 'c')
    
    # Get copied text
    copied_text = sandbox.desktop.get_clipboard()
    print(f"Copied: {copied_text}")
    
    # Click elsewhere
    sandbox.desktop.click(500, 300)
    
    # Paste (Ctrl+V)
    sandbox.desktop.combination(['ctrl'], 'v')
    
finally:
    sandbox.kill()

​
Programmatic Copy-Paste

Set clipboard programmatically and paste:
  • Python
  • JavaScript
# Set clipboard programmatically
sandbox.desktop.set_clipboard("Programmatic clipboard content")

# Click in target application
sandbox.desktop.click(400, 300)

# Paste
sandbox.desktop.combination(['ctrl'], 'v')

​
Next Steps