📺 TV Show Stream

Real-time TV show discovery stream using Go, Server-Sent Events (SSE), and TV Maze API. Explore 60,000+ TV shows from worldwide networks with live streaming updates!

✨ Features

• 🔴 Real-time Streaming — New TV shows every 4 seconds via SSE
• 📊 Live Statistics — Track shows discovered, average ratings, countries
• 🎭 Rich Show Data — Genres, networks, ratings, runtime, and more
• 🖼️ Visual Cards — Show posters with responsive design
• 🌍 Worldwide Coverage — Shows from all networks and countries
• 📱 Responsive UI — Beautiful Tailwind CSS interface

🚀 Quick Start

Clone the repository:

git clone https://github.com/smart-developer1791/go-tvshow-stream
cd go-tvshow-stream

Initialize dependencies and run:

go mod tidy
go run .

Open http://localhost:8080 in your browser.

🏗️ Project Structure

go-tvshow-stream/
├── main.go          # Server, SSE handler, API integration
├── go.mod           # Go module definition
├── render.yaml      # Render deployment config
├── .gitignore       # Git ignore rules
└── README.md        # Documentation

🔧 Dependencies

Package	Purpose
chi	Lightweight HTTP router

📡 API Reference

This project uses the TV Maze API:

• Endpoint: https://api.tvmaze.com/shows/:id
• Rate Limit: 20 calls per 10 seconds
• Auth: None required (public API)

🎯 SSE Endpoint

GET /events
Content-Type: text/event-stream

Event Data:

{
  "id": 82,
  "name": "Game of Thrones",
  "language": "English",
  "genres": ["Drama", "Adventure", "Fantasy"],
  "status": "Ended",
  "runtime": 60,
  "premiered": "2011-04-17",
  "rating": 9.0,
  "network": "HBO",
  "country": "United States",
  "image": "https://static.tvmaze.com/uploads/images/...",
  "summary": "Based on the bestselling book series...",
  "url": "https://www.tvmaze.com/shows/82/game-of-thrones",
  "timestamp": "14:32:15"
}

🌐 Environment Variables

Variable	Default	Description
PORT	8080	Server port

📊 Show Status Types

Status	Color	Description
Running	🟢 Green	Currently airing
Ended	🔴 Red	Series concluded
To Be Determined	🟡 Yellow	Awaiting renewal
In Development	🔵 Blue	Not yet aired

🎨 Tech Stack

• Backend: Go 1.23+
• Router: Chi v5
• Frontend: Tailwind CSS (CDN)
• Streaming: Server-Sent Events
• API: TV Maze (REST)

📈 Live Stats Tracked

• Shows Discovered — Total unique shows streamed
• Average Rating — Mean rating of all shows
• Countries — Unique countries represented

---

Deploy in 10 seconds