Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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 History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date (11.7 kB) Copy SHA256 Checksum SHA256 Source Aug 10, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting