Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.


castro is unavailable in PyPM, because there aren't any builds for it in the package repositories. Click the linked icons to find out why.

 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
Linux (64-bit)


Castro is a library for recording automated screencasts via a simple API.

Here's an example:

>>> from castro import Castro
>>> c = Castro()
>>> c.start()
>>> # Do something awesome!
>>> c.stop()


System Message: WARNING/2 (<string>, line 21)

Literal block expected; none found.
  1. Install and launch a vncserver. (Hint: Google it.)
  2. $ [sudo] easy_install castro
  3. There's no step 3!


$ python -c "import castro; castro.test()"


Video stored in: <default_temp_dir>/castro-video.swf

Video player stored in: <default_temp_dir>/castro-video.html


$ firefox /tmp/castro-video.html

License & Repository

Castro was created by Jason Huggins. It is licensed under the GPLv2, since it is a derivative work of pyvnc2swf, which is also licensed under the GPLv2.

Castro has a git respository at github.com.


Castro is a minor fork of pyvnc2swf, allowing one to use pyvnc2swf as a regular Python library, instead of a Tk GUI application or command line utility.

The specific improvement Castro brings to pyvnc2swf is the ability to start and stop recording programmatically via a simple Python API. Castro uses a file-based IPC to tell pyvnc2swf when to stop recording.

Ordinarily, pyvnc2swf's command line utility, vnc2swf.py, expects users to stop recording by manually typing "Control-C", sending a KeyboardInterrupt and allowing the process to exit cleanly. On Linux, emulating KeyboardInterrupt is simple enough to do by sending a SIGINT signal. But this does not work cross- platform, specifically on Windows. And a big reason for using pyvnc2swf is its ability to record vnc video on any platform from any platform.


  • Python - 2.5 or above
  • Pygame - 1.6 or above
  • PyYAML - 3.09 or above

Python < 2.6 dependencies:

  • Multiprocessing - 2.6.21 or above
  • Simplejson - 2.0.9 or above

Non-python dependencies (for cleaning/editing .flv videos):

  • flvtool2 (ruby gem)
  • ffmpeg


  • 1.0.4 - Added post-recording processing methods. (Depends on ffmpeg and flvtool2)
  • 1.0.3 - Switched from processing library to multiprocessing.

System Message: WARNING/2 (<string>, line 107)

Bullet list ends without a blank line; unexpected unindent.

Added support for changing recording framerate.

  • 1.0.2 - Made stop() block until the recording process is done

System Message: WARNING/2 (<string>, line 110)

Bullet list ends without a blank line; unexpected unindent.

Added support to use Castro in a with statement (e.g "with video(...):")

  • 1.0.1 - Fixed default vnc password path
  • 1.0 - First Release

Subscribe to package updates

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.