clawdbot-workspace/surya-manim-v2/README.md

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)

./render.sh --single Track01Skin

Render all tracks

./render.sh

Combine into full album video

./render.sh --concat

List available tracks

./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:

# 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)

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