HypnoTube.com YT-DLP Plugin 🛠️

Introduction 📚

Welcome to the HypnoTube.com YT-DLP Plugin, a specialized tool for augmenting your video downloading experience from HypnoTube.com. This plugin allows you to efficiently fetch individual videos, complete user uploads, entire channels, or even full playlists using yt-dlp.

📝 Note: This plugin and README were largely assisted by OpenAI's GPT-4 model.

Features 🌟

• Individual Video Downloads 🎥: Directly download HypnoTube videos to your machine.
• User Uploads 👤: Download all videos from a specific HypnoTube user.
• Channel (Categories) Downloads 📺: Extract an entire set of videos from a HypnoTube channel (Categories).
• Playlist Downloads 📋: Retrieve all videos from a specified HypnoTube playlist.

Installation Guide for Windows 11 🖥️

⚠️ Note: These installation steps are specifically for Windows 11 and have been tested solely on this platform.

1. Open the Command Prompt (cmd).
2. Navigate to your yt-dlp plugins directory:

cd C:\Users\%username%\AppData\Roaming\yt-dlp\plugins

3. Clone the plugin repository:

git clone https://github.com/Earthworm-Banana/yt-dlp-HypnoTube_com-plugin.git

4. Ensure that BeautifulSoup4 (bs4) is installed:

pip install bs4

Pip Install Method (Tested on a-Shell iOS App) 📱

⚠️ Note: This pip install method has only been tested on the "a-Shell" iOS terminal app.

1. Open your terminal or command line application.
2. Install the plugin and BeautifulSoup4 (bs4) by running:

python3 -m pip install -U https://github.com/Earthworm-Banana/yt-dlp-HypnoTube_com-plugin/archive/refs/heads/master.zip bs4

📘 Note: This pip install method should work on any system that has yt-dlp installed via pip.

For other methods of installing this plugin package, consult installing yt-dlp plugins.

Usage Guidelines 📋

Commands 📜

• Individual Video Download 🎥:

yt-dlp "https://hypnotube.com/video/shock-409.html"

• User Uploads Download 👤:

yt-dlp "https://hypnotube.com/user/ambersis-3082/"

• Channel Download 📺:

yt-dlp "https://hypnotube.com/channels/38/hd/"

• Playlist Download 📋:

yt-dlp "https://hypnotube.com/playlist/93707/stim-gooning/"

🔍 Metadata Extraction

The plugin extracts various types of metadata, including:

• 📝 Video Title
• 🆔 Video ID
• 🗓️ Release Date
• 👤 Uploader
• 👁️ View Count
• ⏰ Video Duration
• 🖼️ Thumbnails

To retrieve thumbnails it may be required to use:

yt-dlp --add-headers "Referer: https://hypnotube.com" [URL]

Limitations and Known Issues ❗

• Metadata Limitations: 📄 Some metadata fields may not populate due to limitations in the information accessible from HypnoTube (or haven't gotten around to implement them).

• Private Video Downloads: 🛑 The plugin cannot download private videos from HypnoTube unless you use cookies from a logged-in session. Note: This has not been thoroughly tested.

• Photo Gallery Downloads: 📷 The plugin is unable to download photo galleries from HypnoTube.

Support and Contributions 🤝

For any inquiries or contributions, please open an issue on GitHub.

Thank you for choosing the HypnoTube.com YT-DLP Plugin. Happy downloading! 🙏