# SURYA - Epic Manim Animation

Mind-blowing 3D visualizations for Das's debut album **SURYA**.

## Project Structure

```
surya-manim-v2/
├── surya_epic.py      # Main Manim animation (14 tracks)
├── render.sh          # Render pipeline script
├── audio/             # 25-second audio clips per track
│   ├── 01_skin.mp3
│   ├── 02_u_saved_me.mp3
│   └── ...
└── output/            # Final rendered videos with audio
```

## Quick Start

### Render a single track (for testing)
```bash
./render.sh --single Track01Skin
```

### Render all tracks
```bash
./render.sh
```

### Combine into full album video
```bash
./render.sh --concat
```

### List available tracks
```bash
./render.sh --list
```

## Track Visuals

| # | Track | Visualization |
|---|-------|---------------|
| 1 | Skin (Intro) | 3D morphing parametric surfaces |
| 2 | U Saved Me | Particles coalescing into sacred geometry |
| 3 | Nothing | 3D Voronoi explosion, fragments in void |
| 4 | Sweet Relief | Ghost spirals in 3D, ethereal particles |
| 5 | Tiptoe | 3D Lissajous curves |
| 6 | Nature's Call | 3D fractal tree with leaves |
| 7 | Dreamcatcher | Sacred geometry web, rotating |
| 8 | IDK | 3D Lorenz attractor with trails |
| 9 | **With U** | **TWO SOULS ORBITING** ✨ THE TURN ✨ |
| 10 | Poor You Poor Me | Drifting polyhedra, bittersweet |
| 11 | Wait 4 U | Concentric pulsing spheres |
| 12 | Run to U | Speed lines + collision burst |
| 13 | Medications | Chaos attractor, red pulsing |
| 14 | Hollow | Golden spiral to moon, epic pullback |

## Color Palette

Matching the SURYA website:
- Deep purple: `#1a0a2e`
- Skin (Pink): `#f472b6`
- U Saved Me (Cyan): `#22d3ee`
- Nothing (Grey): `#666666`
- Sweet Relief (Purple): `#a78bfa`
- Nature's Call (Teal): `#5eead4`
- Dreamcatcher (Soft purple): `#c4b5fd`
- **With U (GOLD)**: `#fbbf24` ← THE TURN
- Poor You (Orange): `#fb923c`
- Medications (Red): `#ef4444`
- Hollow (Gold): `#fbbf24`

## Key Features

### ✅ Text Never Covers Graphics
- Titles in top-left corner (`to_corner(UL)`)
- Subtitles at bottom edge (`to_edge(DOWN)`)
- Text fades in/out smoothly, doesn't persist

### ✅ LaTeX Equations
Each track shows the mathematical beauty:
- Parametric surface equations
- Golden ratio formula
- Lorenz attractor system
- Gravity/orbital mechanics

### ✅ 3D ThreeDScene Animations
All tracks use `ThreeDScene` with:
- Ambient camera rotation
- 3D objects (spheres, polyhedra, surfaces)
- Depth and perspective

### ✅ Audio-Synced
Best 25-second segments extracted from each song with fade in/out.

## Manual Render Commands

For individual control:

```bash
# Render single track at 1080p60
manim -pqh --fps 60 surya_epic.py Track09WithU

# Low quality preview
manim -pql surya_epic.py Track01Skin

# Add audio manually
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -shortest output.mp4
```

## Requirements

- Python 3.8+
- Manim Community v0.17+
- FFmpeg
- scipy (for Voronoi calculations)

```bash
pip install manim scipy
```

## Album Info

**SURYA** by Das
- 14 tracks
- The emotional arc: vulnerability → salvation → void → THE TURN → resolution
- Track 9 "With U" is THE TURN where everything changes
