Skip to content

hyunbinseo/zoom-rec-dl

Repository files navigation

zoom-rec-dl

Save Zoom cloud recordings to a local directory. A cross-platform video and audio download script.

Requirements

  • Windows, macOS, and Linux - any operating system that supports Node.js and npm.
  • Zoom cloud recording share link that does not require any additional authentication.

For protected cloud recordings, the shareable link

  • Should have the passcode embedded in the link.
  • Should show a media player and a download button.
  • Should not show an 'Enter the passcode to watch'.

Reference the documentation and update the following settings in the Zoom web portal.

ADMIN / Account Management / Account Settings
e.g. https://us06web.zoom.us/account/setting

[v] Allow cloud recording sharing - By disabling this setting, nobody else except the host can access the shareable link.

[v] Cloud recording downloads - Allow anyone with a link to the cloud recording to download
[ ] └── Only the host can download cloud recordings

[ ] Require users to authenticate before viewing cloud recordings

[ ] Set recording as on-demand by default - Users must register before they can watch the recording

[v] Require passcode to access shared cloud recordings
[v] └── Embed passcode in the shareable link for one-click access

Prerequisites

Node.js and npm are required. The latest Node.js LTS installer can be downloaded here.

  • npm should be installed. (Included in the Node.js installer)
  • Add to PATH option should be checked. (Windows only)

Instructions

  1. Create a urls.txt file and add URLs to the text file, one in each line.
  2. Open a terminal in the directory where the urls.txt file is located.1
  3. Execute the npx zoom-rec-dl@latest command2 in the terminal.
Need to install the following packages:
  [email protected]
Ok to proceed? (y) ← Press enter

Advanced

Get Notified on Completion

Create a sendgrid.json file alongside urls.txt to send an email when the download is completed.

{
  "apiKey": "SendGrid-API-Key",
  "from": "[email protected]",
  "to": ["[email protected]", "[email protected]"]
}

Automatically Start Downloading

Modify the urls.txt file to trigger a download process.

  1. Install the PM2 process manager globally.
  2. Install the PM2 log rotating module.
  3. Create a ecosystem.config.js file.
// ecosystem.config.js - should be placed alongside the `urls.txt` file.
// Reference https://pm2.keymetrics.io/docs/usage/application-declaration/
module.exports = {
  apps: [
    {
      name: 'zoom-download',
      script: 'npx zoom-rec-dl@latest',
      // script: 'pnpm dlx zoom-rec-dl@latest',
      watch: ['urls.txt'],
      time: true,
      autorestart: false,
    },
  ],
};
  1. Run pm2 start and start the watch process.

Footnotes

  1. When ls or dir command is executed, the urls.txt file should be listed.

  2. pnpm users can use the pnpm dlx zoom-rec-dl@latest command instead.