woob video

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 woob video

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


You can run woob video 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:

$ woob video
Welcome to woob video

Copyright(C) 2010-2021 The woob 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:

woob video>

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 woob video, 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


video> search PATTERN


video> 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 flic.mov (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


video> info <# or ID or URL>

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

video> info 1
id: 6Cvj6NRpTXo@youtube
title: Coluche - Les Flics
url: http://www.youtube.com/get_video?video_id=6Cvj6NRpTXo&t=vjVQa1PpcFPjKzpoPFHRI3oAtjzNxmC5NkNYPQ2R6jg%3D&eurl=&el=&ps=&asv=&fmt=18
author: Melaaz
duration: 0:07:57
thumbnail: http://i.ytimg.com/vi/6Cvj6NRpTXo/2.jpg
nsfw: False

You can also use it in this way:

video> info "http://www.youtube.com/watch?v=JXb8V_8l41w"
video> info JXb8V_8l41w@youtube

Play a video

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

video> play 1
Invoking "mplayer http://www.youtube.com/get_video?video_id=6Cvj6NRpTXo&t=vjVQa1PpcFPjKzpoPFHRI3oAtjzNxmC5NkNYPQ2R6jg%3D&eurl=&el=&ps=&asv=&fmt=18".

Download a video

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

video> download 1

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

$ woob video download 9892834@dailymotion video.mp4
--2011-03-21 15:47:36--  http://www.dailymotion.com/cdn/H264-512x384/video/x5w1cy_bassist_music.mp4?auth=1300891656-7e55974c5de78f52843324636480ff96
Resolving www.dailymotion.com...,,
Connecting to www.dailymotion.com||:80... connected.
HTTP request sent, awaiting response... 302 Found
Location: http://proxy-61.dailymotion.com/video/438/298/9892834_mp4_h264_aac.mp4?auth=1300726056-32528c09733568744a9010672425da55&cache=0 [following]
--2011-03-21 15:47:36--  http://proxy-61.dailymotion.com/video/438/298/9892834_mp4_h264_aac.mp4?auth=1300726056-32528c09733568744a9010672425da55&cache=0
Resolving proxy-61.dailymotion.com...
Connecting to proxy-61.dailymotion.com||: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 woob video instead of your browser:

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