This module allows to control a VLC instance using Python. This module uses the telnet interface of VLC and has no external dependencies.

More information about the telnet interface: http://wiki.videolan.org/Documentation:Streaming_HowTo/VLM

The clients supports some basic commands to modify playlists and control the playback.

First start VLC and enable the telnet interface. You can either enable it when starting VLC::

   $ vlc --intf telnet --telnet-password admin

or with network access:

    $ vlc --intf telnet --telnet-password admin --lua-config "telnet={host='0.0.0.0:4212'}"

or via the menus (depending on your platform, mostly View -> Add Interface -> Telnet).

Example usage::

>>> from vlcclient import VLCClient
>>> vlc = VLCClient("::1")
>>> vlc.connect()
>>>
>>> r.add("/home/mitch/Music/a_song.ogg")
>>> r.volume(300)
>>> r.rewind()
>>> r.status()
'( new input: file:///.... )
 ( audio volume: 200 )
 ( state playing )'

The following commands are currently implemented:

• help
• status
• info

• add
• enqueue
• seek
• play
• pause
• stop
• rewind
• next
• prev
• clear
• loop
• repeat
• random

• volume (get/set)
• volup
• voldown