How oncename/pytube works
pytube is a Python library and CLI for retrieving YouTube video information and downloading media. The main workflow accepts a video URL, fetches and extracts its details and available streams, lets the caller select a stream, then downloads it; users can also obtain captions or work with playlists, channels, and search. The graph separates public entry points, YouTube-facing retrieval, parsing and stream handling, and collection features. Some connections are based on the SOURCE INDEX or README rather than fully sampled implementations, so uncertain links are omitted.
Main entry points: __main__.py YouTube interface · streams.py Stream handling · extract.py Data extraction · request.py HTTP requests
Components 20
User entry points
- CLI
pytube/cli.py - YouTube interface
pytube/__main__.py
Video retrieval
- HTTP requests
pytube/request.py - Innertube API
pytube/innertube.py
Media processing
- Data extraction
pytube/extract.py - HTML parser
pytube/parser.py - Signature cipher
pytube/cipher.py - Stream handling
pytube/streams.py - Stream queries
pytube/query.py - Caption tracks
pytube/captions.py - Video metadata
pytube/metadata.py - Format definitions
pytube/itags.py - Shared state
pytube/monostate.py - Utilities
pytube/helpers.py - Exceptions
pytube/exceptions.py
Discovery features
- Playlist access
pytube/contrib/playlist.py - Channel access
pytube/contrib/channel.py - YouTube search
pytube/contrib/search.py
Other components
- Library user
- YouTube
Connections 29
- Library user → YouTube interface: provides URL
README.md - Library user → CLI: runs command
README.md - CLI → YouTube interface: uses library
pytube/cli.py - YouTube interface → HTTP requests: fetches pages
pytube/__main__.py - YouTube interface → Innertube API: requests player data
pytube/__main__.py - YouTube interface → Data extraction: extracts details
pytube/__main__.py - YouTube interface → Stream handling: exposes streams
README.md - YouTube interface → Caption tracks: exposes captions
pytube/__init__.py - Stream handling → HTTP requests: downloads media
pytube/streams.py - Stream handling → Data extraction: uses format data
pytube/streams.py - Stream handling → Format definitions: looks up formats
pytube/streams.py - Stream handling → Shared state: shares state
pytube/streams.py - Stream handling → Utilities: uses utilities
pytube/streams.py - Stream queries → Stream handling: queries stream objects
pytube/query.py - Caption tracks → HTTP requests: fetches captions
pytube/captions.py - Caption tracks → Utilities: uses utilities
pytube/captions.py - Data extraction → HTML parser: parses page data
pytube/extract.py - Data extraction → Signature cipher: deciphers signatures
pytube/extract.py - Data extraction → Video metadata: builds metadata
pytube/extract.py - Innertube API → HTTP requests: sends API requests
pytube/innertube.py - Playlist access → HTTP requests: fetches playlist pages
pytube/contrib/playlist.py - Playlist access → Data extraction: extracts page data
pytube/contrib/playlist.py - Playlist access → YouTube interface: creates video objects
pytube/contrib/playlist.py - Channel access → HTTP requests: fetches channel data
pytube/contrib/channel.py - Channel access → Data extraction: extracts channel data
pytube/contrib/channel.py - YouTube search → Innertube API: fetches search results
pytube/contrib/search.py - YouTube search → YouTube interface: creates video objects
pytube/contrib/search.py - HTTP requests → YouTube: requests content
README.md - YouTube interface → Exceptions: raises access errors
pytube/__main__.py