Tetsuo DL - YouTube Video Downloader

A browser extension for downloading YouTube videos. Powered by $TETSUO.

About

Tetsuo DL is powered by $TETSUO on Solana.

Contract Address (CA): 8i51XNNpGaKaj4G4nDdmQh95v4FKAxw8mhtaRoKd9tE8

Visit www.tetsuo.ai for more information.

Features

• Multiple quality options - Download videos in various formats and resolutions
• Custom filenames - Name your downloads exactly how you want them
• Download queue - Add multiple videos to queue for batch downloading
• Download history - Track previous downloads and easily re-download them
• Custom download locations - Choose where to save your files
• Dark mode - Easy on the eyes with a stylish dark theme option
• Progress tracking - See real-time download progress with time estimates
• Automatic updates - Keep yt-dlp up to date for best compatibility
• User preferences - Your settings are remembered between sessions

Screenshots

Installation

Step 1: Install the Backend

1. Clone this repository or download it as a ZIP file
2. Run install-win.bat as Administrator (right-click → Run as administrator)
3. Wait for the installation to complete
   • This will install yt-dlp, Node.js, and set up the required server
   • The installer automatically creates startup entries so the server runs on boot

Step 2: Install the Browser Extension

1. Open Chrome and go to chrome://extensions/
2. Enable "Developer mode" in the top-right corner
3. Click "Load unpacked" and select the extension folder from this repository
4. The Tetsuo DL extension should now appear in your browser toolbar

Usage

Basic Download

1. Navigate to any YouTube video
2. Click the Tetsuo DL extension icon in your browser toolbar
3. The video thumbnail and details will appear in the popup
4. Select your preferred quality format from the dropdown
5. Click "Download"
6. The video will be downloaded to your selected folder

Advanced Features

Custom Filename

Enter a custom name in the filename field before downloading to override the default name.

Download Queue

Videos are added to a queue and processed one at a time. View and manage your queue in the Queue tab.

Download History

All your downloads are saved in the History tab. Click the refresh icon to re-download any previous video.

Settings

Configure your preferences in the Settings tab:

• Default download format
• Auto-add to queue option
• Auto-close popup option
• Notification preferences
• yt-dlp updates

Dark Mode

Toggle the moon icon in the top-right corner to switch between light and dark themes.

Directory Structure

tetsuo-dl/
├── extension/                   # Browser extension folder
│   ├── images/                  # Extension icons and images
│   ├── popup.html              # Main extension UI
│   ├── popup.js                # Main extension functionality
│   ├── background.js           # Background service worker
│   ├── styles.css              # Enhanced styling
│   ├── start-server.html       # Server startup page
│   └── manifest.json           # Extension manifest
│
│
├── install-win.bat         # Windows installer script
├── README.md               # Documentation
├── server.js               # Backend server code
└── package.json            # Node.js dependencies

Troubleshooting

Server Not Running

If the downloads aren't starting, the server might not be running:

1. Check if there's a Node.js process in Task Manager
2. Try manually running %LOCALAPPDATA%\TetsuoDL\start-server.bat
3. Re-run the installer as administrator

Format Issues

If a specific quality option isn't working:

1. Try a different format option
2. Check for yt-dlp updates in the Settings tab
3. Some videos may have format restrictions due to content protection

Installation Problems

If you encounter installation issues:

1. Make sure you're running the installer as administrator
2. Check that you have internet access for downloading dependencies
3. Make sure port 17171 is not blocked by your firewall

Keyboard Shortcuts

• Ctrl+Shift+Y: Open the Tetsuo DL extension popup
• Enter (when popup is open): Start download with current settings

Technical Details

The extension works by communicating with a local Node.js server running on port 17171. This server uses yt-dlp to handle the actual video downloading while providing a clean, user-friendly interface for managing downloads.

Requirements

• Windows 7 or higher
• Google Chrome, Microsoft Edge, or other Chromium-based browser
• Administrator access (for installation only)

License

This project is available under the MIT License.

Disclaimer

This tool is for personal use only. Downloading copyrighted content without permission may violate YouTube's Terms of Service. Use responsibly and respect content creators' rights.