> ## Documentation Index
> Fetch the complete documentation index at: https://gigareels.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Brainrot Content

> Generate viral brainrot content with character dialogues and background gameplay

# Brainrot Content

Brainrot content combines character dialogues with engaging background gameplay to create viral, educational, or entertaining videos perfect for TikTok, YouTube Shorts, and Instagram Reels.

## Content Types

> [card] 📚 Educational Brainrot
>
> Character dialogues explaining complex topics in simple terms

> [card] 💬 iMessage Conversations
>
> iPhone-style text conversations with character voices

> [card] 📖 Reddit Stories
>
> Narrated Reddit posts with character commentary

> [card] 📺 Breaking News
>
> SpongeBob-style fish reporter breaking news format

## Educational Brainrot

Perfect for explaining complex topics in an engaging, viral format.

### Basic Example

```javascript theme={null}
import { GigaReels } from "@gigareels/sdk";

const client = new GigaReels("your-api-key");

const task = await client.templates.brainrot.educational({
	prompt: "Explain quantum physics in simple terms for beginners",
	characterPack: "rick-and-morty",
	backgroundVideoPack: "minecraft-parkour",
	enableGifs: true,
	webhookUrl: "https://your-app.com/webhook",
});
```

### Parameters

**prompt** `string` *required*

The educational topic or content you want to explain (10-1000 characters)

**characterPack** `string` *required*

Character pack ID for the dialogue voices

**backgroundVideoPack** `string` *required*

Background video pack for the gameplay footage

**backgroundMusicPack** `string`

Background music pack to add audio ambiance

**enableGifs** `boolean` (default: false)

Whether to include reaction GIFs during the dialogue

**webhookUrl** `string`

URL to receive completion notification

### Advanced Example

```javascript theme={null}
const task = await client.templates.brainrot.educational({
	prompt: `
    Explain how artificial intelligence is revolutionizing healthcare.
    Cover machine learning in medical diagnosis, drug discovery,
    and personalized treatment plans. Make it engaging for teenagers.
  `,
	characterPack: "rick-and-morty",
	backgroundVideoPack: "minecraft-parkour",
	backgroundMusicPack: "upbeat",
	enableGifs: true,
	webhookUrl: "https://your-app.com/webhook",
});

console.log("Educational video started:", task.taskId);
```

## iMessage Conversations

Create engaging conversation-style videos with iPhone message interface.

### Basic Example

```javascript theme={null}
const task = await client.templates.brainrot.iMessage({
	prompt: "Create a funny conversation between two friends about ordering pizza",
	characterPack: "family-guy",
	backgroundVideoPack: "subway-surfers",
	enableImages: true,
});
```

### Parameters

**prompt** `string` *required*

Description of the conversation scenario you want to create

**characterPack** `string` *required*

Character pack for the conversation voices

**backgroundVideoPack** `string` *required*

Background video to play behind the messages

**enableImages** `boolean` (default: false)

Whether to include reaction images/GIFs in messages

### Story Examples

> [tab] Drama
>
> ```javascript theme={null}
> const task = await client.templates.brainrot.iMessage({
>   prompt: "A conversation where someone discovers their best friend is dating their ex",
>   characterPack: "drama-voices",
>   backgroundVideoPack: "minecraft-parkour"
> });
> ```

> [tab] Comedy
>
> ```javascript theme={null}
> const task = await client.templates.brainrot.iMessage({
>   prompt: "Two friends trying to plan a surprise party but everything goes wrong",
>   characterPack: "comedy-duo",
>   backgroundVideoPack: "subway-surfers"
> });
> ```

> [tab] Educational
>
> ```javascript theme={null}
> const task = await client.templates.brainrot.iMessage({
>   prompt: "A student texting their teacher asking for an extension, with increasingly creative excuses",
>   characterPack: "student-teacher",
>   backgroundVideoPack: "satisfying-videos"
> });
> ```

## Reddit Stories

