BigBlueSync

BigBlueButton recording downloader and stream multiplexer.

---

Overview

BigBlueSync is a desktop application for downloading and combining recorded BigBlueButton sessions into single video files.

BigBlueButton stores recordings in separate media streams, typically keeping screen shares in deskshare.mp4 and microphone audio with camera video in webcams.mp4. BigBlueSync automatically downloads both files and runs a stream copy through FFmpeg to merge the screen recording with presenter audio into an .mp4 file in seconds without quality loss.

---

Download and run

Precompiled standalone binaries are available on the Releases page. No Python or dependencies required.

Platform	File to download	How to run
Windows	BigBlueSync-Windows.exe	Double-click to run
macOS	BigBlueSync-macOS	Double-click or run from terminal
Linux	BigBlueSync-Linux-x86_64	chmod +x BigBlueSync-Linux-x86_64 && ./BigBlueSync-Linux-x86_64

---

Features

• Lossless stream remuxing: Combines video and audio streams using FFmpeg stream copy (-c:v copy -c:a copy), completing in seconds without quality loss.
• URL resolver: Automatically extracts meeting IDs from standard playback paths (/playback/presentation/2.3/<id>) and query parameters (?meetingId=<id>).
• Dark mode interface: Clean desktop interface with real-time status and progress tracking.
• SSL tolerance: Connects to institutional servers that use internal or self-signed SSL certificates.
• Real-time progress: Displays download progress in megabytes and percentage.
• Bundled FFmpeg: Includes required media processing tools with no configuration needed.

---

System architecture

flowchart LR
    subgraph S1["1. Client Input"]
        direction TB
        A["Playback URL"]
        UI["CustomTkinter UI\n(Progress & MB rate)"]
    end

    subgraph S2["2. Core Engine"]
        direction TB
        B["URL Parser\n(Meeting ID Regex)"]
        C["Stream Downloader\n(SSL & 16 KB Buffer)"]
    end

    subgraph S3["3. BBB Server"]
        direction TB
        D["webcams.mp4\n(Audio + Camera)"]
        E["deskshare.mp4\n(Screen + Slides)"]
    end

    subgraph S4["4. Remux Engine"]
        direction TB
        F["FFmpeg Multiplexer\n-map 0:v:0 -map 1:a:0\n-c:v copy -c:a copy"]
    end

    subgraph S5["5. Local Storage"]
        direction TB
        G["BigBlueSync_<id>_MERGED.mp4\n(Synchronized Output)"]
    end

    A --> B
    B -->|Query endpoints| S3
    D & E -->|Chunked streams| C
    C -.->|Progress events| UI
    C -->|Raw streams| F
    F -->|Lossless output| G

Loading

---

Running from source (optional)

If you prefer to run from source code:

git clone https://github.com/Azhonaras/BigBlueSync.git
cd BigBlueSync
pip install -r requirements.txt
python BigBlueSync.py

---

License

Distributed under the MIT License. See LICENSE for details.