# 🔗 URL Parameter Auto-Download Feature

## Usage

You can now share download links that auto-populate the form and start downloading immediately!

### Basic URL Parameter
```
https://vdq.boxicube.com/?url=https://www.instagram.com/reels/DQ9uYDHEY81/
```

Opens the app with Instagram URL pre-filled and auto-starts download.

### With Custom Filename
```
https://vdq.boxicube.com/?url=https://www.instagram.com/reels/DQ9uYDHEY81/&filename=my-video
```

Pre-fills both URL and custom filename.

### Examples

#### Instagram
```
https://vdq.boxicube.com/?url=https://www.instagram.com/reels/DQ9uYDHEY81/&filename=instagram-clip
```

#### Twitter/X
```
https://vdq.boxicube.com/?url=https://x.com/NASA/status/1234567890&filename=space-news
```

#### Rumble
```
https://vdq.boxicube.com/?url=https://rumble.com/v78f0le-video-title.html
```

#### YouTube
```
https://vdq.boxicube.com/?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ
```

#### TikTok
```
https://vdq.boxicube.com/?url=https://www.tiktok.com/video/1234567890
```

---

## Parameters

| Parameter | Required | Example |
|-----------|----------|---------|
| `url` | ✅ Yes | `https://www.instagram.com/reels/...` |
| `filename` | ❌ Optional | `my-video` (no extension needed) |
| `platform` | ❌ Optional | `instagram`, `twitter`, `youtube` |

---

## How It Works

1. **URL is detected** - App opens with the URL parameter pre-filled
2. **Platform auto-detected** - Instagram, Twitter, Rumble, etc. automatically recognized
3. **Download starts** - After 500ms, download begins automatically
4. **File saves** - Video saves to the platform subfolder with your custom filename

---

## Use Cases

### Share with Friends
Send them a direct link:
```
https://vdq.boxicube.com/?url=https://www.instagram.com/reels/DQ9uYDHEY81/&filename=funny-clip
```

Friend clicks → Opens → Downloads automatically ✅

### Batch Downloads
Create a list of URLs in a file and open each:
```
https://vdq.boxicube.com/?url=https://x.com/user/status/123&filename=tweet1
https://vdq.boxicube.com/?url=https://x.com/user/status/456&filename=tweet2
https://vdq.boxicube.com/?url=https://x.com/user/status/789&filename=tweet3
```

### Bookmarklets (Advanced)
Create a JavaScript bookmarklet to download the current page:
```javascript
javascript:(function(){
  const url = prompt('Enter video URL:');
  if(url) {
    const encoded = encodeURIComponent(url);
    window.open('https://vdq.boxicube.com/?url=' + encoded);
  }
})();
```

---

## Technical Details

The server:
1. Receives the `?url=` parameter
2. Reads the HTML file
3. Injects a JavaScript that:
   - Pre-fills the media URL field
   - Pre-fills the filename (if provided)
   - Waits 500ms for page to load
   - Clicks the download button automatically

Everything happens on the client side after injection - no server-side download processing needed initially.

---

## Browser Compatibility

✅ Works in all browsers (no special requirements)

---

## Examples - Share These Links

### Instagram Reel
```
https://vdq.boxicube.com/?url=https://www.instagram.com/reels/DQ9uYDHEY81/
```

### Twitter Video
```
https://vdq.boxicube.com/?url=https://x.com/NASA/status/1234567890
```

### Rumble Video
```
https://vdq.boxicube.com/?url=https://rumble.com/v78f0le.html
```

### YouTube Video
```
https://vdq.boxicube.com/?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ
```

---

**Pro Tip:** URL encode special characters if sharing in emails or Slack!