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.0.7.tar.gz (19.3 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.0.7-py3-none-any.whl (24.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: uw_panopto_downloader-1.0.7.tar.gz
  • Upload date:
  • Size: 19.3 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.0.7.tar.gz
Algorithm Hash digest
SHA256 413c0202baaf95e229545c9b5688e88dc5794e4b94acdf960fb9ac1cfd34e479
MD5 110018933a35cd0b48d13aaf91d4dc55
BLAKE2b-256 cc4637429ffafdab93f014c2e572fb817b5a0d635dd9743a27958913574076dd

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for uw_panopto_downloader-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 a292c16c98691206268605b3658e10f4034a6966ebcc763453149e61ba314cbf
MD5 ea32681692f5b6b9ee5895b284d7ad21
BLAKE2b-256 7f6e6988792a32af5e4d32be373fbd15dc3e79271f435d1a4c480347b284491c

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