A simple and effective Python tool for downloading videos from Loom. Built with yt-dlp for reliable video extraction and download capabilities.
- ✅ URL Validation - Automatically validates Loom video URLs
- ✅ Multiple Quality Options - Download in best, worst, video-only, or audio-only quality
- ✅ Metadata Extraction - Saves video info, thumbnails, and subtitles
- ✅ Custom Output Directory - Specify where to save downloaded content
- ✅ Command-Line Interface - Easy to use with command-line arguments
- ✅ Error Handling - Clear error messages and graceful failure handling
- Python 3.9 or higher
- pip package manager
- Clone or download this repository
- Navigate to the project directory:
cd loom-downloader - Install required packages:
pip install -r requirements.txt
Download a Loom video with default settings:
python loom_downloader.py "https://www.loom.com/share/your-video-id"Custom output directory:
python loom_downloader.py "https://www.loom.com/share/your-video-id" -o "/path/to/downloads"Specify video quality:
python loom_downloader.py "https://www.loom.com/share/your-video-id" -q bestFull example with all options:
python loom_downloader.py "https://www.loom.com/share/abc123def456" -o "./my_videos" -q bestvideo| Option | Short | Description | Default |
|---|---|---|---|
url |
- | Loom video URL (required) | - |
--output |
-o |
Output directory for downloads | ./downloads |
--quality |
-q |
Video quality selection | best |
best- Highest available quality (default)worst- Lowest available qualitybestvideo- Best video quality (video only)bestaudio- Best audio quality (audio only)
The downloader supports various Loom URL formats:
https://www.loom.com/share/[video-id]https://loom.com/share/[video-id]https://www.loom.com/embed/[video-id]https://loom.com/embed/[video-id]
When downloading a video, the tool creates several files:
- Video file - The main video in the best available format
- Thumbnail - Video thumbnail image (
.jpgor.png) - Info file - Video metadata in JSON format (
.info.json) - Subtitles - Automatic and manual subtitles if available (
.srt,.vtt)
- URL Validation - Checks if the provided URL is a valid Loom video link
- Metadata Extraction - Uses
yt-dlpto extract video information without downloading - Quality Selection - Determines the best available format based on your quality preference
- Download Process - Downloads the video along with thumbnails, metadata, and subtitles
- File Organization - Saves all files to your specified output directory
"Invalid Loom URL provided"
- Ensure the URL is a complete Loom video link
- Check that the video is publicly accessible or you have permission to view it
"Error downloading video"
- The video may be private or restricted
- Check your internet connection
- Try updating yt-dlp:
pip install --upgrade yt-dlp
"Permission denied" errors
- Make sure you have write permissions to the output directory
- Try running with elevated privileges if necessary
If you encounter import errors, ensure all dependencies are installed:
pip install --upgrade yt-dlp- Built with: Python 3.9+
- Core dependency: yt-dlp (YouTube-DL fork)
- Supported formats: MP4, WebM, and other formats supported by yt-dlp
- Platform compatibility: Windows, macOS, Linux
This project is developed and maintained by HeroTools.
This tool is provided "as is" without warranty of any kind. HeroTools is not liable for any damages or issues arising from the use of this software. Users are responsible for ensuring they have proper permissions to download content and for complying with Loom's terms of service.
MIT License - see LICENSE file for details.
This tool is for educational and personal use. Please respect Loom's terms of service and only download videos you have permission to access.
Developed by HeroTools