🎥 Loom Video Downloader

📥 A simple and powerful Node.js command-line tool to download videos from loom.com

Loom Video Downloader makes it easy to download videos from Loom by simply providing the video URL. It supports both single video downloads and batch downloads from a list of URLs, with customizable output options and rate limiting to avoid getting blocked.

✨ Features

• 🎯 Single Video Download - Download any Loom video with just the URL
• 📋 Batch Download - Process multiple videos from a text file
• � Progress Bars - Real-time download progress with ETA
• ⏯️ Resume Downloads - Smart resume functionality for interrupted downloads
• 🎥 Quality Selection - Choose video quality with automatic analysis
• �📁 Custom Output - Specify output directory and filename
• 🏷️ Filename Prefix - Add custom prefixes for batch downloads
• ⏱️ Rate Limiting - Built-in timeout to avoid getting blocked
• ⚙️ Configuration File - Save default settings for consistent usage
• 🚀 Easy to Use - Simple command-line interface

🚀 Getting Started

Prerequisites

Make sure you have Node.js 12.0.0 or higher installed on your machine.

• Download Node.js

📦 Installation

Option 1: Global Installation (Recommended)

npm install -g loom-dl

Option 2: Clone Repository

# Clone the repository
git clone https://github.com/EcomGraduates/loom-downloader.git

# Navigate to project directory
cd loom-downloader

# Install dependencies
npm install

# Run the tool
node loom-dl.js --url https://www.loom.com/share/[VideoId]

🔧 Dependencies

📖 Usage

🎯 Download a Single Video

Download any Loom video using its URL:

loom-dl --url https://www.loom.com/share/[VideoId]

💡 Example:

loom-dl --url https://www.loom.com/share/abc123def456
# Downloads as: abc123def456.mp4

Custom Output Filename

Specify a custom filename and location:

# Custom filename
loom-dl --url https://www.loom.com/share/[VideoId] --out my-video.mp4

# Custom path and filename
loom-dl --url https://www.loom.com/share/[VideoId] --out path/to/my-video.mp4

📋 Download Multiple Videos

Process multiple videos from a text file:

1. Create a URL list file

Create a text file with one Loom URL per line:

# urls.txt
https://www.loom.com/share/video1-id
https://www.loom.com/share/video2-id
https://www.loom.com/share/video3-id

2. Run batch download

loom-dl --list path/to/urls.txt

3. With custom prefix and output directory

loom-dl --list urls.txt --prefix "tutorial" --out ./downloads

📁 Output: tutorial-1.mp4, tutorial-2.mp4, tutorial-3.mp4

📝 Note: If no output path is specified, files will be saved to your Downloads folder

⏱️ Rate Limiting

Prevent getting blocked by adding delays between downloads:

loom-dl --list urls.txt --prefix download --out ./output --timeout 5000

This adds a 5-second delay between each download. Adjust the timeout value as needed.

📋 Command Reference

Use as MCP server (AI assistants)

You can run the tool as an MCP (Model Context Protocol) server so AI assistants (e.g. Cursor, Claude Desktop) can download Loom videos for you via tools.

1. Add to your MCP config (e.g. Cursor settings or claude_desktop_config.json):

{
  "mcpServers": {
    "loom-downloader": {
      "command": "npx",
      "args": ["-y", "loom-dl@latest", "--mcp"]
    }
  }
}

2. Tools exposed to the AI

Example (AI can call):
download_loom_video({ "url": "https://www.loom.com/share/VIDEO_ID", "with_transcript": true })

🚀 Quick Start Examples

# Download single video
loom-dl --url https://www.loom.com/share/abc123def456

# Download with custom name
loom-dl --url https://www.loom.com/share/abc123def456 --out "my-presentation.mp4"

# Batch download with prefix
loom-dl --list videos.txt --prefix "course" --out ./downloads

# Batch download with rate limiting
loom-dl --list videos.txt --timeout 3000 --prefix "meeting"

⚙️ Configuration Management

📁 Save Default Settings

Save your preferred settings to avoid repeating them:

# Save preferred quality and timeout settings
loom-dl --save-config --quality best --timeout 2000 --prefix "MyVideos_"

# Now all future downloads will use these defaults
loom-dl --url https://www.loom.com/share/abc123def456

📋 View Current Configuration

Check your current default settings:

loom-dl --show-config

Example output:

{
  "quality": "best",
  "resume": true,
  "timeout": 2000,
  "outputDir": "downloads",
  "prefix": "MyVideos_"
}

🔄 Reset to Defaults

Reset all settings back to the original defaults:

loom-dl --reset-config

📝 Configuration File

Settings are stored in .loomrc.json in the project directory. You can also edit this file directly:

{
  "quality": "720p",
  "resume": true,
  "timeout": 1000,
  "outputDir": "downloads",
  "prefix": ""
}

Available Settings:

• quality: Video quality preference (auto, 480p, 720p, 1080p, best)
• resume: Enable/disable resume functionality (true/false)
• timeout: Delay between downloads in milliseconds
• outputDir: Default output directory
• prefix: Default filename prefix

🤝 Contributing

We welcome contributions from the community! Whether it's bug fixes, new features, documentation improvements, or any other enhancements, your help is appreciated.

🤝 Please read our Contributing Guide for detailed information on:

• How to set up the development environment
• Coding standards and best practices
• How to submit pull requests
• Reporting issues and requesting features

Quick start: Fork → Create branch → Make changes → Test → Submit PR

👥 Contributors

We appreciate all contributors who have helped improve this project:

🔒 Security

Security is important to us. If you discover a security vulnerability, please report it responsibly.

📋 Please read our Security Policy for:

• How to report security vulnerabilities
• Our response timeline and process
• Supported versions and security updates
• Security best practices for users

🚨 Do not report security vulnerabilities through public issues!

🐛 Issues & Support

Found a bug or need help? We're here to assist!

• 🐛 Report a Bug
• 💡 Request a Feature
• 💬 Ask a Question
• 🔒 Report Security Issue

📄 License

This project is open source and available under the MIT License.

⭐ If this tool helped you, please give it a star! ⭐

Made with ❤️ by the community