Videoob is a console application able to search for videos on supported websites and to get direct URLs for videos, download them or play them.

It supports the following websites:

Get Videoob

This application is part of Weboob. To install it, please read this page.


You can run Videoob without any parameter to get an interactive prompt, or specify a command to run it directly and exit just after.

In this page we will use the interactive mode:

$ videoob
Welcome to videoob

Copyright(C) 2010-2017 The Weboob Team
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3 of the License.

Type "help" to display available commands.

Loaded backends:


Use the help command to see what are the available commands.

For more information about common options of console applications, read this documentation.

The first time you launch videoob, it will ask you what backends you want to add and configure. You can also use the backends command to manage them, and to enable only specific backends.

Looking for a video


videoob> search PATTERN


videoob> search coluche flics
Search pattern: coluche flics
* (1) Coluche - Les Flics (youtube)
* (2) Coluche Intégral CD 1 - 12 / Le flic (youtube)
* (3) Coluche le flic (youtube)
* (4) COLUCHE L'INTEGRAL - Le (youtube)
* (5) Coluche - C'est l'histoire d'un mec (youtube)
* (6) Beaucoup de flics pour rien.wmv (youtube)
* (7) Pinot simple flic pour Cortex - Zen for Z'anes (youtube)
* (8) A 2 pas du Perih - Sinik (youtube)

Get information about a video


videoob> info <# or ID or URL>

For example, you can use the number shown in the previous search result:

videoob> info 1
id: 6Cvj6NRpTXo@youtube
title: Coluche - Les Flics
author: Melaaz
duration: 0:07:57
nsfw: False

You can also use it in this way:

videoob> info ""
videoob> info JXb8V_8l41w@youtube

Play a video

You can also play a video by using the command play instead of info:

videoob> play 1
Invoking "mplayer".

Download a video

If you want to download a video, just use the download command:

videoob> download 1

It’s possible to provide the destination filename of the video:

$ videoob download 9892834@dailymotion video.mp4
--2011-03-21 15:47:36--
Connecting to||:80... connected.
HTTP request sent, awaiting response... 302 Found
Location: [following]
--2011-03-21 15:47:36--
Connecting to||:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 764225 (746K) [video/mp4]
Saving to: “video.mp4”

100%[====================================================================>] 764,225     2.45M/s   in 0.3s

2011-03-21 15:47:36 (2.45 MB/s) - “video.mp4” saved [764225/764225]

Use cases

Tip for rxvt-unicode users

You can use this config lines to make rxvt-unicode launch urls in videoob instead of your browser:

urxvt.matcher.pattern.1: (?:http://)?(?:www\\.)?youtube\\.com/watch\\?v=([^&]*)
urxvt.matcher.launcher.1: videoob play $1@youtube
urxvt.matcher.pattern.2: (?:http://)?(?:www\\.)?youporn\\.com/watch/([^/]*)
urxvt.matcher.launcher.2: videoob play $1@youporn
urxvt.matcher.pattern.3: (?:http://)?(?:www\\.)?*vid=([^&]*)
urxvt.matcher.launcher.3: videoob play $1@canalplus
urxvt.matcher.pattern.4: (?:http://)?(?:www\\.)?videos\\.arte\\.tv/.*/([^.]*)\\.html
urxvt.matcher.launcher.4: videoob play $1@arte
urxvt.matcher.pattern.5: (?:http://)?(?:www\\.)?*)/video/(.*)\\.html
urxvt.matcher.launcher.5: videoob play $1\/$2@ina
urxvt.matcher.pattern.6: (?:http://)?(?:www\\.)?youjizz\\.com/.*/([^.]*)\\.html
urxvt.matcher.launcher.6: videoob play $1@youjizz