Transform Reddit posts into engaging narrated videos.

### Basic Example

```javascript theme={null}
const task = await client.templates.brainrot.redditStory({
	redditPostUrl: "https://www.reddit.com/r/AmItheAsshole/comments/xyz/...",
	characterPack: "rick-and-morty",
	backgroundVideoPack: "minecraft-parkour",
	enableGifs: false,
});
```

### Parameters

**redditPostUrl** `string` *required*

Full URL of the Reddit post to narrate (must be a valid Reddit URL)

**characterPack** `string` *required*

Character pack for the narration voice

**backgroundVideoPack** `string` *required*

Background video for the narration

**enableGifs** `boolean` (default: false)

Whether to include reaction GIFs during the story

### Popular Subreddits

> [card] r/AmItheAsshole
>
> Moral dilemma stories perfect for commentary

> [card] r/relationship\_advice
>
> Relationship drama and advice scenarios

> [card] r/tifu
>
> "Today I F\*\*\*ed Up" humorous mistake stories

> [card] r/MaliciousCompliance
>
> Satisfying revenge and compliance stories

> [card] r/EntitledParents
>
> Stories about difficult people and situations

> [card] r/ProRevenge
>
> Elaborate revenge story narratives

## Breaking News

Create SpongeBob-style fish reporter breaking news videos.

### Basic Example

```javascript theme={null}
const task = await client.templates.brainrot.newsFish({
	searchTerm: "AI robots take over fast food industry!",
	webhookUrl: "https://your-app.com/webhook",
});
```

### Parameters

**searchTerm** `string` *required*

The breaking news headline or topic to report on

**webhookUrl** `string`

URL to receive completion notification

### News Examples

> [tab] Tech News
>
> ```javascript theme={null}
> const task = await client.templates.brainrot.newsFish({
>   searchTerm: "New iPhone can read your thoughts!"
> });
> ```

> [tab] Viral Trends
>
> ```javascript theme={null}
> const task = await client.templates.brainrot.newsFish({
>   searchTerm: "TikTok dance moves now required in schools!"
> });
> ```

> [tab] Absurd Headlines
>
> ```javascript theme={null}
> const task = await client.templates.brainrot.newsFish({
>   searchTerm: "Local man discovers cats have been plotting world domination!"
> });
> ```

## Character Packs Guide

### Popular Character Packs

> [tab] Rick and Morty
>
> **ID**: `rick-and-morty` **Characters**: Rick Sanchez (cynical scientist), Morty Smith (nervous
> teenager) **Best for**: Educational content, science topics, comedy **Voice style**: Rick's
> condescending explanations, Morty's anxious questions

> [tab] Family Guy
>
> **ID**: `family-guy` **Characters**: Peter Griffin, Stewie Griffin, Brian Griffin **Best for**:
> Comedy content, casual conversations, entertainment **Voice style**: Peter's bumbling
> commentary, Stewie's sophisticated wit

> [tab] South Park
>
> **ID**: `south-park` **Characters**: Various South Park characters **Best for**: Satirical
> content, current events, comedy **Voice style**: Childlike but surprisingly insightful
> commentary

## Background Video Packs

### Gaming Packs

> [accordion] minecraft-parkour
>
> **Duration**: 5-10 minutes of looping content **Style**: First-person Minecraft parkour gameplay
> **Best for**: Educational content, tutorials, long-form content **Vibe**: Engaging,
> activity-focused

> [accordion] subway-surfers
>
> **Duration**: Endless runner gameplay loops **Style**: Colorful, fast-paced mobile game footage
> **Best for**: Quick content, entertainment, conversations **Vibe**: High-energy,
> attention-grabbing

> [accordion] gta-driving
>
> **Duration**: Open-world driving sequences **Style**: Realistic driving through city
> environments **Best for**: Stories, dramatic content, longer narratives **Vibe**: Cinematic,
> immersive

### Satisfying Content

