Skip to main content

A Python library for downloading videos from UW Panopto

Project description

UW Panopto Downloader

A Python tool for downloading videos from UW Panopto and optionally converting them to audio format.

Features

  • Interactive browser-based login to access your Panopto content
  • Extract video links from Panopto course pages
  • Concurrent downloading of multiple videos
  • Video to audio conversion (MP4 to MP3)
  • User-friendly command line interface with rich formatting
  • Configurable settings saved between sessions

Installation

# From PyPI
pip install uw-panopto-downloader

# From source
git clone https://github.com/elimelt/uw-panopto-downloader.git
cd uw-panopto-downloader
pip install -e .

Requirements

  • Python 3.11 or higher
  • FFmpeg (for video downloads and conversion)
  • Chrome or Chromium browser (for Selenium)

Usage

Command Line Interface

The package provides a command-line tool uwpd with several subcommands:

# Show help
uwpd --help

# Download videos
uwpd download [OPTIONS]

# Convert videos to audio
uwpd convert [INPUT] [OPTIONS]

# View or update configuration
uwpd config [OPTIONS]

# Show version
uwpd version

Download Command

# Start an interactive download session
uwpd download

# Specify a starting URL
uwpd download --url "https://panopto.uw.edu/your-course-page"

# Set output directory
uwpd download --output "path/to/downloads"

# Set number of concurrent downloads
uwpd download --workers 5

# Run in headless mode (no browser window)
uwpd download --headless

Convert Command

# Convert a single video
uwpd convert video.mp4

# Convert with output path
uwpd convert video.mp4 --output audio.mp3

# Convert a directory of videos
uwpd convert videos_dir/ --output audio_dir/

# Set audio bitrate
uwpd convert video.mp4 --bitrate 320k

# Set number of FFmpeg threads
uwpd convert video.mp4 --threads 4

Config Command

# Show current configuration
uwpd config --show

# Update configuration
uwpd config --download-dir "path/to/downloads" --max-workers 4

Python API

You can also use the package programmatically:

from uw_panopto_downloader.core import BrowserSession, PanoptoDownloader, VideoConverter

# Initialize a browser session
browser = BrowserSession(headless=False)
browser.manual_login("https://panopto.uw.edu/your-course-page")

# Download videos
downloader = PanoptoDownloader(browser, max_workers=3)
video_links = browser.extract_links()
downloader.download_videos(video_links, "downloads")

# Convert videos to audio
converter = VideoConverter(bitrate="192k")
converter.convert_directory("downloads", "audio")

Configuration

The configuration is stored in ~/.uw-panopto-downloader/config.json and includes:

  • download_dir: Default download directory
  • max_workers: Maximum number of concurrent downloads
  • headless: Whether to run the browser in headless mode
  • audio_bitrate: Default audio bitrate for conversion
  • ffmpeg_threads: Default number of FFmpeg threads

License

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

uw_panopto_downloader-1.1.3.tar.gz (38.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

uw_panopto_downloader-1.1.3-py3-none-any.whl (43.5 kB view details)

Uploaded Python 3

File details

Details for the file uw_panopto_downloader-1.1.3.tar.gz.

File metadata

  • Download URL: uw_panopto_downloader-1.1.3.tar.gz
  • Upload date:
  • Size: 38.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for uw_panopto_downloader-1.1.3.tar.gz
Algorithm Hash digest
SHA256 1f876b66f6fe08691a8b8d55aba96925106d82fd46d88dc775c43edb37ee3516
MD5 a07deabad11f4dbf4463a26efa72a7dd
BLAKE2b-256 3e51ea6b64faf0d70c904240f9ab38b8a5a19c19f3e76cc6e30d7f4f5bc44f7c

See more details on using hashes here.

File details

Details for the file uw_panopto_downloader-1.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for uw_panopto_downloader-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 56bbb8930dc466a41835a2446f9bce9d909f2879d4c8bd214542374c7749458f
MD5 79beae45bdb52a5d35875e0b34ff9bdd
BLAKE2b-256 4c2b7a99cdb8aa2be93fd95e825249a950b41d0defa280b473e968b122e64f21

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page