Skip to main content

A small application to play or download videos from various YouTube-like sites.

Project description

Project page:



GNU Affero General Public License v3+


WatchVideo is an application to watch videos from many popular Flash based sites using an external player, builtin VLC or download them.


For both GUI and CLI interface:

  • Python 2.6, 2.7, 3.1 or later

  • GetMediumURL 0.0a2 or later

  • Distribute (python-setuptools)

The installation script will automatically install GetMediumURL if it is not available. It requires lxml which should be installed from distribution package before (in Debian-based GNU/Linux distributions it is named python-lxml).

For GUI only:

  • PyQt4 (python-qt4) or PySide

  • VLC version 1.1 (optional, required for built-in player)

  • python-notify (optional) – uses the system’s default mechanism to show notification messages

  • FFmpeg (optional) – needed for all operations related with video conversion, ripping or the built-in player.

  • FFmpeg2theora (optional) – needed to convert videos to Ogg Vorbis or Theora, but not for ripping audio

If you downloaded through Subversion:

  • pyqt4-dev-tools (pylupdate4, pyrcc4, pyuic4)

  • libqt4-dev (lrelease)

  • Inkscape

  • OptiPNG (optional)

  • docutils

PyQt4 is used by default. When it is not found, PySide is used but there are known bugs when using it. Set the environment variable WATCHVIDEO_QT to a space-separated sequence of package names tried to use a different package (e.g. WATCHVIDEO_QT=PySide to use PySide on systems where PyQt4 is installed).

Installation using easy_install

Use easy_install -U WatchVideo to install the newest release of WatchVideo. Optional dependencies should be installed separately.

Installation from source

Open terminal in the directory with this file and type sudo make install.

These options (specified after make) can be used to change the installation directory:


default is /usr/local


default is $prefix/share

Unless the prefix is changed, root priviledges are needed for installation.

To use different Python interpreter than the one found by the python command, specify it as the PYTHON variable.

You can instead call python install with options described by python --help install and optionally install menu entry and icon by make install-data.


If installed

There should be an entry in your menu under the Audio and Video section.

If not or if you prefer, you can call the app with the command:

qtwatchvideo URL1 URL2 ...

or simply:


If you want to use the CLI version:

watchvideo [OPTIONS] URL1 URL2 ...

Run watchvideo --help to see all options of the CLI version.

If not installed

Running python develop --user with put scripts needed to run WatchVideo in $HOME/.local/bin, and use other file from the directory where the source is located. You might use the programs as ~/.local/bin/qtwatchvideo and similarly watchvideo, or write

export PATH=$HOME/.local/bin:$PATH

before to use them like when installed.

Updating plugins

WatchVideo uses a package called GetMediumURL to get the information from the video-sharing websites. Some of these sites often change their interfaces, so it won’t find the video. In this case try to update GetMediumURL, by doing the following in a terminal: easy_install -U GetMediumURL or using your distribution packages for it.


If you wish to translate this application, do the following:

  1. Open a terminal in the source distribution directory.

  2. Do make check-dependencies to see if you have the necessary dependencies.

  3. Add a reference for your language to L10N in the Makefile.

  4. Do make to generate the necessary files.

  5. Translate the .ts file generated in the po subdirectory. You can use Qt Linguist or any text editor of your choice.

  6. When you’re ready to test your translation, do make again.

Project details

Download files

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

Source Distribution

WatchVideo-2.2.tar.gz (568.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page