https://github.com/akiomik/vimeo-dl
A cli tool to download private videos on vimeo. Written in golang.
https://github.com/akiomik/vimeo-dl
download-videos downloader video-downloader vimeo vimeo-downloader
Last synced: about 1 month ago
JSON representation
A cli tool to download private videos on vimeo. Written in golang.
- Host: GitHub
- URL: https://github.com/akiomik/vimeo-dl
- Owner: akiomik
- License: apache-2.0
- Created: 2020-07-26T19:24:56.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-02-18T00:48:16.000Z (4 months ago)
- Last Synced: 2025-03-26T08:06:59.200Z (3 months ago)
- Topics: download-videos, downloader, video-downloader, vimeo, vimeo-downloader
- Language: Go
- Homepage:
- Size: 119 KB
- Stars: 290
- Watchers: 5
- Forks: 41
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
vimeo-dl
========
[](https://github.com/akiomik/vimeo-dl/actions/workflows/go.yml)
A tool to download private videos on vimeo.
## Usage
```sh
vimeo-dl --combine -i ${MASTER_JSON_URL}
```
## Advanced Usage
```sh
# Download a video as ${clip_id}-video.mp4 (1080p).
# The highest resolution is automatically selected.
vimeo-dl -i "https://skyfire.vimeocdn.com/xxx/yyy/live-archive/video/240p,360p,540p,720p,1080p/master.json?base64_init=1&query_string_ranges=1"
```
```sh
# Download a video as ${clip_id}-video.mp4 (720p) with the specified user-agent.
vimeo-dl -i "https://skyfire.vimeocdn.com/xxx/yyy/live-archive/video/240p,360p,540p,720p,1080p/master.json?base64_init=1&query_string_ranges=1" \
--video-id "720p" \
--user-agent "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.89 Safari/537.36"
```
```sh
# Download a video as ${clip_id}.mp4.
vimeo-dl -i "https://8vod-adaptive.akamaized.net/xxx/yyy/sep/video/9f88d1ff,b83d0f9d,da44206b,f34fd50d,f9ebc26f/master.json?base64_init=1" \
--video-id "b83d0f9d" \
--audio-id "b83d0f9d" \
--combine
# Download a video as my-video-file-name.mp4.
vimeo-dl -i "https://8vod-adaptive.akamaized.net/xxx/yyy/sep/video/9f88d1ff,b83d0f9d,da44206b,f34fd50d,f9ebc26f/master.json?base64_init=1" \
--video-id "b83d0f9d" \
--audio-id "b83d0f9d" \
--combine \
--output-file-name "my-video-file-name"
# The combine option is equivalent to the following command.
vimeo-dl -i "https://8vod-adaptive.akamaized.net/xxx/yyy/sep/video/9f88d1ff,b83d0f9d,da44206b,f34fd50d,f9ebc26f/master.json?base64_init=1" \
--video-id "b83d0f9d" \
--audio-id "b83d0f9d"
ffmpeg -i ${clip_id}-video.mp4 -i ${clip_id}-audio.mp4 -c copy ${clip_id}.mp4
```
## Options
```
Usage:
vimeo-dl [flags]
Flags:
--audio-id string audio id
--combine combine video and audio into a single mp4 (ffmpeg is required)
-h, --help help for vimeo-dl
-i, --input string url for master.json (required)
-o, --output-file-name string output file name
--user-agent string user-agent for request
-v, --version version for vimeo-dl
--video-id string video id
```
## Install
### Pre-compiled binaries
Currently, Windows, macOS and linux are supported.
- Download the latest release from [the release page](https://github.com/akiomik/vimeo-dl/releases/latest).
- Extract the downloaded `.tar.gz` file.
### go install
```sh
# go <1.6
go get -u github.com/akiomik/vimeo-dl
# go >=1.6
go install github.com/akiomik/vimeo-dl
```
## Build
```sh
make build
```
## Test
```sh
make test
```
## Docker
Using Docker images is useful if you do not have ffmpeg installed.
Build docker image:
```
# build docker image (with ffmpeg)
docker build -t vimeo-dl .
# build docker image without ffpeg
docker build -t vimeo-dl:no-ffmpeg --target=no-ffmpeg .
```
Use docker image (instead of the binary):
```
docker run -v "$(pwd)/downloads:/downloads" vimeo-dl ...
```