explaingit

embiimob/suptv

0HTMLAudience · developerComplexity · 3/5ActiveSetup · moderate

TLDR

A single index.html that searches the p2fk network for IPFS-hosted videos, plays them in a round-robin queue, and can post new entries signed by an in-browser Bitcoin testnet wallet.

Mindmap

mindmap
  root((SupTV))
    Inputs
      Trending keywords
      IPFS CIDs
      Testnet WIF key
    Outputs
      Video playback queue
      Signed p2fk posts
      Broadcast transactions
    Use Cases
      Browse p2fk videos
      Post IPFS clips
      Test wallet flows
      Embed search by URL
    Tech Stack
      HTML
      JavaScript
      IPFS
      Bitcoin testnet

Things people build with this

USE CASE 1

Browse trending p2fk videos in a self-hosted single-file viewer

USE CASE 2

Post a new p2fk message that attaches an IPFS video CID

USE CASE 3

Experiment with an in-browser Bitcoin testnet sendmany flow

USE CASE 4

Embed a SupTV search by passing a keyword in the URL

Tech stack

HTMLJavaScriptIPFSBitcoin

Getting it running

Difficulty · moderate Time to first run · 30min

Posting needs a Bitcoin testnet3 WIF key plus reachable p2fk and mempool.space endpoints; viewer mode also depends on public IPFS gateways being up.

In plain English

SupTV is a single-file web app, just one index.html, for finding, playing, and posting videos that live on a content network called p2fk and on IPFS. IPFS is a peer-to-peer file system, and p2fk is a layer that stores searchable metadata about that content. The README is clear that SupTV is software you run on your own machine, not a hosted streaming service. It has two modes. In viewer mode you open the page and it pulls trending search terms from the p2fk API, picks up to 20 keywords, fetches matching messages, dedupes them by transaction id, and builds a round-robin playback queue from public IPFS gateways. Playback starts as soon as enough early results arrive, and if no trending data is available it falls back to the keyword mp4. You can also preload a query by adding ?q=keyword to the URL. In poster mode, called Compose, the app lets you publish new posts from the browser. It includes a built-in wallet flow that is restricted to Bitcoin testnet3, the test version of Bitcoin used for development, with legacy P2PKH addresses and WIF private key import. You write a message, optionally attach an IPFS video by CID or URL, and the app validates the attachment, builds a p2fk-compatible sendmany payload, signs it in the browser, fetches available unspent outputs from mempool.space, estimates a fee, and broadcasts the transaction. There is also a control to consolidate change back to the main address. The README lists the exact p2fk endpoints used for trending, keyword lookup, channel messages, and search, as well as the mempool.space endpoints used for balance, UTXOs, fees, and broadcast. Configurable constants in the file cover the base URL, the testnet flag, gateway list, and search quantities. The README does not state a license. The wallet is described as a testnet convenience, not for production custody.

Copy-paste prompts

Prompt 1
Walk me through opening SupTV locally and preloading it with a search query through the q parameter
Prompt 2
Show me where in SupTV the round-robin IPFS gateway queue is built and how to add a custom gateway
Prompt 3
Explain how the Compose mode in SupTV signs a sendmany transaction and broadcasts it through mempool.space
Prompt 4
Help me change SupTV from Bitcoin testnet3 to a private regtest node for local development
Prompt 5
Add a button to SupTV that consolidates change back to the main testnet address
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.