155 lines
4.1 KiB
Markdown
155 lines
4.1 KiB
Markdown
# StreamFlow V3.9
|
|
|
|
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)
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
version: '3.8'
|
|
|
|
services:
|
|
streamflow:
|
|
image: git.khoavo.myds.me/vndangkhoa/kv-streamflow:v3.9
|
|
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
|
|
```
|
|
|
|
```bash
|
|
docker-compose up -d
|
|
```
|
|
|
|
Access at: `http://YOUR_NAS_IP:3478`
|
|
|
|
### Local Development
|
|
|
|
**Prerequisites:** Go 1.24+, Node.js 20+
|
|
|
|
```bash
|
|
# 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.9 (Current)
|
|
- Bundled Android TV APK with the webapp for direct download
|
|
- Verified D-pad navigation on Android TV app
|
|
|
|
### v3.8
|
|
- Updated docker compose configuration
|
|
|
|
### v3.7
|
|
- 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
|