skip to navigation
skip to content

DesktopStreamer 0.6.1

Capture A/V from the desktop and stream it to the local network.

Latest Version: 0.7

Capture audio and video from the desktop and stream it to the local network using avconv and vlc.

Python Script

You can just run the python module and - if you install this package - you could also start the provided script from the console or your desktop shell.


Start the package like this python -m desktopstreamer [options]. Or use the startup script like this:

stream_desktop [-n|--gui] [-a|-A] [capture options] [stream options]
stream_desktop --version
stream_desktop --help

To use it in your desktop shell, a .desktop file is provided.


The easiest way to install this package is trough pip:

pip install --user desktopstreamer

Or download the latest source (or get it trough git) and install it like this (from the sources root directory):

python install --user


You don’t need to install any Python dependencies.


avconv and vlc are required though. Install them like this:

  • Debian / Ubuntu: sudo apt-get install libav-tools vlc


You can use the provided .desktop files to start the script from your desktop shell.


You can use a file to store the settings in a JSON dictionary.

The default location is ~/.config/DesktopStreamer/settings.json. The supported keys are the capture and stream long-options (with _ instead of -).

  "port": 420,
  "res_out": "1280x720"

You can create and edit it manually. If you use the --save option, the current settings are stored automatically (previous settings get overwritten).

The settings from this file are applied, if you use the --load option.


The provided .desktop file uses it.

Shell Script

You can source the from the misc/ directory in your .bash_aliases or similar to get a quick stream_desktop command. The python script has more options though.

File Type Py Version Uploaded on Size
DesktopStreamer-0.6.1.tar.gz (md5) Source 2014-04-18 27KB