a friendly media downloader for the web ✨
sodalite is an open-source, no-fuss downloader with real-time stats and a clean interface. paste a link from a supported service, choose your quality and format, receive the file download. that's it. 🎯
- paste any supported link and get download options instantly
- clean, mobile-friendly interface with cozy brown cottage theme 🏡
- no accounts, no ads, no tracking - just downloads
- live server status with heartbeat monitoring 💓
- connected clients counter via websockets
- total downloads and bandwidth tracking
- persistent stats that survive server restarts
- video, audio-only, or muted download modes
- multiple quality options for both video and audio
- format selection (mp4, webm, mkv, mp3, m4a)
- background processing with download queue
- responsive dialog and interface
- touch-friendly controls
- works seamlessly on all devices
- tiktok → videos and audio extraction
- youtube → videos, shorts, and music
- instagram reels → full quality downloads
- ... more coming soon! 🚀
- copy a link from any supported service
- paste it into sodalite
- choose your preferred quality and format
- download your file
the download manager shows real-time progress and you can queue multiple downloads.
Base URL:
https://backend.otter.llc:1335/
| Method | Endpoint | Description |
|---|---|---|
POST |
/sodalite/download |
Get media metadata and available formats |
POST |
/sodalite/process |
Start download processing job |
GET |
/sodalite/task/{task_id} |
Check task status and progress |
GET |
/sodalite/download/{task_id}/file |
Download the processed file |
| Method | Endpoint | Description |
|---|---|---|
GET |
/sodalite/health |
Server health check and status |
GET |
/sodalite/git-info |
Git repository information |
GET |
/sodalite/services |
List all supported services |
WS |
/sodalite/ws/stats |
Real-time statistics websocket |
- next.js 15 with react 19
- tailwindcss 4 with a custom cozy theme 🎨
- framer-motion for smooth animations
- radix-ui components
- axios for api communication
- websockets for real-time updates
- fastapi with async/await
- yt-dlp for youtube downloads
- aiohttp for http requests
- ffmpeg for media processing
- websockets for live statistics
- file-based persistence for statistics
this project is provided for demonstration and educational purposes only. its use may be subject to legal considerations depending on your location. the author(s) and contributors are not responsible for any outcomes from using, sharing, or modifying this software. users should ensure they follow applicable laws and regulations. proceed at your own discretion.
- clone the repository
git clone https://github.com/oterin/sodalite.git
cd sodalite- set up the backend
cd server
pip install -r requirements.txt
python run.py- set up the frontend
cd frontend
npm install
npm run devthe project is designed to be deployed on:
- backend → any python hosting service
- frontend → vercel (or similar)
- requirements → ffmpeg installed on server
pull requests welcome! please:
- check existing issues before opening new ones
- follow the existing code style
- test your changes thoroughly
- update documentation as needed
- yt-dlp → youtube download backend
- fastapi → modern python api framework
- next.js → react framework
- tailwindcss → utility-first css
this project primarily relies on traditional programming approaches. artificial intelligence tools have been utilized in various supporting capacities throughout the development process. all core functionality is human-authored. models used: claude opus 4, gemini 2.5 pro.
MIT License
Copyright (c) 2025 Milan Oterin
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.