uvc2gl

A Linux application that captures video and audio from USB capture cards (UVC/V4L2 + ALSA) and renders to OpenGL with real-time format switching via GUI.

Features

• Multi-Device Support: Switch between multiple video and audio capture devices at runtime
• V4L2 Video Capture: Direct MJPEG capture from USB capture devices
• ALSA Audio Capture: Real-time audio capture with SDL2 playback
• Hardware Decoding: FFmpeg-based MJPEG to RGB decoding
• OpenGL Rendering: Modern OpenGL 4.6 with custom shaders
• Live Format Switching: Right-click context menu to change resolution/framerate/devices
• Audio Volume Control: Adjustable volume with real-time slider
• Configuration Persistence: Saves device preferences, resolution, and volume settings
• Fullscreen Support: Press F11 or F to toggle fullscreen mode
• Auto-detected Formats: Queries available formats from each capture device
• Dynamic Aspect Ratio: Automatically maintains correct aspect ratio for any resolution
• Multithreaded: Separate capture/decode threads for smooth performance
• Dear ImGui UI: Lightweight immediate-mode collapsible menu overlay

Building

Prerequisites

# Fedora/RHEL
sudo dnf install SDL2-devel glew-devel cmake ninja-build clang ffmpeg-devel alsa-lib-devel libc++ libc++-devel libc++abi libc++abi-devel

# Ubuntu/Debian
sudo apt install libsdl2-dev libglew-dev cmake ninja-build clang libavcodec-dev libavformat-dev libswscale-dev libavutil-dev libasound2-dev libc++-dev libc++abi-dev

Compile

mkdir -p build && cd build
cmake -G Ninja ..
ninja

Run

cd build
./uvc2gl

Right-click anywhere in the window to open the device/format selection menu.
Press F11 to toggle fullscreen. Press ESC to exit fullscreen or close the menu.

Project Structure

GameCapture/
├── main.cpp            # Entry point
├── CMakeLists.txt      # Build configuration
├── build/              # Build artifacts (Ninja)
│   ├── uvc2gl          # Main executable
│   ├── uvc2gl.conf     # Configuration file (auto-generated)
│   ├── Probe           # V4L2 device info utility
│   ├── StreamMjpg      # MJPEG stream capture test
│   ├── MjpgDecodeTest  # FFmpeg decoder test
│   └── shaders/        # Copied shader files
├── external/
│   └── imgui/          # Dear ImGui library
└── src/
    ├── core/           # Application lifecycle & config
    │   ├── Application.h/cpp
    │   └── Config.h
    ├── graphics/       # Window & rendering
    │   ├── Window.h/cpp
    │   ├── Renderer.h/cpp
    │   ├── Shader.h/cpp
    │   └── Quad.h/cpp
    ├── audio/          # Audio capture & playback
    │   ├── AudioCapture.h/cpp
    │   ├── AudioPlayback.h/cpp
    │   └── ALSACapabilities.h/cpp
    ├── video/          # Video capture & decode
    │   ├── VideoCapture.h/cpp
    │   ├── MjpgDecoder.h/cpp
    │   ├── Frame.h
    │   ├── RingBuffer.h
    │   ├── V4L2Capabilities.h/cpp
    │   ├── v4l2Probe.cpp
    │   └── v4l2StreamMjpg.cpp
    └── assets/
        └── shaders/
            ├── Quad.vert
            └── Quad.frag

Configuration

The application automatically saves your preferences to uvc2gl.conf:

• Last used video device
• Last used audio device
• Resolution and framerate
• Audio volume level

Settings are restored on next startup. If devices are unavailable, defaults to first available device.

Utilities

• Probe: Query V4L2 device capabilities
• StreamMjpg: Capture raw MJPEG frames to disk
• MjpgDecodeTest: Test FFmpeg MJPEG decoding