Unlock the full potential of WWDC content with wwdctools!
Download videos, transcripts, sample code, and subtitles from Apple's WWDC sessions seamlessly.
wwdctools provides the tools you need to access and manage WWDC content with ease, through a powerful Command Line Interface (CLI) and a flexible Python API.
- Download complete session content: Get videos, transcripts, and code with a single command.
- Fetch detailed transcripts: Obtain session transcripts in various formats (Text, Markdown, JSON).
- Extract all code samples: Access inline snippets and downloadable sample code files.
- Retrieve WebVTT subtitles: Download subtitle files for session videos.
- Dual interface: Use it as a CLI tool or integrate it as a Python library.
To install wwdctools for use, run the following command in your terminal:
uv add wwdctoolsAlternatively, for projects using pip for dependencies:
pip install wwdctools- Python 3.13 or higher
You can use wwdctools via its CLI or as a Python library. Here’s how to quickly download all content for a single session:
CLI example:
wwdctools download <session_url> --output downloads/Python API example:
import asyncio
from wwdctools import fetch_session_data, download_session_content
async def main():
session_url = "https://developer.apple.com/videos/play/wwdc2024/10144" # Example URL
session = await fetch_session_data(session_url)
downloads = await download_session_content(session, "downloads")
print(f"Downloaded content: {downloads}")
asyncio.run(main())Note: wwdctools supports localized WWDC URLs such as:
https://developer.apple.com/jp/videos/play/wwdc2025/102/https://developer.apple.com/kr/videos/play/wwdc2025/102/- and other language codes in the URL path.
When using a localized URL, the language code from the URL (e.g., jp for Japanese) will automatically be used for subtitles and WebVTT content unless you explicitly specify a different language with the --language option.
This section details how to work with transcripts using both the CLI and Python API.
Display the transcript directly in your terminal:
wwdctools transcript https://developer.apple.com/videos/play/wwdc2024/10144Save the transcript to a file:
wwdctools transcript https://developer.apple.com/videos/play/wwdc2024/10144 --output transcript.txtFetch multiple transcripts and save them to a directory:
wwdctools transcript https://developer.apple.com/videos/play/wwdc2024/10144 https://developer.apple.com/videos/play/wwdc2024/10145 --output transcripts/Fetch multiple transcripts and combine them into a single file:
wwdctools transcript https://developer.apple.com/videos/play/wwdc2024/10144 https://developer.apple.com/videos/play/wwdc2024/10145 --output combined.txt --combineSave the transcript in different formats (e.g., Markdown or JSON):
wwdctools transcript https://developer.apple.com/videos/play/wwdc2024/10144 --output transcript.md --format md
wwdctools transcript https://developer.apple.com/videos/play/wwdc2024/10144 --output transcript.json --format jsonimport asyncio
from wwdctools import fetch_session_data, fetch_transcript
async def get_transcript(url):
session = await fetch_session_data(url)
if session.transcript_content:
transcript = session.transcript_content
return transcript
return None
# Run the async function
transcript = asyncio.run(get_transcript("https://developer.apple.com/videos/play/wwdc2024/10144"))
print(transcript)Extract code samples from sessions and save them in various formats.
Extract code samples from a session and print to console:
wwdctools code https://developer.apple.com/videos/play/wwdc2024/10144Save code samples to a directory:
wwdctools code https://developer.apple.com/videos/play/wwdc2024/10144 --output sample_code/Choose the output format (e.g., Markdown or JSON):
# Choose output format (txt/md/json)
wwdctools code https://developer.apple.com/videos/play/wwdc2024/10144 --output samples.md --format mdimport asyncio
from wwdctools import fetch_session_data
async def extract_code():
# Fetch session data
session = await fetch_session_data("https://developer.apple.com/videos/play/wwdc2024/10144")
# Access code samples
for sample in session.sample_code:
print(f"Title: {sample.title}")
print(f"Timestamp: {sample.timestamp}")
print(f"Code:\n{sample.code}\n")
# Run the async function
asyncio.run(extract_code())Download WebVTT subtitle files from WWDC session pages.
Display WebVTT information in your terminal:
wwdctools webvtt https://developer.apple.com/videos/play/wwdc2024/10144Save WebVTT files to a directory:
wwdctools webvtt https://developer.apple.com/videos/play/wwdc2024/10144 --output subtitles/Specify a language for subtitles (falls back to English if unavailable):
wwdctools webvtt https://developer.apple.com/videos/play/wwdc2024/10144 --language jaAvailable language codes include: en (English), ja (Japanese), zh (Chinese), ko (Korean), fr (French), es (Spanish), de (German), and pt-BR (Brazilian Portuguese). Language availability may vary by session.
Combine all WebVTT files into a single file:
wwdctools webvtt https://developer.apple.com/videos/play/wwdc2024/10144 --output combined.webvtt --combineimport asyncio
from wwdctools import fetch_session_data
async def get_webvtt():
# Fetch session data (with language preference, defaults to English)
session = await fetch_session_data(
"https://developer.apple.com/videos/play/wwdc2024/10144",
language="ja" # Optional: specify language code (e.g., ja, zh, fr)
)
# Fetch WebVTT content
webvtt_content = await session.fetch_webvtt()
# Process WebVTT content
for i, content in enumerate(webvtt_content):
print(f"WebVTT sequence {i}:\n{content[:100]}...") # Print first 100 chars
# Run the async function
asyncio.run(get_webvtt())If you want to contribute to wwdctools or run it from the source code, follow these instructions to set up a development environment.
git clone https://github.com/tattn/wwdctools.git
cd wwdctools
uv sync --extra devAll testing and quality checks are run using uv run. These commands assume you are in the root of the project directory.
# Run tests (uses pytest with anyio)
uv run --frozen pytest
# If pytest fails to find anyio mark (e.g., in some CI environments)
PYTEST_DISABLE_PLUGIN_AUTOLOAD="" uv run --frozen pytest
# Format code
uv run --frozen ruff format .
# Run linting
uv run --frozen ruff check .
# Fix auto-fixable issues
uv run --frozen ruff check . --fix
# Run type checking
uv run --frozen pyrightMIT
