LIT_Bot - Live Podcast Notifications

LIT_Bot monitors PodPing events on the Hive blockchain and automatically posts live podcast notifications to Nostr when shows go live.

Features

• 🔴 Real-time Live Detection - Monitors Hive blockchain for PodPing events with reason=live
• 📱 Nostr Integration - Posts live notifications directly to Nostr
• 💬 IRC Integration - Posts live notifications to IRC channels (No Agenda Troll Room, etc.)
• 🛡️ Separate Identity - Uses dedicated Nostr account for live notifications
• ⚡ Fast Response - Notifications within ~20 seconds of shows going live
• 🔧 Easy Setup - Simple configuration with environment variables

Quick Start

1. Clone and Install

   git clone [your-repo-url]
   cd LIT_Bot
   npm install

2. Generate Nostr Key

   # Install noscl if needed
   go install github.com/fiatjaf/noscl@latest
   
   # Generate key pair
   noscl key-gen

3. Configure Environment

   cp .env.example .env
   # Edit .env with your LIT_BOT_NSEC

4. Run LIT_Bot

   npm start

Configuration

Create a .env file with:

# Required: Your Nostr private key
LIT_BOT_NSEC=your_nostr_private_key_here

# Optional: Port (default: 3336)
PORT=3336

# Optional: Test mode
TEST_MODE=false

# Optional: IRC Configuration
IRC_ENABLED=true
IRC_SERVER=localhost  # Using ZNC bouncer
IRC_PORT=6697
IRC_SECURE=true
IRC_NICKNAME=LIT_Bot++
IRC_CHANNELS=#BowlAfterBowl,#HomegrownHits,#DoerfelVerse,#SirLibre

How It Works

1. PodPing Monitoring - LIT_Bot connects to the Hive blockchain and streams operations
2. Live Detection - Filters for custom_json operations with id='podping' and reason='live'
3. Multi-Platform Posting - When a live event is detected, posts notifications to:
   • Nostr relays (primary)
   • IRC channels (optional)
4. Show Discovery - Extracts show titles from feed URLs for clean notifications

Post Format

When a show goes live, LIT_Bot posts:

🔴 LIVE NOW!

🎧 [Show Title]
📻 Tune in now: [Feed URL]

#LivePodcast #PC20 #PodPing

Commands

npm start          # Start LIT_Bot
npm run dev        # Start with file watching
npm run health     # Check if running
npm run status     # Get status info

Technical Details

• Built with: Node.js, Express, @hiveio/dhive, nostr-tools, irc
• Monitoring: Hive blockchain operations stream
• Relays: relay.damus.io, relay.nostr.band, nostr.mom, relay.primal.net
• IRC: Supports any IRC network (Libera.Chat, No Agenda, etc.)
• Port: 3336 (configurable)

Development

1. Test Mode: Set TEST_MODE=true to log without posting
2. Local Testing: Bot runs on http://localhost:3336
3. Health Check: curl http://localhost:3336/health
4. Status: curl http://localhost:3336/status

IRC Setup

No Agenda Troll Room

To post to the No Agenda Troll Room:

IRC_ENABLED=true
IRC_SERVER=irc.zeronode.net
IRC_PORT=6667
IRC_NICKNAME=LIT_Bot++
IRC_CHANNELS=#BowlAfterBowl

Other IRC Networks

• Libera.Chat: irc.libera.chat:6667
• Freenode: irc.freenode.net:6667
• Custom servers: Any IRC server with public channels

See IRC_SETUP.md for detailed configuration options.

Security

• ✅ .env file is gitignored to protect your nsec
• ✅ Use .env.example as template
• ✅ Never commit private keys to version control

About PodPing

PodPing is a notification system for podcast updates built on the Hive blockchain. When podcasters publish new episodes or go live, they can send a PodPing notification that apps and services can monitor in real-time.

Learn more: Podcast Index

License

MIT