Skip to content

Latest commit

 

History

History
168 lines (126 loc) · 4.92 KB

README.md

File metadata and controls

168 lines (126 loc) · 4.92 KB

✨ Social Media Downloader v1.0.4 ✨

Your go-to tool for snagging viral vids, reels, and epic posts from YouTube, TikTok, Instagram, and Facebook. 🚀💖

Issues Stars Forks Discussions Python Version Version Downloads Total Downloads

🌟 What’s the 411?

Social Media Downloader v1.0.4 lets you snatch the juiciest content from:

  • YouTube 🎥
  • TikTok 🎶
  • Instagram 📸
  • Facebook 📵

Whether it’s memes, inspo reels, or iconic videos, this tool is here to SERVE. ⚡

🔥 Features

💡 What’s poppin’ in v1.0.4:

  • Smarter vibes only: Auto-detects when you’re offline (and politely asks you to reconnect 🫡).
  • Turbo speed: Faster downloads ‘cause nobody likes waiting. 🏎️💨
  • MP3 perfection: Choose audio quality (128, 192, or 320 kbps) for music vibes that match your mood 🎧.
  • Batch download pro: Queue up multiple links and let us do the heavy lifting 💪.
  • Logs/history glow-up: Full transparency. Every win, every fail—documented like a boss 📝.

🚀 How to Download

💻 Windows

  1. Get Python first:
    Download it from python.org.

    • Don’t skip "Add Python to PATH." Check with: 
      python --version

  2. Install the downloader:

    pip install social-media-downloader

  3. Run it like a pro:

    social-media-downloader

    OR grab the .exe from our releases.

🖥️ Linux

  1. Install Python & pip:

    sudo apt install python3 python3-pip  # For Ubuntu/Debian  
sudo dnf install python3 python3-pip  # For Fedora/RHEL  
sudo pacman -S python python-pip  # For Arch-based

  2. Get the downloader:

    pip install social-media-downloader

  3. Flex your skills:

    social-media-downloader

🍎 MacOS

  1. Use Homebrew for Python (if not done yet):

    brew install python

  2. Install the tool:

    pip install social-media-downloader

  3. Start the party:

    social-media-downloader

🎶 Pro Tip: FFmpeg Setup

🎧 Why you need FFmpeg: Merging, converting, and pure magic.

  • Windows: Download here. Add the bin folder to PATH.
  • Linux: Install via your package manager: 
    sudo apt install ffmpeg  # Ubuntu/Debian  
sudo dnf install ffmpeg  # Fedora/RHEL  
sudo pacman -S ffmpeg  # Arch-based
  • MacOS: 
    brew install ffmpeg

📋 Usage 101

One Download at a Time:

Run the tool and drop your link:

social-media-downloader

Batch Download (for the multitaskers 💼):

Add URLs (one per line) in a text file:

social-media-downloader -batch my_urls.txt

💡 Customize It

Modify config.json to:

  • Change default directories.
  • Adjust MP3 download quality.
  • Customize batch downloads.

📜 Logs + Receipts

  • Logs? Peep downloader.log for all the tea (successes AND errors).
  • Download history? Check download_history.csv.

⚡ Legal Disclaimer

🛑 Heads up:
This tool is for personal use only. Download responsibly! Don’t break the law, fam. 🙏

🙌 Wanna Join the Squad?

💾 Grab It. Save It. Flex It. 💾

✨ The internet’s greatest hits, all in your pocket. ✨