DieselRipper Files

# DieselRipper v6.1.5 READ THIS FIRST
You only need to download the following file to use DieselRipper:
DieselRipper6.1.5.exe
Everything else in this folder (source code, PNGs, logo, ffmpeg tools, config files) is included only to meet SourceForge hosting policy.

**Enhanced Video Downloader & Processor**

![DieselRipper Logo](dieselripper_logo.png)

## ⚖️ **LEGAL NOTICE**
**FOR LAWFUL USE ONLY.** This software is intended for downloading and processing content that you have the legal right to access, download, and modify. Users are solely responsible for ensuring their use complies with applicable copyright laws, platform terms of service, and local regulations. The creator is not responsible for any unlawful use of this software.

---

## 🎯 **What is DieselRipper?**

DieselRipper is a powerful, user-friendly application that allows you to download videos from popular platforms and process local video files with professional-grade tools. Whether you're archiving content you own, processing local videos, or creating compilations, DieselRipper provides a comprehensive solution with a beautiful, customizable interface.

---

## ✨ **Key Features**

### **📥 Video Downloading**
- Download from YouTube, Twitter/X, Instagram, TikTok, Facebook, and more
- High-quality video downloads up to 1080p
- Audio-only extraction (MP3, 192kbps)
- Batch download queue management
- Custom naming for downloaded files

### **🎬 Video Processing**
- **Local File Processing**: Process videos already on your computer
- **Video Stitching**: Combine multiple videos into one seamless file
- **Black Background Addition**: Add letterboxing for consistent aspect ratios
- **Format Conversion**: Convert videos to MP4 with H.264 encoding
- **Quality Control**: Choose resolution and encoding settings

### **🎨 Customization**
- **130+ Team Themes**: College football and NFL team color schemes
- **Custom Logo Support**: Add your own branding
- **Queue Management**: Import/export URL lists and file lists
- **Flexible Naming**: Custom file naming with date stamps

### **🔧 Advanced Features**
- **FFmpeg Integration**: Professional video processing engine
- **Transcoder Support**: Send files to external processing workflows
- **Analytics Dashboard**: Track download statistics and success rates
- **Database Storage**: Automatic download history and analytics

---

## 🚀 **How to Use**

### **Basic Video Download:**
1. **Choose Folder**: Click "Choose Download Folder" to select where files are saved
2. **Add URLs**: Enter video URLs in the text field
3. **Custom Names**: Optionally add custom names for your downloads
4. **Select Options**: Choose MP3-only, video quality, or processing options
5. **Start Download**: Click "START DOWNLOAD" to begin

### **Local File Processing:**
1. **Switch to Local Files Tab**: Click the "Local Files" tab
2. **Choose Output Folder**: Select where processed files will be saved
3. **Browse Files**: Click "Browse Files" to select videos from your computer
4. **Select Processing**: Choose MP3 extraction, background addition, or stitching
5. **Start Processing**: Click "START PROCESSING" to begin

### **Video Stitching:**
1. **Add Multiple Videos**: Add several URLs to the download queue OR multiple local files
2. **Enable Stitching**: Check the "STITCH VIDEOS" option
3. **Custom Name**: Enter a name for the final stitched video
4. **Process**: All videos will be combined into one seamless file

### **Theme Customization:**
1. **Visit Themes Tab**: Browse 130+ college and pro team themes
2. **Quick Access**: Use the Themes menu for featured teams
3. **Apply Theme**: Click any team button to change colors instantly

---

## 💻 **System Requirements**

- **Operating System**: Windows 10/11 (64-bit recommended)
- **Memory**: 4GB RAM minimum, 8GB recommended
- **Storage**: 100MB for application, additional space for downloads
- **Internet**: Required for downloading videos
- **Optional**: FFmpeg bundled for video processing

---

## 📁 **File Organization**

DieselRipper uses a smart naming convention:
```
MM-DD-YY PLATFORM CustomName.ext
```

**Examples:**
- `06-04-25 YT My Video.mp4` (YouTube download)
- `06-04-25 IG Story.mp3` (Instagram audio)
- `06-04-25 LOCAL Processed Video.mp4` (Local file)
- `06-04-25 STITCHED Compilation.mp4` (Stitched videos)

---

## 🎛️ **Advanced Options**

### **Download Options:**
- **MP3 ONLY**: Extract audio in high-quality MP3 format
- **ADD BLACK BACKGROUND**: Add letterboxing for consistent 16:9 format
- **SEND TO TRANSCODER**: Forward files to external processing pipeline
- **STITCH VIDEOS**: Combine multiple downloads into one video

### **Quality Settings:**
- **480p, 720p, 1080p**: Choose video resolution
- **Best Available**: Download highest quality available
- **Audio Quality**: 192kbps MP3 for excellent sound quality

### **Queue Management:**
- **Import URLs**: Load URLs from text files
- **Export Queue**: Save your download list
- **Batch Processing**: Handle multiple downloads efficiently

---

## 🛡️ **Privacy & Security**

- **Local Processing**: All video processing happens on your computer
- **No Data Collection**: DieselRipper doesn't send usage data anywhere
- **Secure Downloads**: Uses yt-dlp, a trusted open-source downloader
- **Cache Management**: Built-in cache clearing for privacy

---

## 🆘 **Troubleshooting**

### **Downloads Failing:**
- Check your internet connection
- Verify the URL is correct and publicly accessible
- Try clearing cache: Tools → Clear Cache

### **Processing Errors:**
- Ensure you have enough disk space
- Check that video files aren't corrupted
- Try processing one file at a time

### **FFmpeg Issues:**
- FFmpeg is bundled with the application
- Test functionality: Tools → Test FFmpeg
- Restart the application if processing fails

---

## 📈 **Analytics**

Visit the Analytics tab to view:
- Total downloads and success rate
- Downloaded file sizes and statistics
- Session information and queue status
- Database-powered insights

---

## 🎨 **Team Themes**

DieselRipper includes themes for:
- **All 130+ FBS College Football Teams**
- **All 32 NFL Teams**
- **Featured Teams**: Oklahoma, Miami, North Carolina, North Texas, Indianapolis, Dallas

Each theme changes the entire interface color scheme to match your favorite team!

---

## 📄 **File Formats Supported**

### **Download Formats:**
- **Video**: MP4, WebM, MKV (converted to MP4)
- **Audio**: MP3, AAC, M4A (converted to MP3)

### **Local File Support:**
- **Input**: MP4, AVI, MOV, MKV, WebM, M4V, FLV, 3GP
- **Output**: MP4 (H.264), MP3 (192kbps)

---

## 🔄 **Updates**

DieselRipper automatically displays its current version and includes update checking functionality. Visit the Help menu to check for the latest version.

---

## 📞 **Support**

If you encounter issues:
1. Check the black log area at the bottom for error messages
2. Review this ReadMe for troubleshooting steps
3. Ensure you're using the software lawfully and responsibly
---

## 📋 **Version History**

**v6.1.5 (Current)**
- Enhanced video stitching with perfect audio sync
- Removed trim feature for improved stability
- Improved UI
---
**Remember: Always respect copyright laws and platform terms of service. Use DieselRipper responsibly and only for content you have the right to download and process.**