Skip to Content
DevelopersQuick start

Quick start

Prepare your environment

  • Internet access and NAK  installed.
  • For live streaming: FFmpeg or OBS. The user may also like the Shosho app (iOS / Android).

Order of operations

  1. Get or create a Nostr identity — keypair (nsec / npub). Includes key creation, kind 0 profile, kind 10002 relay list. See also Profile and relays.
  2. Get RTMP live streaming details — ingest URL, stream key, and HLS playback URL. Either the user’s own RTMP server (BYO) or by querying the Shosho Server API. See Going live programmatically.
  3. Go live — broadcast RTMP video. Users can use the Shosho app, OBS, FFmpeg, or any RTMP client.
  4. Chat in streams — send kind 1311 messages and kind 7 reactions. See Chat.
  5. Post clips — publish kind 34235 / 34236 events. See Clips.
  6. List products — publish NIP-99 kind 30402 listings. See Products.
  7. Purchase products — click through from product listings to the seller’s external purchase page.

When a stream goes live, it appears in the Shosho lives feed and push-notifies app users who follow the streamer. When it ends, the server may make a replay and download available. Clips appear on the user’s profile. Products appear on the user’s profile and in the user’s shop overlay on their live, replay, and clip pages.

Last updated on
OverviewNostr identity