# Tubbr - Complete Documentation

## Product Overview

Tubbr is an AI-powered platform for creating faceless YouTube and TikTok videos. The platform handles the entire content creation workflow from niche research to final video generation.

**Website**: https://trytubbr.com
**Support**: support@trytubbr.com

---

## Features

### 1. Niche Discovery & Research

**Trending YouTube Niches**
- Browse current trending topics on YouTube
- View search queries, competition levels, and category breakdown
- Filter by niche type (faceless-friendly, evergreen, viral potential)

**TikTok Trends**
- Track trending TikTok content
- Identify emerging patterns before they peak
- Find gaps in existing content

**Niche Finder**
- Enter any interest or topic
- Get AI-researched niches with video topics, hooks, and channel ideas
- Score each opportunity on demand, competition, monetization, sustainability

**Target Audience Finder**
- Define your content type
- Get detailed audience personas
- Understand pain points and preferences

### 2. Script Generation

**Script Ideas Generator**
- Input any topic or niche
- Get multiple video ideas with hooks
- Each idea includes: title, hook, angle, potential
- Generate narration scripts from script ideas

**Brainrot Script Generator (Character-Based)**
- Select characters for your story
- Define topic and pitch
- Choose runtime (15s to 3m)
- Get dialogue-based scripts with:
  - Multiple parts/scenes
  - Setting descriptions
  - Visual prompts for each scene
  - Multiple TikTok title/description options
- Auto-generate scenes after script creation

**Channel Ideas Generator**
- Input target audience or interest
- Get channel name suggestions
- Get content pillars and video concepts

### 3. Character & Asset Generation

**Character Generator**
- Create characters with name, description, and image prompt
- Generate consistent AI images of characters
- Upload reference images
- Set default aspect ratio
- Manage multiple characters

**Image Generator**
- Standalone image generation
- Multiple providers: Imagen 4 Ultra, Seedream 4.5, Seedream 5.1, Flux 2 Pro, Seedance 2.0, Grok Imagine
- Aspect ratio selection (1:1, 9:16, 16:9)
- Character consistency support
- Progress tracking and status updates

### 4. Scene & Video Production

**Script to Scenes**
- Convert any script into scenes automatically
- Each scene gets: visual prompt, narration, voice settings
- Adjust scene timing and content

**Video Generation**
- Generate video clips from scenes
- Providers: Kling 2.5, Kling 3.0, Seedance, Grok Imagine Video
- Progress tracking with frame extraction

**Audio Generation**
- Text-to-speech with ElevenLabs
- Multiple voice options
- Adjustable speed and stability

**Scene Editor**
- Timeline view of all scenes
- Reorder scenes via drag-and-drop
- Edit individual scene prompts and narration
- Preview generated assets

---

## User Dashboard

### Dashboard Routes

- `/dashboard` - Main dashboard
- `/dashboard/characters` - Character generator
- `/dashboard/images` - Image generator
- `/dashboard/videos` - Video generator
- `/dashboard/audios` - Audio generator
- `/dashboard/scripts` - View and manage generated scripts
- `/dashboard/generate-script-ideas` - Generate script ideas and narration scripts
- `/dashboard/niche-finder` - Find faceless-friendly niches
- `/dashboard/target-audience` - Define target audience personas
- `/dashboard/trending-niche` - YouTube trending topics
- `/dashboard/trending-niche-tiktok` - TikTok trending topics
- `/dashboard/past-generations` - View past generations

### Pages
- `/privacy` - Privacy Policy
- `/terms` - Terms of Service

### Scripts Management
- View all generated scripts
- Filter by status
- View script details and history

### Characters Management
- List all characters
- View generated assets per character
- Set default character image
- Delete characters and assets

### Images Management
- View standalone generated images
- Filter by status (completed, processing, failed)
- Delete images

---

## Technical Details

### Supported AI Providers

**Image Generation**
- Imagen 4 Ultra
- Seedream 4.5 / Seedream 5.1
- Flux 2 Pro
- Seedance 2.0
- Grok Imagine

**Video Generation**
- Kling 2.5 Turbo Pro
- Kling Video 3.0
- Seedance 1 Lite
- Grok Imagine Video

**Audio**
- ElevenLabs Multilingual v2

### API Endpoints (Internal)

- `GET /api/trending-niche` - YouTube trending topics
- `GET /api/trending-niche-tiktok` - TikTok trends
- `POST /api/niche-finder` - Find niches for topic
- `POST /api/target-audience` - Get audience personas
- `POST /api/generate-channel-ideas` - Generate channel concepts
- `POST /api/generate-script-ideas` - Generate video ideas and narration scripts
- `POST /api/script-to-scenes` - Convert script to scenes
- `GET /api/scripts` - List user scripts
- `GET /api/characters` - List user characters
- `POST /api/images` - Generate standalone images
- `GET /api/images` - List generated images

---

## Content Examples

### Generated TikTok Title Options

For brainrot scripts, Tubbr generates multiple title/description pairs:

1. **High Viral Hook** - Catchy hook with emoji, unfinished tension, hashtags
2. **Emotional/Story-Driven** - Sad framing, emotional hashtags
3. **Brainrot/Dramatic** - POV style with 💀🔥, dramatic hashtags
4. **Short + Punchy** - Ultra-short, best for retention

### Script Structure

```
Title: [Script Title]
Runtime: [Duration]

Part 1: [Part Name]
Setting: [Description]
Visual Prompt: [AI image generation prompt]
Dialogues:
- Character1: "line"
- Character2: "line"
```

---

## Tutorials

- `/tutorial/how-to-make-brainrot-videos` - Create brainrot/character-based videos
- `/tutorial/how-to-make-narration-videos` - Create narration-style videos (5-step guide: Topic Ideas → Script → Images/Videos → Audio → Export)

## Pricing & Access

- Currently in beta with early access
- Balance system for credits
- Points-based pricing for different operations

---

## Blog Content

Latest blog posts include:
- TikTok Niche Discovery guide
- How to go viral on TikTok
- Faceless YouTube automation guide
- AI video tools comparison
- Script writing secrets
- Niche selection strategy

---

## Related Products & Services

- **Tubbr Auth** - User authentication service
- **Tubbr API** - Backend API service
- **Tubbr Balance** - Credit management
- **Workers Blogs** - Blog content management

---

## Version History

- v1.0 - Initial launch with niche research and script generation
- v1.1 - Added brainrot script generation with character support
- v1.2 - Added image and video generation capabilities
- v1.3 - Added standalone image generation endpoint
- v1.4 - Added waiting list for new users
- v1.5 - Added blog section

---

Last updated: April 2026