{"id":5452921,"url":"https://github.com/yashrathi-git/vimeo-dl","last_synced_at":"2026-01-16T03:19:31.156Z","repository":{"id":39712681,"uuid":"333385521","full_name":"yashrathi-git/vimeo-dl","owner":"yashrathi-git","description":"Downloads Vimeo videos and retrieve metadata such as views, likes, comments, duration of the video.","archived":false,"fork":false,"pushed_at":"2023-03-08T14:04:44.000Z","size":142,"stargazers_count":70,"open_issues_count":12,"forks_count":18,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-05T21:07:33.485Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yashrathi-git.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-01-27T10:36:25.000Z","updated_at":"2025-05-07T00:27:51.000Z","dependencies_parsed_at":"2024-03-01T16:09:15.931Z","dependency_job_id":"bbf0c13b-c6ac-4c7b-995d-adc552971ec3","html_url":"https://github.com/yashrathi-git/vimeo-dl","commit_stats":{"total_commits":69,"total_committers":3,"mean_commits":23.0,"dds":"0.10144927536231885","last_synced_commit":"84b37cb36c2c894ba7df8284083cd13333d9e045"},"previous_names":["yashrathi-git/vimeo-dl","yashrathi-git/vimeo_downloader"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/yashrathi-git/vimeo-dl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashrathi-git%2Fvimeo-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashrathi-git%2Fvimeo-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashrathi-git%2Fvimeo-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashrathi-git%2Fvimeo-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashrathi-git","download_url":"https://codeload.github.com/yashrathi-git/vimeo-dl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashrathi-git%2Fvimeo-dl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28477138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T03:13:13.607Z","status":"ssl_error","status_checked_at":"2026-01-16T03:11:47.863Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-03-01T16:03:33.397Z","updated_at":"2026-01-16T03:19:31.141Z","avatar_url":"https://github.com/yashrathi-git.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Vimeo Downloader  \u003c!-- omit in toc --\u003e\n\n[![PyPI](https://img.shields.io/pypi/v/vimeo_downloader?color=blue)](https://pypi.org/project/vimeo-downloader/)\n![PyPI - License](https://img.shields.io/pypi/l/vimeo_downloader?color=blue)\n\nDownloads Vimeo videos and retrieve metadata such as views, likes, comments, duration of the video.\n\n* [Features](#features)\n* [Installation](#installation)\n* [Usage](#usage)\n    - [Metadata](#metadata)\n    - [Download video](#download-video)\n    - [Download embed only videos](#downloading-embed-only-videos)\n    - [Downloading videos that require login](#downloading-videos-that-require-login)\n    - [Download with video ID](#download-video-with-video-id)\n* [Examples](#examples)\n\n# Features\n\n* Easy to use and friendly API.\n* Support for downloading private or embed only Vimeo videos.\n* Retrieve direct(.mp4 file) URL for the video.\n* Uses type-hints for better editor autocompletion\n* Retrieve metadata such as views, likes, comments, duration of the video\n* Tested for python 3.6 and above\n\n# Installation\n\n```bash\npip install vimeo_downloader\n```\n\nor download the latest version:\n\n```bash\npip install git+https://github.com/yashrathi-git/vimeo_downloader\n```\n\n# Usage\n\n```python\n\u003e\u003e from vimeo_downloader import Vimeo\n\u003e\u003e v = Vimeo('https://vimeo.com/503166067')\n```\n\n## Metadata\n\n```python\n\u003e\u003e meta = v.metadata\n\u003e\u003e meta.title\n\"We Don't Have To Know - Keli Holiday\"\n\u003e\u003e meta.likes\n214\n\u003e\u003e meta.views\n8039\n\u003e\u003e meta._fields  # List of all meta data fields\n('id', 'title', 'description'...)  # Truncated for readability\n```\n\n## Download video\n\n```python\n\u003e\u003e s = v.streams\n\u003e\u003e s\n[Stream(240p), Stream(360\np), Stream(540\np), Stream(720\np), Stream(1080\np)]\n\u003e\u003e best_stream = s[-1]  # Select the best stream\n\u003e\u003e best_stream.filesize\n'166.589421 MB'\n\u003e\u003e best_stream.direct_url\n'https://vod-progressive.akamaized.net.../2298326263.mp4'\n\u003e\u003e best_stream.download(download_directory='DirectoryName',\n                        filename='FileName')\n# Download video with progress bar and other information,\n# to disable this behaviour use mute=True\n```\n\n## Downloading embed only videos\n\n```python\n\u003e\u003e from vimeo_downloader import Vimeo\n\u003e\u003e v = Vimeo('https://player.vimeo.com/video/498617513',\n             embedded_on='https://atpstar.com/plans-162.html') \n```\n\nFor embed only videos, also provide embedded_on parameter to specify the URL on which video is embedded without query\nparameters.\n\n```python\n\u003e\u003e v.streams\n[Stream(240p), Stream(360\np), Stream(540\np), Stream(720\np), Stream(1080\np)]\n\u003e\u003e v.streams[-1].download(download_directory='DirectoryName',\n                          filename='FileName')\n# Downloads the best stream with progress bar and other information, \n# to disable this behaviour use mute=True\n```\n\n## Downloading videos that require login\n\n**It uses cookie to authenticate. You could get cookie like this:**\n\nWhile logged into your account, go to the video URL. Press Command + Shift + C or Control + Shift + C to get to\ndeveloper tools. Go to network tab and reload the page. You would see all requests that were made. Click on the top\none (request made to same URL you're on) and scroll down to \"Request Headers\", there you would find cookie parameter,\ncopy its value.\n\n```python\nfrom vimeo_downloader import Vimeo\n\ncookies = \"\"\"\n    cookie\n \"\"\".strip()\n\nv = Vimeo(\n    url=\"URL\",\n    cookies=cookies,\n)\n\nbest_stream = v.best_stream\nmp4_url = best_stream.direct_url\n\ntitle = best_stream.title\n\n## Download\nbest_stream.download()\n```\n\n## Download video with video ID\n\n(New in 0.3.2)\nIf the above methods, don't work it, you would most likely be able to download video using its vimeo video ID.\n\n```python\nfrom vimeo_downloader import Vimeo\n\n# url: https://vimeo.com/79761619\n# video ID: '79761619'\nv = Vimeo.from_video_id(video_id='79761619')\n```\n\n# Examples\n\n## 1. Downloading embed only videos\n\n`embedded_on` is the URL of site video is embedded on without query parameters.\n\n```python\nfrom vimeo_downloader import Vimeo\n\n# Replace these two variables to different URL to download that video\nvimeo_url = 'https://player.vimeo.com/video/498617513'\nembedded_on = 'https://atpstar.com/plans-162.html'\n# embedded_on is  the URL of site video is embedded on without query parameters.\n\nv = Vimeo(vimeo_url, embedded_on)\n\nstream = v.streams  # List of available streams of different quality\n# \u003e\u003e [Stream(240p), Stream(360p), Stream(540p), Stream(720p), Stream(1080p)]\n\n# Download best stream\nstream[-1].download(download_directory='video', filename='test_stream')\n\n# Download video of particular quality, example '540p'\nfor s in stream:\n    if s.quality == '540p':\n        s.download(download_directory='video', filename='test_stream')\n        break\nelse:  # If loop never breaks\n    print(\"Quality not found\")\n```\n\n## 2. Downloading a list of videos\n\n```python\nfrom vimeo_downloader import Vimeo\n\n# Replace these with other list of videos you want to download\nvideos = ['https://vimeo.com/440801455',\n          'https://vimeo.com/504420495',\n          'https://vimeo.com/481277944']\n\nfor video in videos:\n    v = Vimeo(video)\n    stream = v.streams  # List of available streams of different quality\n\n    # Selecting and downloading '720p' video\n    for s in stream:\n        if s.quality == '720p':\n            s.download(download_directory='video', filename=v.metadata.title)\n            break\n    else:  # If the loop never break\n        print('quality not found')\n```\n\n# License\n\nDistributed under the MIT licence. Read `LICENSE` for more information\nhttps://github.com/yashrathi-git/vimeo_downloader/blob/main/LICENCE\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashrathi-git%2Fvimeo-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashrathi-git%2Fvimeo-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashrathi-git%2Fvimeo-dl/lists"}