Skip to content

HYDRA-TERMUX/tubegrab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 TubeGrab - YouTube Downloader for Termux

TubeGrab Banner



GitHub stars GitHub forks GitHub issues GitHub license

Made with Bash Works on Termux Powered by yt-dlp

🎬 Colorful YouTube Video & MP3 Downloader for Termux

FeaturesInstallationUsageDocumentationFAQ


✨ Features

🎥 Video Downloads

  • Best Quality (4K/8K/2K - Maximum Available)
  • 4K Ultra HD (2160p)
  • 2K Quad HD (1440p)
  • 1080p Full HD
  • 720p HD Ready
  • 480p SD
  • 360p Low Quality
  • Custom Format Selection

🎵 MP3 Downloads

  • 320 kbps (Best)
  • 256 kbps (High)
  • 192 kbps (Medium)
  • 128 kbps (Standard)
  • 96 kbps (Low)

🎨 Beautiful Interface

  • Colorful gradient banner
  • Easy-to-use menu system
  • Real-time download progress
  • Color-coded status messages

Advanced Features

  • Auto-dependency installation
  • Format selection guide
  • Video information display
  • Smart file merging
  • Update checker

📋 Requirements

  • Android device (5.0+)
  • Termux app (F-Droid or GitHub)
  • Storage permission
  • Internet connection

🚀 Installation

⚡ Quick Install (Single Command) - RECOMMENDED

Copy and paste this one-liner in Termux:

