🎵 DownAria

Im here Glad to say. Now this project is open source, you freely to modify, use and fork this repository

• thank you. ~ risunCode

API's Is also Open Sourced!

• The code is shit, ikr
• https://github.com/risunCode/api-xtfetch

Social Media Video Downloader — Free, fast, and easy-to-use tool for downloading videos from social media. No registration, no limits, no BS.

---

📸 Screenshots

Desktop

Home	Playground	Documentation

Settings	About

Mobile

Home	Playground	Documentation	Settings	About

---

✨ Features

Feature	Description
🌐 Multi-Platform	Facebook, Instagram, TikTok, Twitter/X, Weibo, YouTube
🎯 Auto-Detect	Paste any URL, platform detected automatically
🎬 No Watermark	Clean downloads (when available)
📱 Quality Options	HD, SD, or original quality
🔒 No Registration	No account needed for basic usage
🌙 3 Themes	Dark, Light, Solarized (auto by time)
📜 History	Track downloads locally (IndexedDB)
⚡ Fast	Direct scraping, no middleman
🎨 Seasonal Effects	Custom backgrounds, particles
🔔 Discord Webhook	Auto-send downloads to Discord
🤖 AI Chat	Built-in AI assistant (Gemini/GPT)
📦 PWA	Install as app on mobile/desktop

---

🎯 Supported Platforms

Platform	Status	Method	Cookie Required
Facebook	✅ Active	HTML Scraping	Stories, Groups
Instagram	✅ Active	GraphQL API	Private posts
Twitter/X	✅ Active	Syndication + GraphQL	Age-restricted
TikTok	✅ Active	TikWM API	No
Weibo	✅ Active	Mobile API	Always
YouTube	✅ Active	yt-dlp	No

---

🚀 Quick Start

# Clone
git clone https://github.com/user/DownAria.git
cd DownAria

# Install
npm install

# Setup environment
cp .env.example .env
# Edit .env with your credentials

# Run
npm run dev

Open http://localhost:3001 🎉

---

📦 Tech Stack

Category	Technology
Framework	Next.js 16 (App Router, Turbopack)
Language	TypeScript 5
Styling	Tailwind CSS 4
Animation	Framer Motion
Database	Supabase (PostgreSQL)
Cache	Redis (Upstash)
Storage	IndexedDB + LocalStorage
Icons	Lucide + FontAwesome
Alerts	SweetAlert2

---

💾 Storage Architecture

DownAria uses a unified storage system with 5 keys:

Key	Type	Purpose
downaria_settings	LocalStorage	All user preferences
downaria_cookies	LocalStorage (Encrypted)	Platform cookies
downaria_seasonal	LocalStorage	Seasonal theme settings
downaria_queue	LocalStorage	Pending download queue
downaria_ai	LocalStorage	AI chat sessions

Plus IndexedDB for:

• downaria_db → Download history (unlimited)
• downaria_seasonal_db → Custom background files

---

🎨 Themes

Theme	Description
🌙 Dark	GitHub-style dark
☀️ Light	Clean white
🌅 Solarized	Warm cream
🔄 Auto	Dark at night, Solarized at day

---

🔐 Security

• Encrypted cookie storage (XOR + HMAC)
• Browser fingerprint as encryption key
• No sensitive data in production logs
• CORS protection on API routes

---

🌐 Deployment

Vercel (Recommended)

npm run build
vercel deploy

Docker

docker build -t downaria .
docker run -p 3001:3001 downaria

---

⚠️ Limitations

Limitation	Description
🔒 Public Only	Private posts require valid cookies
🎲 Platform Changes	Scrapers may break when platforms update
🍪 Cookie Expiry	Cookies expire, need periodic refresh

---

🚨 Disclaimer

⚠️ For personal use only

• Using cookies for scraping may violate platform ToS
• Don't spam requests, respect rate limits
• We are not affiliated with any platform

---

📄 License

GPL-3.0 — Free to use, modify, and distribute.

---

Made with ❤️