A command line interface for Vimeo.
npm install -g vimeo-cli
You must follow these instructions to setup the utility before running any other commands.
- Visit https://developer.vimeo.com/apps/new
- Fill out the fields and click Create app
- On the app page, click the OAuth2 tab
- make a note of the Client Identifier and the Client Secret
- Back in your terminal, run
vimeo setup <client_identifier> <client_secret>
You're all set! Run vimeo --help to see available commands.
See Setup Instructions.
Usage: vimeo auth
This will walk you through authenticating a Vimeo account to use with the CLI. You can perform this multiple users and switch between them using vimeo use <nickname>.
Note: You need to setup the CLI before you can do this. See Setup.
Usage: vimeo use <nickname>
Switch between authenticated users based on the nickname you assigned each one during the authentication step. The user you select will be the user that authenticates all subsequent requests.
Usage: vimeo users
List all authenticated users and their associated nicknames.
Usage: vimeo remove <nickname>
Remove an authenticated user based on the nickname you assigned it during the authentication step.
Usage: vimeo list <item>
List all of the authenticated user's specified items. Supported items include: videos, albums, appearances, channels, groups, followers, following, likes, portfolios, presets, watchlater
Usage: vimeo add [options] <item>
Add the given item to the current authenticated user's account.
Supported items: album, channel, group, following, like, watchlater
Available options:
| Options | Use | Applies to Item | Required? |
|---|---|---|---|
| -n | Set name | album channel group |
yes |
| -d | Set description | album channel group |
yes |
| -p | Set privacy level | album channel |
no |
| -P | Set password | album |
yes (if privacy = password) |
| -s | Set default sort order | album |
no |
| -u | Specify user ID | following |
yes |
| -v | Specify video ID | like watchlater |
yes |
Usage: vimeo follow <user_id>
Follow the specified user. (Alias for vimeo add following -u <user_id>)
Usage: vimeo like <video_id>
Like the specified video. (Alias for vimeo add like -v <video_id>)
Usage: vimeo watchlater <video_id>
Add the specified video to the watch later queue. (Alias for vimeo add watchlater -v <video_id>)
Usage: vimeo upload <path>
Uploads the video at the given path.
File an issue.
Pull requests welcome!
MIT.