Difference between revisions of "Python bindings"

From VideoLAN Wiki
Jump to navigation Jump to search
(2nd try)
Line 7: Line 7:
  
 
The new module features :
 
The new module features :
* a complete cover of the libvlc/MediaControl API, since it is automatically generated from the include files.
+
* a complete cover of the libvlc API, since it is automatically generated from the include files.
 
* no compilation hassle: the generated module is pure python.
 
* no compilation hassle: the generated module is pure python.
 
* no versioning hassle: the same module works with multiple VLC versions.
 
* no versioning hassle: the same module works with multiple VLC versions.

Revision as of 13:46, 7 May 2010

Python bindings

You can find two versions of python bindings: an old one (see Old Python bindings), hand-written C-module, and a new one, which is ctypes-based and automatically generated. The old version of the bindings is now deprecated and will be removed in some future version.

Features

The new module features :

  • a complete cover of the libvlc API, since it is automatically generated from the include files.
  • no compilation hassle: the generated module is pure python.
  • no versioning hassle: the same module works with multiple VLC versions.
  • a complete documentation.

Download

You can download the vlc.py module from the Advene website. It only depends on ctypes (standard module in python >= 2.5). Put the module in some place accessible by python (either next to your application, or in a directory from sys.path).

Alternatively, you can generate it by yourself using the generate.py program and accompanying files in the vlc source tree (see [1]).

Usage

The vlc.py module is also a runnable example player application (see code at the end of the module, starting from the line "if __name__ == '__main__'). A helper module vlcwidget.py provides a pygtk VLCWidget() to ease integration.