Skip to content

Add Nebula TV thumbnail support#14

Open
furdiburd wants to merge 3 commits intoajayyy:masterfrom
furdiburd:master
Open

Add Nebula TV thumbnail support#14
furdiburd wants to merge 3 commits intoajayyy:masterfrom
furdiburd:master

Conversation

@furdiburd
Copy link
Copy Markdown

@furdiburd furdiburd commented Apr 1, 2026

Adds support for generating and serving thumbnails for Nebula TV videos.

Since Nebula requires authentication to access video streams, I created a Cloudflare Worker to act as a proxy, handling authentication and returning a signed HLS URL. The server then uses this URL to extract the requested frame using ffmpeg.

This is related to these pull requests

ajayyy/SponsorBlockServer#625

ajayyy/ExtensionTranslations#111

ajayyy/DeArrow#462

Your Name and others added 2 commits March 31, 2026 23:28
- utils/nebula.py: calls the CF Worker to get authenticated HLS stream URLs
- utils/thumbnail.py: adds Nebula generation/retrieval, refactors shared
  helpers (file paths, redis keys, FFmpeg extraction) to support both
  YouTube and Nebula via nebula=True keyword argument
- app.py: adds /api/v1/getNebulaThumbnail endpoint
- utils/config.py: adds nebula_worker_url and nebula_worker_auth_secret
- config.yaml.example: documents nebula config options
- tests/test_nebula_thumbnail.py: yt-dlp based integration tests
@furdiburd
Copy link
Copy Markdown
Author

I created a Cloudflare Worker that runs on 'https://nebula-thumbnail-worker.anoim.workers.dev/'. It could be used for the project as the default Nebula Worker. I already have a lifetime Nebula subscription, so it is not an issue for me to keep it running.

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.

1 participant