Skip to content

Conversation

@angelonardone
Copy link

Summary

  • Added -wp, --webcam-position option to configure webcam overlay location (upper-left, upper-right, lower-left, lower-right)
  • Added BBB 3.x support with tldraw whiteboard annotations
  • Documented BBB version compatibility in README

New Features

Webcam Position Option

Users can now choose where the webcam overlay appears on the final video:

bbb-dl -wp upper-right "https://..."

Options: upper-left, upper-right, lower-left, lower-right (default)

BBB 3.x (tldraw) Support

  • Parses tldraw.json for whiteboard annotations
  • Supports: freehand drawings, text, sticky notes, geometric shapes (rectangle, ellipse, diamond), lines, arrows
  • Auto-detects BBB version and handles both 2.x and 3.x formats
  • Handles tldraw cursor coordinates (absolute pixels vs normalized 0-1 range)

Documentation

  • Added "Supported BBB Versions" section with feature comparison table
  • Documented tldraw annotation support
  • Added --webcam-position to help and usage examples

Version

  • Bumped version to 1.1.0

Test plan

  • Tested --webcam-position upper-right with BBB 3.x recording
  • Verified --help shows new option
  • Confirmed backward compatibility with default lower-right position

🤖 Generated with Claude Code

New Features:
- Added -wp, --webcam-position option to configure webcam overlay location
  Options: upper-left, upper-right, lower-left, lower-right (default)
- Added BBB 3.x support with tldraw whiteboard annotations
  - Parses tldraw.json for annotations
  - Supports freehand drawings, text, sticky notes, geometric shapes, lines, arrows
  - Auto-detects BBB version and handles both 2.x and 3.x formats
  - Handles tldraw cursor coordinates (absolute pixels vs normalized)

Documentation:
- Added "Supported BBB Versions" section with feature comparison table
- Documented tldraw annotation support for BBB 3.x
- Added --webcam-position to help and usage examples

Version:
- Bumped version to 1.1.0

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@C0D3D3V
Copy link
Owner

C0D3D3V commented Dec 16, 2025

Looks amazing :) I will test it tomorrow

@C0D3D3V
Copy link
Owner

C0D3D3V commented Dec 19, 2025

Can you please send me a test URL of a session from your BBB 3.x instance? (via mail?) Because the test URL from the other open issue uses a different URL for the recording files, but if yours uses the old style, we need to support both.

@angelonardone
Copy link
Author

angelonardone commented Dec 19, 2025 via email

@angelonardone
Copy link
Author

angelonardone commented Dec 26, 2025 via email

@C0D3D3V
Copy link
Owner

C0D3D3V commented Dec 27, 2025

At the time you posted the URL, I was still able to open the URL, but now it is down. I was unable to test it until now because I sadly had no time... (Christmas, etc.).

Just for the record. Three 2.6.1 sessions I found via google, for testing:
https://talk.tversu.ru/playback/presentation/2.3/4d19f18ee6772758dc8039c2a5eef072ed658c80-1754984365603
https://biggerbluebutton.com/playback/presentation/2.3/94bd977040949353d98ebd5eb2e2a2d3fe0c3c74-1688560517640
https://meet.aspoktatas.hu/playback/presentation/2.3/12426143e9a458060827fea767288219c52b7483-1726122032372

I probably will test it today...

URLs from other issues just for the record:
https://bbb-play1.derspaneli.com/playback/presentation/2.3/f36c5217919606328883eda872bebdc713fee05b-1707496199365
https://bbb-lb.finki.ukim.mk/playback/presentation/2.3/e687769c24cfe30c6bfbd7c7555457327a6c7f65-1646036183863

Both sessions that I got via mail with a different URL pattern, actually do not work anymore (session is kind of down!?)

@angelonardone
Copy link
Author

angelonardone commented Dec 27, 2025 via email

@C0D3D3V
Copy link
Owner

C0D3D3V commented Dec 29, 2025

So I tested it with the first three sessions. (Especially the third is interesting, it has drawings).

Your code sadly does not work correctly. Drawings are not renderd (or maybe off screen). Cursor is not rendered at correct possition (and scale). I can fix it in the next week in my spare time. Or you can try it :D if you have fun trying it...

I already debugged a bit and found out some flaws, like not scaling the cursor position... but this will take some time to make it proper...

@angelonardone
Copy link
Author

angelonardone commented Dec 29, 2025 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants