Skip to main content

Retrieve Vimeo content and metadata

Project description


  • Retreive metadata such as viewcount, duration, author, title, likes, comments
  • Retrieve the URL to stream the video in a player such as vlc or mplayer
  • Small, standalone, single importable module file (
  • Select highest quality stream for download
  • Works with Python 2.6+ and 3.3+


vimeo can be installed using pip:

$ [sudo] pip install vimeo_dl

Usage Examples

Here is how to use the module in your own python code. For command line tool

>>> import vimeo_dl as vimeo

create a video instance from a Vimeo url:

>>> url = ""
>>> video =

get certain attributes:

>>> video.title
'[PHP][C++]Root Exploiter - No Back-Connect (Part 2)'

>>> video.viewcounts,, video.likes
(647, u'Mukarram Khalid', 0)

>>>, video.duration
('Mukarram Khalid', '10:00')

list available streams for a video:

>>> streams = video.streams
>>> for s in streams:
...     print(s)

Download video with specific stream number:

>>> streams[0].download(quiet=False)
163,840 Bytes [0.56%] received. Rate: [ 275 KB/s].  ETA: [104 secs]

get best resolution for a video:

>>> best = video.getbest()
>>> best.resolution, best.extension
('1162x720', 'mp4')

get url, for download or streaming in mplayer / vlc etc:

>>> best.url

Download video and show progress:

212,992 Bytes [2.64%] received. Rate: [ 203 KB/s].  ETA: [38 secs]

Release history Release notifications

This version
History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date (11.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page