# VidStr

> VidStr is a Nostr video client (YouTube-like UX) built on NIP-71 video events. Version 2026.09.15.2. It reads and publishes regular (kind 21/22), addressable (kind 34235/34236), and legacy no-imeta video events; surfaces kind 1 notes linking video files; archives plebs.app uploads (#pv69420); uploads media to Blossom servers; and streams feeds from Nostr relays in realtime. The app sends no Referer header (`<meta name="referrer" content="no-referrer">`), so media on referer-checking hosts (e.g. x.com) plays.

VidStr is a client-side single-page React app and an installable PWA: a
service worker precaches the app shell and runtime-caches same-origin
assets, so it works fully offline after the first load. All content comes
from public Nostr relays; all media comes from Blossom servers. There is no
backend.

Key features:

- Feeds: Global and Subscribed (kind 3 follow list) feeds, separated into
  horizontal "Videos" (kind 21/34235) and vertical "Shorts" (kind 22/34236)
  so vertical floods can't displace horizontal content, plus a "Notes" feed
  of kind 1 notes that link video files (detected client-side via imeta tags
  or video file URLs in the content), plus "Plebs" tabs (main page and
  profile pages) archiving plebs.app uploads (#pv69420) with the
  triple-published events (regular, addressable, kind 1) deduped by video
  URL — surviving single events are shown too.
  Feeds stream from every read relay simultaneously and paint incrementally;
  subscriptions stay open after EOSE for realtime updates. Each kind is
  queried with its own filter object in the same REQ so every kind gets its
  own relay-side limit budget (per NIP-01). Infinite scroll via `until`
  cursors.
- Filters on every listing: NIP-05-only mode (on by default — only videos
  whose author's kind 0 metadata declares a valid NIP-05 identifier, verified
  via cached batched kind 0 fetches), hide/show videos with kind 1984 reports
  (hidden by default), YouTube-link videos, videos without determinable
  duration, note videos, and a dual-handle min/max duration range slider
  (applies to videos with a known duration; persisted across sessions).
- Thumbnails & previews: videos without a thumbnail get a frame extracted
  client-side from the video file (hidden <video> + canvas, ~10% in, 320px
  JPEG), processed one-at-a-time through an idle-time queue with a bounded
  LRU cache and skipped in Data Saver mode; on desktop, hovering a card plays
  the lowest-bitrate variant muted inside the thumbnail (YouTube-style hover
  preview, native-HLS only, respects prefers-reduced-motion).
- i18n: full interface translation (react-i18next) in English (default),
  German, French, Spanish, Italian, and Dutch, with browser language
  detection, localStorage persistence, a header language picker, and a
  Settings → Appearance language selector.
- Upload: multi-server Blossom uploads (BUD-01/02, kind 24242 auth) with
  overall + per-server progress; anonymous mode generates a one-time Nostr
  key per video which the user can keep (edit/delete rights) or toss; video
  duration/dimensions are probed from the file; thumbnails auto-extracted;
  NIP-36 content warnings.
- Playback: direct files, IPFS gateway resolution, and full HLS (m3u8) via
  hls.js including nested master playlists and adaptive quality selection;
  cross-origin playlists/segments are routed through a CORS proxy.
  YouTube-link video events render with a warning banner about NIP-71
  non-compliance and centralization.
- Video length determination for events lacking a duration tag: hidden
  metadata probe for files; EXTINF summation (recursive through master
  playlists) for m3u8.
- Social: NIP-25 reactions (+, −, custom emoji with NIP-30 emoji tags);
  comments as NIP-22 kind 1111 (default) or legacy kind 1 (marked
  non-standard in the UI); NIP-56 kind 1984 reporting of videos and profiles;
  NIP-09 kind 5 deletion; editing of addressable videos by re-publication
  with the same d tag.
- Discovery: hashtag pages (#t filter) and search over title + description
  via NIP-50 `search` filters where relays support it, plus client-side
  matching.
- Theming: Ditto-compatible themes — kind 16767 profile themes on profile
  headers (kind 0 banner always wins the banner strip) and kind 36767 theme
  definitions as an app-wide theme gallery; only colors, fonts, and
  background images (with translucent color overlay) are applied, not Ditto's
  rounded UI elements.
- Settings: NIP-65 relay list management (kind 10002), Blossom server list
  management (kind 10063), color mode, app theme.

Routes: `/` feeds; `/upload`; `/settings`; `/search?q=`; `/tag/:hashtag`;
`/changelog`; `/:nip19` for npub/nprofile (profiles) and note/nevent/naddr
(videos); `/edit/:nip19` for addressable video editing.

## Documentation

- [NIP.md — protocol support details](NIP.md): event schemas for video kinds, legacy format, reactions, comments, reports, themes, feed strategy
- [AGENTS.md — project guide for AI coding agents](AGENTS.md): architecture, conventions, version/changelog policy

## Nostr specifications used

- [NIP-71 Video Events](https://github.com/nostr-protocol/nips/blob/master/71.md): kinds 21, 22, 34235, 34236 with imeta tags
- [NIP-22 Comments](https://github.com/nostr-protocol/nips/blob/master/22.md): kind 1111 comment threading
- [NIP-25](https://github.com/nostr-protocol/nips/blob/master/25.md) + [NIP-30](https://github.com/nostr-protocol/nips/blob/master/30.md): reactions and custom emojis
- [NIP-36](https://github.com/nostr-protocol/nips/blob/master/36.md): content warnings
- [NIP-50](https://github.com/nostr-protocol/nips/blob/master/50.md): relay full-text search
- [NIP-56](https://github.com/nostr-protocol/nips/blob/master/56.md): kind 1984 reports
- [NIP-02](https://github.com/nostr-protocol/nips/blob/master/02.md): kind 3 follow lists
- [NIP-09](https://github.com/nostr-protocol/nips/blob/master/09.md): kind 5 deletion requests
- [NIP-65](https://github.com/nostr-protocol/nips/blob/master/65.md): kind 10002 relay lists
- [Blossom BUD-01/02/03](https://github.com/hzrd149/blossom): media server uploads and server lists

## Optional

- [Changelog](changelog): human-readable version history page
- [robots.txt](robots.txt)