> [accordion] soap-cutting
>
> **Duration**: Various soap cutting and slicing videos **Style**: Close-up, satisfying cutting
> motions **Best for**: Calming content, ASMR-style videos **Vibe**: Relaxing, meditative

> [accordion] slime-videos
>
> **Duration**: Colorful slime manipulation footage **Style**: Tactile, colorful slime stretching
> and molding **Best for**: Satisfying content, stress-relief topics **Vibe**: Therapeutic,
> visually appealing

## Best Practices

> [card] 🎯 Prompt Optimization
>
> * Keep prompts 50-200 words - Be specific about target audience - Include emotional hooks - Use
>   trending topics and keywords

> [card] 🎬 Character Selection
>
> * Match character personality to content tone - Rick & Morty for educational/science content -
>   Family Guy for comedy and entertainment - Consider your target audience's preferences

> [card] 🎮 Background Choice
>
> * Minecraft for educational content - Subway Surfers for quick, punchy content - Satisfying
>   videos for calming topics - Match energy level to content type

> [card] ⚡ Performance Tips
>
> * Use webhooks in production - Start multiple renders in parallel - Cache popular
>   character/background combinations - Monitor render times and optimize

## Common Use Cases

> [tab] Educational Content
>
> ```javascript theme={null}
> // Science education
> const physics = await client.templates.brainrot.educational({
>   prompt: "Explain black holes and how they bend space-time",
>   characterPack: "rick-and-morty",
>   backgroundVideoPack: "minecraft-parkour",
>   enableGifs: true
> });
>
> // History lessons
> const history = await client.templates.brainrot.educational({
>   prompt: "Why did the Roman Empire fall? Explore the key factors",
>   characterPack: "professors",
>   backgroundVideoPack: "satisfying-videos"
> });
> ```

> [tab] Entertainment Content
>
> ```javascript theme={null}
> // Drama stories
> const drama = await client.templates.brainrot.iMessage({
>   prompt: "Someone finds out their roommate has been eating their food",
>   characterPack: "drama-voices",
>   backgroundVideoPack: "subway-surfers"
> });
>
> // Comedy conversations
> const comedy = await client.templates.brainrot.iMessage({
>   prompt: "Two friends debating whether cereal is soup",
>   characterPack: "family-guy",
>   backgroundVideoPack: "minecraft-parkour"
> });
> ```

> [tab] Viral News
>
> ```javascript theme={null}
> // Tech trends
> const tech = await client.templates.brainrot.newsFish({
>   searchTerm: "New AI can predict what you'll order for lunch!"
> });
>
> // Social media trends
> const social = await client.templates.brainrot.newsFish({
>   searchTerm: "Scientists discover the perfect TikTok video length!"
> });
> ```

## Error Handling

```javascript theme={null}
import { GigaReels, ValidationError } from "@gigareels/sdk";

try {
	const task = await client.templates.brainrot.educational({
		prompt: "Explain quantum physics",
		characterPack: "rick-and-morty",
		backgroundVideoPack: "minecraft-parkour",
	});

	console.log("✅ Video generation started:", task.taskId);
} catch (error) {
	if (error instanceof ValidationError) {
		console.log("❌ Validation failed:");
		error.issues.forEach(issue => {
			console.log(`  ${issue.path.join(".")}: ${issue.message}`);
		});
	} else {
		console.log("❌ API error:", error.message);
	}
}
```

## Next Steps

**1. Choose Your Content Type**

Decide between educational, entertainment, or news-style content

**2. Select Characters & Background**

Pick character and background packs that match your content vibe

**3. Write Compelling Prompts**

Create engaging prompts that will resonate with your audience

**4. Add Social Media Integration**

Connect your content to social platforms for automatic posting

Ready to create viral brainrot content? Try the [Quickstart Guide](https://gigareels.mintlify.site/quickstart.md) or explore [Social Media Integration](https://gigareels.mintlify.site/social-media/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.