Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python client for

Project Description

This is a Python library that makes it even easier to talk the web service in order to connect to the PushScreen iPad app.


The code has been tested with Python 2.6 and 2.7.

Please use pip to install on your machine:

pip install pushscreen

Getting Started

First, open the iPad app and create a channel.

Then, in your Python code connect to that channel:

from pushscreen import Channel
channel = Channel("my-channel-name")

And with one more line you can send e.g. a URL to your device:

channel.push(type="url", url="")

Different types of pushs

You can push all types of content using the channel.push() method. Just set the type argument to either url, html or clear, and supply other parameters as keyword arguments.

channel.push(type="url", url="")
channel.push(type="html", html="<h1>Hello world</h1>")

Or use one of the following convenience methods:




channel.html("<h1>Hello world!</h1>")




For the url and html push types you may supply one or more of the following customization options:


By default the user will not be able to interact with the content on the iPad. To enable touch interaction (links, buttons, etc.), set this to True.

  • Type: bool
  • Default: False
  • Example: channel.url("", interactive=True)


If you want to make your content scrollable by the user, set this to True. Only useful if you also set interactive=True.

  • Type: bool
  • Default: False
  • Example: channel.url("", interactive=True, scrollable=True)


Set this to True if you want rubber-band scrolling on your content. Only make sense in combination with scrollable=True.

  • Type: bool
  • Default: False
  • Example: channel.url("", interactive=True, scrollable=True, bounces=True)


If you want the user to be able to use the pinch gestures to zoom the content, set this to True.

  • Type: bool
  • Default: False
  • Example: channel.url("", zoomable=True)


Execute some arbitrary JavaScript code in the context of the web page after it’s loaded.

  • Type: str
  • Default: ""
  • Example: channel.url("", javascript="alert('Hello world!');")


By default the pushed content will stay on screen until the user dismisses it or the next push arrives. If you want your content to disappear after a specific time, set the ttl parameter to the desired time in seconds.

  • Type: float
  • Default: -1 (do not disappear)
  • Example: channel.url("", ttl=5.0)
Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pushscreen-0.3.0.tar.gz (5.1 kB) Copy SHA256 Checksum SHA256 Source Aug 21, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting