2026-02-05 23:01:36 -05:00

129 lines
3.1 KiB
Markdown

# 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