TubeTrend

A YouTube trend analysis tool built with Vite + React + TypeScript. Analyze video performance, track favorites, and discover trending content across channels.

Dashboard

Analyzer

---

Quick Start

Option 1: Docker (Recommended)

One command, no setup required:

docker run -d -p 8889:80 ghcr.io/fo0/tubetrend:latest

Open http://localhost:8889

Option 2: Docker Compose

Linux / macOS:

curl -O https://raw.githubusercontent.com/fo0/tubetrend/main/docker-compose.yml && docker-compose up -d

Windows (PowerShell):

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/fo0/tubetrend/main/docker-compose.yml" -OutFile "docker-compose.yml"; docker-compose up -d

Open http://localhost:8889

Option 3: Run from Source

Prerequisites: Node.js v22+

git clone https://github.com/fo0/tubetrend.git
cd tubetrend
npm install
npm run dev

Open http://localhost:3000

---

YouTube API Key

The app requires a YouTube Data API v3 key. Get one free at: https://console.cloud.google.com/apis/credentials

Enter your API key in the app when prompted.

---

Features

• Dashboard — Track favorite channels and keywords with cached video data
• Analyser — Search and analyze videos with trend scoring
• Highlights — Auto-surface top-performing videos
• Multi-language — 13 languages with auto-detection
• Dark Mode — System-aware with manual toggle
• API Quota Tracking — Monitor YouTube API usage

---

Build for Production

npm run build    # Build to dist/
npm run preview  # Preview production build

Tech Stack

React 19 | TypeScript | Vite 6 | Tailwind CSS | i18next | YouTube Data API v3

License

MIT