mrchahar/vlc

Purpose and deliverables

VLC is a cross-platform native multimedia engine and player: it opens files, discs, devices, and network streams; decodes, filters, renders, converts, and retransmits media. It produces the vlc application, the embeddable LGPL libVLC API, and the underlying libvlccore.

• Entrypoints: bin/vlc.c, src/libvlc.c, lib/core.c

• Public embedding surface: include/vlc/libvlc.h, include/vlc/libvlc_media_player.h

Process bootstrap and core runtime

The executable parses startup configuration, initializes libVLC/core services, discovers modules, then creates interfaces and playback work. libvlccore owns shared object lifetime, configuration, threading, logging, networking, and module dispatch; higher layers consume its stable internal abstractions.

• Startup/build-time module composition: bin/vlc.c, bin/vlc_static_modules.c

• Core lifecycle: src/libvlc.c, src/libvlc-module.c

• Dynamic module registry/loading: src/modules/modules.c, src/modules/cache.c

Playback orchestration

The playlist selects media and drives the player. The player owns an input instance and coordinates state, timing, elementary-stream selection, audio output, video output, metadata, titles, and user-visible events. This is the main control boundary between UI/API commands and active playback.

• Playlist scheduling and requests: src/playlist/playlist.c, src/playlist/player.c

• Player state machine: src/player/player.c, src/player/input.c

• Input pipeline coordination: src/input/input.c, src/input/decoder.c, src/input/es_out.c

Media ingestion and decode pipeline

An input MRL is resolved through access modules (file, device, HTTP/RTP/SRT/etc.), optional stream filters/extractors, then a selected demuxer. Demuxers emit elementary streams; packetizers normalize framing; codec modules decode compressed audio/video/subtitles into core frames/pictures.

• Access and transport plugins: modules/access/file.c, modules/access/http/access.c, modules/access/rtp/rtp.c

• Container/adaptive demux: modules/demux/mp4/mp4.c, modules/demux/mkv/demux.cpp, modules/demux/adaptive/adaptive.cpp

• Decode boundary: modules/packetizer/h264.c, modules/codec/avcodec/avcodec.c, include/vlc_decoder.h

Rendering, filtering, and hardware boundaries

Decoded media travels through configurable audio/video/subpicture filter chains to OS- and GPU-specific outputs. Hardware acceleration is implemented as plugins, keeping Direct3D, VA-API, NVDEC, OpenGL, Vulkan, and platform windows outside the generic player/input core.

• Audio pipeline: src/audio_output/output.c, src/audio_output/filters.c, modules/audio_output/

• Video compositor/output core: src/video_output/video_output.c, src/video_output/display.c

• Hardware/platform implementations: modules/hw/d3d11/d3d11_decoder.cpp, modules/hw/vaapi/decoder_device.c, modules/video_output/opengl/display.c

Plugin-facing features and user control

Modules provide replaceable interfaces: Qt/QML, macOS, ncurses, CLI, DBus, Lua, HTTP control, discovery, metadata, and renderer support. GUIs and remote controls operate through player/playlist/core APIs rather than directly owning decoder pipelines.

• Primary desktop UI: modules/gui/qt/qt.cpp, modules/gui/qt/maininterface/mainctx.cpp

• Remote/control interfaces: modules/control/dbus/dbus.c, modules/control/cli/cli.c, share/lua/intf/http.lua

• Scripting and extensions runtime: modules/lua/intf.c, share/lua/extensions/

Output, conversion, and dependencies

The stream-output chain can transcode decoded streams, mux them, and send them to files or network protocols; HLS, RTP/RTSP, DLNA, Chromecast, and HTTP-oriented paths are represented as modules. External multimedia and platform libraries are curated as reproducible contrib builds. Core code is primarily C, with C++, Objective-C, assembly, and Rust components; builds support Autotools and Meson.

• Stream-output orchestration: src/stream_output/stream_output.c, modules/stream_out/transcode/transcode.c

• Mux/network sinks: modules/mux/mp4/mp4.c, modules/access_output/http.c, modules/stream_out/hls/hls.c

• Third-party dependency recipes: contrib/src/main.mak, contrib/src/ffmpeg/rules.mak, contrib/src/qt/rules.mak