skool-video-downloader

KO | EN

gitlite — search

#ai #typescript #machine-learning #rust #linux #docker #nodejs #windows #awesome #cli #kubernetes #awesome-list #ios #openai

skool-video-downloader

(★ 11)

A skool video downloader written in go

skool-video-downloader Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Skool Downloader

A Go utility to automatically scrape and download Loom and YouTube videos from Skool.com classrooms.

## Disclaimer

> [!CAUTION]
> **This tool is provided for educational and legitimate purposes only.**

Use this tool only to download content you have the right to access. Please respect copyright laws and terms of service:
- Only download videos you have permission to save
- Do not bypass paywalls or access unauthorized content
- Respect the terms of service of both Skool.com and Loom.com
- The developers accept no liability for misuse

![CLI Screenshot](https://raw.githubusercontent.com/Fx64b/skool-video-downloader/main/docs/cli.png)

## Features

- Scrapes Loom and YouTube video links from Skool.com classroom pages
- Authentication via email/password or cookies
- Supports JSON and Netscape cookies.txt formats
- Downloads videos using yt-dlp with proper authentication
- Automatically detects and normalizes video URLs
- Configurable page loading wait time
- Toggleable headless mode for debugging
- Auto-detects any installed Chromium-based browser

## Installation

### Option 1: Download Pre-built Binaries (Recommended)

1. Install [yt-dlp](https://github.com/yt-dlp/yt-dlp#installation)
2. Download the latest release from the [Releases page](https://github.com/fx64b/skool-downloader/releases)
3. Choose the appropriate binary for your platform:
   - **Linux (x64)**: `skool-downloader-linux-amd64`
   - **Linux (ARM64)**: `skool-downloader-linux-arm64`
   - **Windows (x64)**: `skool-downloader-windows-amd64.exe`
   - **Windows (ARM64)**: `skool-downloader-windows-arm64.exe`
   - **macOS (Intel)**: `skool-downloader-darwin-amd64`
   - **macOS (Apple Silicon)**: `skool-downloader-darwin-arm64`
4. Make it executable (Linux/macOS): `chmod +x skool-downloader-*`

> [!NOTE]
> Older versions were called `skool-loom-dl` bfore release v2.0.0

### Option 2: Build from Source

#### Prerequisites

1. Install [Go](https://golang.org/doc/install) (1.18 or newer)
2. Install [yt-dlp](https://github.com/yt-dlp/yt-dlp#installation)

#### Building the Tool

```bash
# Clone the repository
git clone https://github.com/fx64b/skool-downloader
cd skool-downloader

# Build the executable
go build
```

## Usage

### Basic Usage

```bash
# Recommended: Using email/password for authentication
./skool-downloader -url="https://skool.com/yourschool/classroom/your-classroom" -email="your@email.com" -password="yourpassword"

# Alternative: Using cookies for authentication
./skool-downloader -url="https://skool.com/yourschool/classroom/your-classroom" -cookies="cookies.json"
```

### Important Options

```
-url        URL of the skool.com classroom page (required)
-email      Email for Skool login (recommended auth method)
-password   Password for Skool login (used with email)
-cookies    Path to cookies file (alternative to email/password)
-output     Directory to save videos (default: "downloads")
-wait       Page load wait time in seconds (default: 2)
-headless   Run browser headless (default: true, set false for debugging)
-browser    Path or command of a Chromium-based browser (auto-detected if not set)
```

### Browser Support

The tool requires a Chromium-based browser. On startup it searches for a supported Chromium-based browser automatically: Unfortunatelly Safari and Firefox cannot be supported as of now.

| Platform | Detection order |
|----------|----------------|
| **Windows** | `msedge`, `chrome`, `chromium` (PATH) → Edge default install |
| **macOS** | Chrome → Chromium → Edge → Brave (`/Applications/`) |
| **Linux** | `chromium-browser` → `chromium` → `google-chrome` → `microsoft-edge` → `brave-browser` (PATH) |

The first browser found is used. To pick a specific browser, or if auto-detection fails, use `-browser`:

```bash
# Absolute path
./skool-downloader -url="..." -email="..." -password="..." -browser="/usr/bin/chromium"

# Command available in PATH (Linux/macOS)
./skool-downloader -url="..." -email="..." -password="..." -browser="brave-browser"

# Windows example
skool-downloader.exe -url="..." -email="..." -password="..." -browser="C:\Program Files\Google\Chrome\Application\chrome.exe"
```

> [!NOTE]
> Only Chromium-based browsers are supported (Chrome, Chromium, Edge, Brave). Safari and Firefox are not supported.

### Authentication Methods

**Email/Password (Recommended)**
```bash
./skool-downloader -url="https://skool.com/yourschool/classroom/path" -email="your@email.com" -password="yourpassword"
```

**Cookies (Alternative)**
```bash
./skool-downloader -url="https://skool.com/yourschool/classroom/path" -cookies="cookies.json"
```

> **Note:** Email/password authentication is more reliable as it handles session management automatically. Cookie-based authentication may fail if cookies expire or are invalid.

## Getting Cookies (if needed)

If you choose to use cookies instead of email/password:

1. Install a browser extension like "Cookie-Editor" (Chrome) or "Cookie Quick Manager" (Firefox)
2. Log in to your Skool.com account
3. Export cookies as JSON or Netscape format
4. Save the file and use it with the `-cookies` parameter

## Troubleshooting

- **No videos found**: Verify your authentication and classroom URL
- **Authentication fails**: Use email/password instead of cookies
- **Page loads incomplete**: Increase wait time with `-wait=5` or higher
- **Download errors**: Update yt-dlp (`pip install -U yt-dlp`)
- **Login issues**: Try `-headless=false` to see the browser and debug
- **Specific video errors**: Check if the video is still available on Loom
- **No browser found**: Install Edge, Chrome, Chromium, or Brave — or point to an existing one with `-browser=/path/to/browser`
- **Wrong browser launched**: Override auto-detection with `-browser=` to pick the exact executable you want

## Development and Testing

### Running Tests

This project includes comprehensive unit and integration tests.

#### Unit Tests

Run unit tests with coverage:

```bash
# Run all tests
go test -v ./...

# Run tests with coverage
go test -v -coverprofile=coverage.out -covermode=atomic ./...

# View coverage report
go tool cover -func=coverage.out

# Generate HTML coverage report
go tool cover -html=coverage.out -o coverage.html
```

The unit tests cover:
- Loom URL extraction from HTML (share and embed URLs)
- Cookie parsing (JSON and Netscape formats)
- Cookie format conversion
- Utility functions

#### Integration Tests

Run Docker-based integration tests to verify the full application with yt-dlp:

```bash
# Make the script executable (first time only)
chmod +x test-integration.sh

# Run integration tests
./test-integration.sh
```

The integration tests verify:
- Docker image builds successfully
- Binary is executable in the container
- yt-dlp is installed and functional
- Chromium is available
- ffmpeg is available
- Proper error handling

### Continuous Integration

The project uses GitHub Actions for automated testing:

1. **Lint and Build** (`lint-and-build.yml`): Runs on every push and PR
   - Lints code with golangci-lint
   - Builds the project
   - Runs unit tests with coverage reporting

2. **Docker Integration Tests** (`docker-integration-test.yml`): Runs on every push and PR
   - Builds the Docker image
   - Runs integration tests in a containerized environment

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

### Development Guidelines

1. Write tests for new functionality
2. Ensure all tests pass before submitting PR
3. Run linter: `golangci-lint run ./...`
4. Maintain or improve code coverage
5. Update documentation as needed

### Creating Releases (Maintainers)

To create a new release with cross-platform binaries:

1. Go to the [Actions tab](https://github.com/fx64b/skool-downloader/actions)
2. Select "Build and Release" workflow
3. Click "Run workflow"
4. Enter the desired version (e.g., `v1.0.0`)
5. Click "Run workflow"

The workflow will automatically:
- Build binaries for all supported platforms
- Create a new GitHub release
- Attach all binaries to the release

## License

This project is licensed under the MIT License - see the LICENSE file for details.

skool-video-downloader

skool-video-downloader Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

skool-video-downloader

skool-video-downloader Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README