Need help with zoomdl?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

156 Stars 19 Forks GNU General Public License v3.0 93 Commits 10 Opened issues


Download Zoom recorded meetings easily

Services available


Need anything else?

Contributors list



Like this project? Consider supporting me, for more awesome updates

Buy me a coffeeBuy me a coffee


More and more, I face the challenge of testing. I code on my own Debian machine, and use a Windows 10 VM to compile the executable. But testing has become more and more a challenge, especially for new features.

If you are anyhow interested in helping (there are various ways to!), go to the dedicated issue (#32), and comment there. The concept is still very young for me, sorry that.


Conferences, meetings and presentations held on Zoom are often recorded and stored in the cloud, for a finite amount of time. The host can chose to make them available to download, but it is not mandatory.

Nonetheless, I believe if you can view it, you can download it. This script makes it easy to download any video stored on the Zoom Cloud. You just need to provide a valid zoom record URL, and optionally a filename, and it will download the file.


The script was developed and tested under GNU/Linux (precisely, Debian 10). Thus, it should work for about any GNU/Linux distro out there, with common settings. You basically only need Python3 in your path.

New from 2020.06.09 There now exists an executable file

for Windows. It was kinda tested under Windows 10. Because I never coded under Windows, I have very few tests, mostly empirical ones. Expect bugs! If you encounter a Windows-specific error, don't expect much support. If the error is related to the general logic of the program, report it and I'll do my best to fix it.



You need to have a valid Python3 installation. Except from that, just download the script

) and run it like a normal binary. If you wish to make it available system-wide, you can copy it to
(or anywhere else available in your PATH). Then you can simply use it wherever you want.

The following two commands make that easy. In a terminal, run:

sudo wget -O /usr/bin/zoomdl
sudo chmod +x /usr/bin/zoomdl
You will be prompted to enter your password (your computer password, not zoom). It's likely that you won't see anything as you type it, don't worry, it is normal (even for OSX)

Once you have done that, you can use your terminal and type the commands normally.


This is still in beta Grab the dedicated binary

, and launch it using your command line. If you don't know how, visit this wikihow. You may encounter warning from your anti-virus, you can ignore them (I'm not evil, pinky-promise). You probably don't need a Python3 installation, it should be contained within the executable.

Validity of urls

There are 2 type of valid urls. * Those starting with * Or, with a domain, where X is a domain, something like us02web, epfl,... or similar.

If there is a domain in your url, make sure to include it, it's crucial.


zoomdl [-h] -u/--url 'url' [-f/--fname 'filename'] [-p/--password 'password'] [-c/--count-clips count] [-d/--filename-add-date] [--user-agent 'custom_user_agent]
is mandatory, it represents the URL of the video *
is optional, it is the name of the resulting file without extension. If nothing is provided, the default name given by Zoom will be used. Extension (
,... is automatic) *
is too optional. Set it when your video has a password. *
: Sometimes, one URL can contain multiple clips. This tunes the number of clips that will be downloaded. Recordings with multiple clips seem to be quite rare, but do exist. The parameter
works as follow: * 0 means: download all of them (starting from the current clip) * 1 means: download only the first/given clip * > 1 means: download until you reach this number of clip (or the end) *
will append the date of the recording to the filename. without effect if
is specified
(no shorthand notation): lets you specify a custom User-Agent (only do that if you know what you're doing and why)

About syntax

I see a lot of people who don't understand what the above means. Here is a short explanation: * This is a command, with multiple possible parameters. * Parameters usually have a short version (with one dash, like

) and an equivalent long version (with two dashes, like
); the short and long version are shown separated by a
; you must only use one of them. * The parameters between square brackets are optional (like
, that allows you to input a custom filename). The others (for the moment, only
) are mandatory. * The order of parameters don't matter * the
parameter only displays a short help and commands explanation

For example, those are all valid commands (ofc by replacing the URLs):

zoomdl -u "https://my_url" -f "recording_from_monday"
zoomdl --url "https://my_url"
zoomdl -p '$28fn2f8' --filename-add-date --filename "recording_from_tuesday" -u "https://my_url" --user-agent "Windows 10 wonderful User-Agent -v 3"

About quotes [IMPORTANT]

The quotes are not mandatory, but if your filename/url/password/... contains reserved characters (

...), quotes are the way to go.

Under Linux/OSX, it is strongly advised to use single quotes, because

will replace
by nothing, while
will leave the string as-is.

Under Windows, I think you must use double quotes everywhere. Don't quote me on that.


All dependencies are bundled within the executable. This allows to make a standalone execution without need for external libraries.

If you wish to build it yourself, see

. The most important requirement is requests. Please see acknowledgements for a note on that.


The folder executable contains requests (and its dependencies), an awesome wrapper for HTTP(s) calls. Please check them out!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.