vndangkhoa/kv-netflix
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
kv-netflix/README.md
vndangkhoa fb3b4dff37 chore: bump version to v3.8
2026-02-20 21:52:57 +07:00

3.9 KiB
Raw Blame History

StreamFlow V3.7

A high-performance video streaming web application with a pure Go backend and modern React + Tailwind frontend.

Features

  • Modern UI - React 19, TypeScript, Vite 7, Tailwind CSS 4
  • High Performance - Go backend with concurrent API fetching
  • Smart Scraping - Multi-provider support (Ophim, PhimMoiChill)
  • HLS Streaming - Native HLS playback with proxy support
  • Android TV - Native TV app with D-pad controls and 10s skip
  • PWA Support - Install as a progressive web app
  • Docker Ready - Multi-stage build for Synology NAS (linux/amd64)

Tech Stack

Component Technology
Backend Go 1.24, Chi Router, GORM, SQLite
Frontend React 19, TypeScript, Vite 7, Tailwind CSS 4
Mobile Android TV (Kotlin + Jetpack Compose)
Deployment Docker multi-stage build

Quick Start

Docker (Recommended)

# docker-compose.yml
version: '3.8'

services:
  streamflow:
    image: git.khoavo.myds.me/vndangkhoa/kv-streamflow:v3.8
    container_name: streamflow
    platform: linux/amd64
    ports:
      - "3478:8000"
    environment:
      - DATABASE_URL=/app/data/streamflow.db
      - TZ=Asia/Ho_Chi_Minh
    volumes:
      - ./data:/app/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "-q", "--spider", "http://localhost:8000/api/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 10s

docker-compose up -d

Access at: http://YOUR_NAS_IP:3478

Local Development

Prerequisites: Go 1.24+, Node.js 20+

# Backend (port 8000)
cd backend
go mod tidy
go run ./cmd/server/main.go

# Frontend (port 5173)
cd frontend-react
npm install
npm run dev

API Endpoints

Endpoint Method Description
/api/health GET Health check
/api/videos/home GET Get home page movies
/api/videos/search?q= GET Search movies
/api/videos/{slug} GET Get movie details
/api/extract POST Extract video URL
/api/stream?url= GET Proxy video stream
/api/images/proxy?url= GET Proxy images
/api/categories/genres GET Get genre list
/api/categories/countries GET Get country list

Project Structure

Streamflow/
├── backend/
│   ├── cmd/server/main.go      # Entry point
│   ├── internal/
│   │   ├── api/                # HTTP handlers & routes
│   │   ├── config/             # Configuration
│   │   ├── database/           # Database layer
│   │   ├── models/             # Data models
│   │   ├── scraper/            # Movie providers
│   │   └── service/            # Business logic
│   ├── go.mod
│   └── go.sum
├── frontend-react/
│   ├── src/
│   │   ├── components/         # React components
│   │   ├── context/            # React context
│   │   ├── hooks/              # Custom hooks
│   │   ├── pages/              # Page components
│   │   ├── themes/             # Theme variants
│   │   └── types/              # TypeScript types
│   ├── package.json
│   └── vite.config.ts
├── android-tv/                 # Android TV app
├── Dockerfile
├── docker-compose.yml
└── README.md

Changelog

v3.7 (Current)

  • Codebase cleanup and security improvements
  • Added SSRF protection with URL validation
  • Added graceful shutdown and config module
  • Added React ErrorBoundary and lazy loading
  • Refactored handlers to reduce code duplication
  • Updated to Go 1.24 and Node.js 20
  • Added healthcheck to Docker Compose

v3.6

  • Fixed duplicate episodes
  • Updated Android TV app

v3.5

  • Fixed extract 500 error
  • Fixed Android TV crash

v3.4

  • Prevent screen sleep during playback

v3.3

  • Rebranded to kv-netflix
  • Added PWA support

License

MIT