Skip to content

indicaindependent/blueboxd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

πŸ“Ί Blueboxd

A Bluesky film club for public-domain cinema. Free, ad-free, and fully portable β€” your film diary, ratings, and reviews live in your own AT Protocol repo, not ours.

Watch classic public-domain films, log them to your Bluesky identity, host live watch parties, and climb a community leaderboard. No paywalls, no tracking, no separate account.

Live at blueboxd.com.


What is this?

Blueboxd is a single Cloudflare Worker that powers an entire Letterboxd-style film club on top of Bluesky and the AT Protocol. Films stream directly from the Internet Archive β€” Blueboxd hosts no video and controls no content.

The twist: there is no Blueboxd database for your data. Your diary entries, ratings, reviews, and watchlist are written as records into your own atproto repo via OAuth. Delete your account on Blueboxd and you keep everything β€” it's yours, portable, forever.

Features

  • 🎬 Public-domain catalogue β€” thousands of vintage films (noir, sci-fi, horror, westerns, musicals…) verified against a real film database and streamed legally from archive.org.
  • πŸ“” atproto-native diary β€” ratings, reviews, watchlist, and "in library" all saved to your Bluesky repo via OAuth. No password ever touches Blueboxd.
  • πŸŽ‰ Live watch parties β€” scheduled group screenings with a countdown hero, RSVP, a synced player that unlocks at showtime, and live reactions mirrored from the Bluesky thread.
  • πŸ† Leaderboard β€” weekly community ranking by films watched, with snapshots.
  • πŸ¦‹ Shareable cards β€” every diary, stats, party, and leaderboard view generates a clickable Bluesky link-preview card that drives fans back into the room.
  • πŸ‘€ Person pages β€” browse by star or director with full, de-duplicated filmographies.

Architecture

                    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   blueboxd.com ───▢│   Cloudflare Worker          β”‚
                    β”‚   (this repo β€” worker.js)    β”‚
                    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
   archive.org  ◀────  β€’ catalogue + streaming     β”‚
   (films)          β”‚  β€’ watch parties + rooms     β”‚
                    β”‚  β€’ leaderboard + snapshots   β”‚
   Bluesky /    ◀────  β€’ share-card rendering      β”‚
   AT Protocol      β”‚  β€’ OAuth β†’ user's own repo   │──▢ your atproto repo
   (your diary)     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    (diary, ratings, reviews)
                              β”‚
                    KV  Β·  D1 (social index)

Everything runs at the edge in one Worker. State lives in Cloudflare KV (caches, sessions) and D1 (the social/watch index) β€” never the user's film data, which is atproto-only.

Self-hosting

You'll need a Cloudflare account, a Bluesky account to act as the host, and Node.

  1. Bind a KV namespace, a D1 database, and your secrets/vars:
    • OWNER_DID_ENV β€” the DID of your host/owner Bluesky account
    • OAuth client config + a host app-password (as Worker secrets, never hardcoded)
  2. Set OWNER_DID / HOST_HANDLE in worker.js (or via the env var) to your account.
  3. Deploy worker.js to your Worker and point your domain at it.
  4. The .mjs helpers post the scheduled cadence cards (Saturday party, weekly leaderboard, diary share).

Security note: all tokens, app-passwords, and OAuth secrets are read from Worker secret bindings. There are no secrets in this source, and there never should be β€” see SECURITY.md.

License

MIT Β© indicaindependent


Part of the Indica Independent stack. Public-domain cinema, streamed free & legal.

About

πŸ“Ί Free public-domain cinema with a film diary that lives in your own Bluesky repo β€” a Letterboxd-style social layer on the AT Protocol. Single Cloudflare Worker, no ads, no tracking. blueboxd.com

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors