A modern, blazing-fast web application that converts videos from 1000+ sites to high-quality MP3 files with a beautiful, responsive interface.
TubeConv supports over 1000 video platforms thanks to the powerful yt-dlp backend, including:
- 🎥 YouTube - The world's largest video platform
- 📱 TikTok - Short-form videos and trending content
- 📷 Instagram - Stories, reels, and posts
- 🎬 Vimeo - Professional video hosting
- 🎮 Twitch - Gaming streams and clips
- 📘 Facebook - Social media videos
- 🐦 Twitter/X - Tweet videos and clips
- 🎪 Dailymotion - European video platform
- 🎧 SoundCloud - Music and audio content
- 💬 Reddit - Community videos
And hundreds more! See the complete list of supported sites for all platforms.
- Auto Light/Dark Theme: Automatically adapts to your system preference
- Glassmorphic Design: Beautiful, modern UI with backdrop blur effects
- Fully Responsive: Works seamlessly on desktop, tablet, and mobile
- Intuitive UX: Simple 3-step process with visual guidance
- Multiple Bitrates: 128, 192, 256, and 320 kbps options
- Custom Metadata: Add custom title and artist information
- Thumbnail Preview: See video thumbnail during conversion
- Format Support: High-quality MP3 output with proper encoding
- Real-time Progress: Live conversion status with animated indicators
- Auto-cleanup: Smart file management with automatic deletion
- Fast Processing: Optimized backend with efficient handling
- Background Tasks: Non-blocking conversion process
- RESTful API: Complete API documentation with Swagger
- Docker Support: Containerized deployment ready
- CI/CD Pipeline: Automated testing and deployment
- Comprehensive Tests: Full test coverage for reliability
The fastest way to get started:
# Run with Docker (no dependencies needed!)
docker run -d --name tubeconv -p 3000:3000 fabriziosalmi/tubeconv:latest
# Open http://localhost:3000 and start converting! 🎉Ensure you have these installed:
| Requirement | Version | Installation |
|---|---|---|
| Node.js | v14+ | Download |
| yt-dlp | Latest | pip install yt-dlp or brew install yt-dlp |
| ffmpeg | Latest | brew install ffmpeg or Download |
# Clone the repository
git clone https://github.com/fabriziosalmi/tubeconv.git
cd tubeconv
# Install dependencies
npm install
# Start the application
npm start🎉 That's it! Open http://localhost:3000 and start converting!
⚠️ Important: TubeConv is designed for personal use and educational purposes only. Please ensure you have the right to download and convert content from any platform. Respect copyright laws, terms of service, and content creators' rights. Users are solely responsible for compliance with applicable laws and regulations in their jurisdiction.
- Paste Video URL - Copy any video URL from supported sites (YouTube, TikTok, Instagram, etc.)
- Click Convert to MP3 - Choose your preferred audio quality (128-320 kbps)
- Download MP3 - Get your high-quality audio file
// Convert videos from any supported platform
const response = await fetch('/api/convert', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ', // YouTube
// url: 'https://www.tiktok.com/@user/video/1234567890', // TikTok
// url: 'https://vimeo.com/123456789', // Vimeo
audioQuality: '320'
})
});
const result = await response.json();
console.log('Download URL:', result.downloadUrl);| Method | Endpoint | Description |
|---|---|---|
POST |
/api/convert |
Convert YouTube video to MP3 |
GET |
/api/preview |
Get video information and thumbnail |
GET |
/api/health |
Health check endpoint |
GET |
/api-docs |
Interactive Swagger documentation |
{
"success": true,
"videoTitle": "Amazing Song Title",
"thumbnailUrl": "https://img.youtube.com/vi/VIDEO_ID/maxresdefault.jpg",
"duration": "3:45",
"downloadUrl": "http://localhost:3000/downloads/unique-file.mp3",
"audioQuality": "320",
"processingTime": "2.3s"
}tubeconv/
├── 📄 package.json # Dependencies and scripts
├── 🖥️ server.js # Express.js backend
├── 🌐 public/ # Frontend assets
│ ├── 📝 index.html # Main application
│ ├── 🎨 styles.css # Modern CSS with themes
│ ├── ⚙️ script.js # Frontend logic
│ ├── 🔧 manifest.json # PWA manifest
│ └── 👷 sw.js # Service worker
├── 🐳 Dockerfile # Container configuration
├── ⚡ docker-compose.yml # Development environment
├── 🧪 tests/ # Test suites
├── 📋 swagger.json # API documentation
└── 📖 README.md # This file
The easiest way to run TubeConv is using our pre-built Docker image from Docker Hub:
# Pull and run the latest version
docker run -d \
--name tubeconv \
-p 3000:3000 \
--restart unless-stopped \
fabriziosalmi/tubeconv:latest
# Access at http://localhost:3000| Tag | Description | Size |
|---|---|---|
fabriziosalmi/tubeconv:latest |
Latest stable release | ~150MB |
Create a docker-compose.yml file:
version: '3.8'
services:
tubeconv:
image: fabriziosalmi/tubeconv:latest
container_name: tubeconv
ports:
- "3000:3000"
environment:
- NODE_ENV=production
- PORT=3000
volumes:
- tubeconv_downloads:/app/downloads
- tubeconv_temp:/app/temp
restart: unless-stopped
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:3000/api/health"]
interval: 30s
timeout: 10s
retries: 3
start_period: 5s
volumes:
tubeconv_downloads:
tubeconv_temp:Then run:
docker-compose up -dIf you want to build from source:
# Clone the repository
git clone https://github.com/fabriziosalmi/tubeconv.git
cd tubeconv
# Build the image
docker build -t tubeconv .
# Run your custom build
docker run -p 3000:3000 tubeconvOur Docker images support multiple architectures:
linux/amd64(Intel/AMD 64-bit)linux/arm64(ARM 64-bit, Apple M1/M2, Raspberry Pi 4)
Configure the container with these environment variables:
| Variable | Default | Description |
|---|---|---|
PORT |
3000 |
Server port |
NODE_ENV |
production |
Environment mode |
CLEANUP_INTERVAL |
3600000 |
File cleanup interval (ms) |
FILE_RETENTION |
1800000 |
File retention time (ms) |
To persist downloads and avoid losing files:
docker run -d \
--name tubeconv \
-p 3000:3000 \
-v tubeconv_downloads:/app/downloads \
-v tubeconv_temp:/app/temp \
fabriziosalmi/tubeconv:latestTo update to the latest version:
# Stop and remove the old container
docker stop tubeconv && docker rm tubeconv
# Pull the latest image
docker pull fabriziosalmi/tubeconv:latest
# Start with the new image
docker run -d \
--name tubeconv \
-p 3000:3000 \
--restart unless-stopped \
fabriziosalmi/tubeconv:latestContainer won't start
# Check container logs
docker logs tubeconv
# Check if port is already in use
docker run -p 8080:3000 fabriziosalmi/tubeconv:latestPermission issues
# Run with specific user
docker run --user 1001:1001 -p 3000:3000 fabriziosalmi/tubeconv:latestPerformance issues
# Allocate more resources
docker run -m 512m --cpus 2 -p 3000:3000 fabriziosalmi/tubeconv:latest# Run all tests
npm test
# Run with coverage
npm run test:coverage
# Run integration tests
npm run test:integration
# Watch mode for development
npm run test:watch- 128 kbps: Good quality, smaller files (~1MB/minute)
- 192 kbps: Better quality, balanced size (~1.5MB/minute)
- 256 kbps: Great quality, larger files (~2MB/minute)
- 320 kbps: Best quality, largest files (~2.5MB/minute) ⭐ Default
- Auto-cleanup: Files deleted after 30 minutes
- Storage limit: Configurable maximum storage usage
- Batch processing: Multiple conversions handled efficiently
# Start with hot reload
npm run dev
# Run linting
npm run lint
# Format code
npm run format
# Build for production
npm run build- 🍴 Fork the repository
- 🌿 Create a feature branch (
git checkout -b feature/amazing-feature) - 💫 Make your changes with proper tests
- ✅ Ensure all tests pass (
npm test) - 📝 Update documentation if needed
- 🚀 Create a Pull Request
❌ Command not found: yt-dlp
# Install yt-dlp
pip install yt-dlp
# or
brew install yt-dlp
# Verify installation
yt-dlp --version❌ Command not found: ffmpeg
# Install ffmpeg
brew install ffmpeg
# or download from https://ffmpeg.org/
# Verify installation
ffmpeg -version❌ Port already in use
# Use different port
PORT=8080 npm start
# Or kill existing process
lsof -ti:3000 | xargs kill -9❌ Conversion fails
- Verify the YouTube URL is accessible
- Check if video is private/restricted
- Test with yt-dlp directly:
yt-dlp --get-title "YOUR_YOUTUBE_URL" - Check server logs for detailed errors
| Browser | Version | Status |
|---|---|---|
| Chrome | 70+ | ✅ Fully Supported |
| Firefox | 65+ | ✅ Fully Supported |
| Safari | 12+ | ✅ Fully Supported |
| Edge | 79+ | ✅ Fully Supported |
- ✅ URL Validation: Strict YouTube URL validation
- ✅ File Isolation: Temporary files in secure directories
- ✅ Auto-cleanup: Prevents storage exhaustion
- ✅ CORS Protection: Proper cross-origin configuration
- ✅ Rate Limiting: Prevents abuse and overload
- ✅ Input Sanitization: All inputs properly validated
- ⚡ Conversion Speed: ~10-30 seconds per video
- 💾 Memory Usage: ~50-100MB average
- 🗄️ Storage: Auto-managed with cleanup
- 🔄 Concurrent Users: Supports multiple simultaneous conversions
This project is licensed under the MIT License - see the LICENSE file for details.
Important: This tool is for personal use only. Please respect:
- 📋 YouTube's Terms of Service
- ©️ Copyright laws and intellectual property rights
- 🎵 Only download content you have permission to use
- 🌍 Local laws and regulations regarding content downloading
Made with ❤️ by Fabrizio Salmi
- 📖 Check this README for common solutions
- 🔍 Search existing issues
- 🐛 Create a new issue with details
- 💬 Join our discussions
- yt-dlp team for the amazing YouTube downloader
- ffmpeg contributors for audio processing capabilities
- Open source community for inspiration and feedback
⭐ If you find this project useful, please give it a star! ⭐