https://github.com/Welltory/Zoom2Youtube
Transfer video recordings from the Zoom to YouTube
https://github.com/Welltory/Zoom2Youtube
downloader notification slack uploader youtube zoom
Last synced: about 1 month ago
JSON representation
Transfer video recordings from the Zoom to YouTube
- Host: GitHub
- URL: https://github.com/Welltory/Zoom2Youtube
- Owner: Welltory
- License: mit
- Created: 2017-08-07T05:16:02.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-05-22T21:34:26.000Z (almost 2 years ago)
- Last Synced: 2024-10-31T20:41:01.234Z (6 months ago)
- Topics: downloader, notification, slack, uploader, youtube, zoom
- Language: Python
- Homepage:
- Size: 68.4 KB
- Stars: 79
- Watchers: 14
- Forks: 19
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
↓↓↓
# Zoom2Youtube is a utility for transferring video recordings from the Zoom.us to YouTube
At [Welltory](https://welltory.com), we hold and record 3-4 virtual meetings every day. The easiest way is to record meetings in [zoom.us](https://zoom.us), then upload them to YouTube where they can be accessed by anyone, from any device: phones, Chromecast, etc. We’ve automated video transfers from Zoom to YouTube, added notifications, and now every recording is automatically dropped into a Slack channel. We use privacy settings (**unlisted**) on YouTube to make sure people who aren’t on the team don’t have access to our meetings.
The project is written in Python and launched in Docker. This simplifies the project’s initial deployment.
# About
Disclaimer: The utility is supplied "AS IS" without any warranties.
You can reach us at [email protected]
# Features
- Automatically download a new Zoom video
- Upload the video to YouTube (privacy settings: unlisted)
- Drop a link to the YouTube video into a Slack channel
- Filter settings: will not upload videos under 15 minutes long to prevent uploads of accidental recordings
Quick Start Guide
=========
Step 1 - Set up Docker
------------------------
Install Docker and Docker-Compose
1. Docker installation instructions: https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/#install-docker-ce
2. Docker-compose installation instructions: https://docs.docker.com/compose/install/#alternative-install-options
Then create a Docker image. To do this, enter the command:
```
$ make build
```
Step 2 - set up Zoom
----------------------
You need to create a `.env` file in the root directory of the project, specifying the keys listed below:
ZOOM_API_KEY
ZOOM_API_SECRET
ZOOM_EMAIL
To get the keys, follow these steps:
1. Follow the link: https://marketplace.zoom.us/docs/guides/build/jwt-app
2. Create JWT app
3. Enter the `API Key` in `ZOOM_API_KEY`, `API Secret` in `ZOOM_API_SECRET`
Step 3 - Set up Youtube
-------------------------
Add the following keys to the `.env` file
GOOGLE_REFRESH_TOKEN
GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRET
To get the keys, follow these steps:
1. Go to the developer console: https://console.developers.google.com/cloud-resource-manager
2. Create a new project and go to the new project
3. Follow the link: https://console.developers.google.com/apis/api/youtube.googleapis.com/overview
4. Turn on `YouTube Data API v3`
5. Follow the link: https://console.developers.google.com/apis/credentials
6. create OAuth client credentials.
7. Select Other types or `Other` (depends on localization), create
8. Enter `Client ID` in `GOOGLE_CLIENT_ID` and `Client Secret` in `GOOGLE_CLIENT_SECRET`
To get the `GOOGLE_REFRESH_TOKEN` follow these steps:
1. Follow the link: [https://accounts.google.com/o/oauth2/auth?client_id=&redirect_uri=urn:ietf:wg:oauth:2.0:oob&scope=https://www.googleapis.com/auth/youtube.upload&access_type=offline&response_type=code](https://accounts.google.com/o/oauth2/auth?client_id=&redirect_uri=urn:ietf:wg:oauth:2.0:oob&scope=https://www.googleapis.com/auth/youtube.upload&access_type=offline&response_type=code), **replacing** `` with the `GOOGLE_CLIENT_ID`, you got from the previous step
2. Select the Google account you need access for
3. Get access
4. Enter the token in the .env file, in the `.env` in the `GOOGLE_CODE` field
5. Run the script in docker container
```
$ docker-compose run app bash
$ python3.6 src/get_google_refresh_token.py`
```
6. Enter the refresh token in the `.env` file, in the `GOOGLE_REFRESH_TOKEN` field
Step 4 - Set up Slack
-----------------------
Add the following keys to the `.env` file
SLACK_CHANNEL
SLACK_TOKEN
1. Enter the recipients (separated with commas) in `SLACK_CHANNEL`, for example `SLACK_CHANNEL=#my_cannel,@my_user`
2. Enter the slack token in `SLACK_TOKEN`
Step 5 - Check keys
-----------------------
To make sure all the keys were entered into the `.env` file, run the script in docker container
```
$ docker-compose run app bash
$ python3.6 src/check_env.py
```
Step 6 - Run the app
-------------------------
Launch the container:
```
$ make up
```
Another way to run the app, through virtualenv
------------------------------------------------------------------------
1. Create a virtual environment
```
$ virtualenv venv -p /usr/bin/python3 --no-site-package
```
2. Activate virtual environment
```
$ source venv/bin/activate
```
3. Establish requirements
```
$ pip install -r requirements.txt
```
4. Copy cron config
```
$ sudo cp cron/crontab /etc/cron.d/zoom2youtube-cron
```
5. Restart cron
```
$ sudo service cron restart
```
Sample .env file
-----------------
```
ZOOM_API_KEY=AAAAAAAAAAAAAAA
ZOOM_API_SECRET=BBBBBBBBBBBB
[email protected]
GOOGLE_CLIENT_ID=AAAAAAAAAAAAAA.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=BBBBBBBBBBBBBb
GOOGLE_REFRESH_TOKEN=CCCCCCCCCCCC
GOOGLE_CODE=DDDDDDDDDDDDDD
SLACK_CHANNEL=@user
SLACK_TOKEN=AAAAAAAAAAAAA
```
```
// Extra/optional configs
ZOOM_FROM_DAY_DELTA=7
ZOOM_PAGE_SIZE=10
```
License
-------
[The MIT License (MIT)](https://en.wikipedia.org/wiki/MIT_License)