bash <(curl -fsSL https://raw.githubusercontent.com/HYDRA-TERMUX/tubegrab/main/setup.sh)

This will automatically:

  • ✅ Update Termux
  • ✅ Install all dependencies (Python, FFmpeg, yt-dlp)
  • ✅ Download TubeGrab
  • ✅ Setup storage permissions
  • ✅ Create organized folders
  • ✅ Ready to use!


Method 2: Git Clone (Alternative)

# Install git if not already installed
pkg install git -y

# Clone the repository
git clone https://github.com/HYDRA-TERMUX/tubegrab.git

# Navigate to the directory
cd tubegrab

# Make the script executable
chmod +x youtube-downloader.sh

# Run the script
./youtube-downloader.sh

Method 3: Manual Installation

# Update packages
pkg update && pkg upgrade -y

# Install required packages
pkg install python ffmpeg -y

# Install yt-dlp
pip install yt-dlp

# Download the script
curl -O https://raw.githubusercontent.com/HYDRA-TERMUX/tubegrab/main/youtube-downloader.sh

# Make it executable
chmod +x youtube-downloader.sh

# Run the script
./youtube-downloader.sh

Method 4: Direct Script Download (One-liner)

curl -fsSL https://raw.githubusercontent.com/HYDRA-TERMUX/tubegrab/main/install.sh | bash

💡 Usage

Starting the Program

./youtube-downloader.sh

📚 For detailed usage guide, see USAGE.md

Download Video

  1. Select option [1] from the main menu
  2. Enter the YouTube video URL
  3. Choose your preferred quality
  4. Wait for the download to complete
  5. Find your video in /sdcard/TubeGrab/Video/

Download MP3

  1. Select option [2] from the main menu
  2. Enter the YouTube video URL
  3. Choose your preferred audio quality
  4. Wait for the download to complete
  5. Find your MP3 in /sdcard/TubeGrab/MP3/

Other Options

  • [3] Check/Install Dependencies
  • [4] Update yt-dlp to latest version
  • [5] Exit the program

📸 Screenshots

Main Banner

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║  ████████╗██╗   ██╗██████╗ ███████╗     ██████╗ ██████╗  █████╗ ██████╗   ║
║  ╚══██╔══╝██║   ██║██╔══██╗██╔════╝    ██╔════╝ ██╔══██╗██╔══██╗██╔══██╗  ║
║     ██║   ██║   ██║██████╔╝█████╗      ██║  ███╗██████╔╝███████║██████╔╝  ║
║     ██║   ██║   ██║██╔══██╗██╔══╝      ██║   ██║██╔══██╗██╔══██║██╔══██╗  ║
║     ██║   ╚██████╔╝██████╔╝███████╗    ╚██████╔╝██║  ██║██║  ██║██████╔╝  ║
║     ╚═╝    ╚═════╝ ╚═════╝ ╚══════╝     ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝   ║
║                                                               ║
║        YouTube Video & MP3 Downloader for Termux             ║
║              All Qualities • Fast • Easy to Use              ║
╚═══════════════════════════════════════════════════════════════╝

🎯 Examples

💡 See USAGE.md for more examples and advanced usage

Download a music video in best quality

# Run the script
./youtube-downloader.sh

# Choose option 1 (Video)
# Paste: https://www.youtube.com/watch?v=dQw4w9WgXcQ
# Select quality: 1 (Best Quality)

Download audio only (MP3)

# Run the script
./youtube-downloader.sh

# Choose option 2 (MP3)
# Paste: https://www.youtube.com/watch?v=dQw4w9WgXcQ
# Select quality: 1 (320 kbps)

Custom format download

# Run the script
./youtube-downloader.sh

# Choose option 1 (Video)
# Paste your URL
# Select quality: 6 (Custom)
# View available formats and choose your preferred format codes

❓ FAQ

📚 For comprehensive troubleshooting and tips, see USAGE.md

Q: Where are my downloaded files saved?

A: All downloads are saved in /sdcard/TubeGrab/:

  • Videos: /sdcard/TubeGrab/Video/
  • MP3s: /sdcard/TubeGrab/MP3/

You can access these folders using any file manager app on your phone.

Q: The script says "Permission denied"

A: Make sure you've made the script executable:

chmod +x youtube-downloader.sh

Q: Downloads are failing

A: Try updating yt-dlp using option [4] in the main menu, or run:

pip install --upgrade yt-dlp

Q: Can I download playlists?

A: Currently, the script downloads single videos. For playlists, paste each video URL individually.

Q: Storage permission issues?

A: Run termux-setup-storage and grant Termux access to your storage when prompted.

Q: How do I update the script?

A: Pull the latest changes from the repository:

cd tubegrab
git pull

Q: Video and audio are not merging

A: Make sure ffmpeg is installed:

pkg install ffmpeg -y

🛠️ Troubleshooting

Error: "yt-dlp: command not found"

pip install yt-dlp

Error: "ffmpeg: command not found"

pkg install ffmpeg -y

Error: "No module named 'pip'"

pkg install python -y

Downloads are very slow

  • Check your internet connection
  • Try a different time of day
  • Some videos may have speed limitations

Script freezes or crashes

# Force update all dependencies
pkg update && pkg upgrade -y
pip install --upgrade yt-dlp

🔄 Updates

To update TubeGrab to the latest version:

cd tubegrab
git pull
chmod +x youtube-downloader.sh

📝 Changelog

v1.0.0 (2024-02-11)

  • Initial release
  • Video download with multiple quality options
  • MP3 download with multiple bitrate options
  • Colorful terminal interface
  • Auto-dependency installation
  • Format selection guide
  • Progress indicators

🤝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.


⚠️ Disclaimer

This tool is for personal use only. Please respect copyright laws and YouTube's Terms of Service. Only download videos you have permission to download or that are in the public domain.


📘 Need Help?

Check out USAGE.md for the complete user guide with:

  • Detailed usage instructions
  • Quality selection recommendations
  • Advanced features and tips
  • Comprehensive troubleshooting
  • Keyboard shortcuts and tricks

→ Read the Full Usage Guide


🌟 Support

If you find this tool helpful, please give it a ⭐ on GitHub!

💖 Donate

Support the development of TubeGrab:

Your support helps maintain and improve TubeGrab! 🙏

Report Issues

Found a bug? Open an issue


📞 Contact


Made with ❤️ for the Termux community

⬆ Back to Top