Skip to main content

A versatile downloader for YouTube, TikTok, Instagram, and Facebook.

Project description

Social Media Downloader

Overview

Social Media Downloader is a versatile tool designed to download videos and posts from popular platforms like YouTube, TikTok, Instagram, and Facebook. It provides an intuitive CLI interface for Windows and Linux users and is also available on PyPI for easy installation via pip.

This tool is intended for personal use only. Unauthorized downloading of copyrighted material is prohibited.


Key Features

  • Platform Support:
    • Download videos from YouTube, TikTok, and Facebook.
    • Download posts from Instagram.
  • Batch Download: Download multiple URLs in one go using a text file.
  • Update Checker: Keep the software updated with the latest features and fixes.
  • Customizable: Configure download directory and format preferences.
  • Platform Compatibility:
    • Windows CLI support with .exe file.
    • Linux CLI support via terminal commands.
    • Python users can install it using pip.

Installation

Option 1: Install via PyPI (Python 3.7+ required)

pip install social-media-downloader

Option 2: Download Executable for Windows

  1. Visit the Latest Releases page.
  2. Download the .exe file.
  3. Run the executable directly via command prompt or double-click to start.

Option 3: Use on Linux

  1. Download the Linux binary from the Latest Releases page.
  2. Extract the downloaded archive:
    unzip SocialMediaDownloader_latest_Linux.zip  
    
    or
    tar -xzvf SocialMediaDownloader_latest_Linux.tar.gz  
    
  3. Run the binary:
    ./SocialMediaDownloader_latest
    

Requirements

  • FFmpeg: Required for video/audio conversion.
    • Install on Linux:
      sudo apt update
      sudo apt install ffmpeg
      
    • Install on Windows: Download FFmpeg from ffmpeg.org, add it to your PATH.

Usage

Running the Tool

For all platforms:

social-media-downloader

Alternatively, on Windows:

SocialMediaDownloader_latest.exe

Features and Options

  1. Download YouTube/TikTok Video: Provide the video URL to download in your desired format.
  2. Download Facebook Video: Enter the video URL to download directly.
  3. Download Instagram Post: Provide the Instagram post URL to save it locally.
  4. Batch Download: Provide a text file containing URLs (one per line).
  5. Check for Updates: Ensure you are using the latest version.
  6. Help: Learn more about using the tool.

Configuration

Modify the config.json file to customize:

  • Default Download Directory
  • Default History File
  • Default Format Behavior

Example Commands

Download YouTube/TikTok Video

social-media-downloader
# Select Option 1 and enter the URL

Batch Download

social-media-downloader
# Select Option 4 and provide the text file path

Logs and History

  • All downloads are logged in downloader.log.
  • A detailed history of downloads is saved in download_history.csv.

Disclaimer

This software is intended for personal use only. Downloading content without the permission of the content owner may violate copyright laws. The developer is not responsible for any misuse of this tool.


Troubleshooting and Support

If you encounter any issues or have feature requests:

Enjoy using Social Media Downloader! 🎉

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

social_media_downloader-1.0.0.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

social_media_downloader-1.0.0-py3-none-any.whl (14.7 kB view details)

Uploaded Python 3

File details

Details for the file social_media_downloader-1.0.0.tar.gz.

File metadata

  • Download URL: social_media_downloader-1.0.0.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.0

File hashes

Hashes for social_media_downloader-1.0.0.tar.gz
Algorithm Hash digest
SHA256 d7810ef9c18d7ff8624fcf08065fbcbdf51dc743f73c2ba8f57c91ed5a97ab19
MD5 9300336faedcb55c3297c1be1ab39c78
BLAKE2b-256 51bc384140db12d91ee22d5e5b4374e6876f00c60aecc51a36f7fefd9cd498fa

See more details on using hashes here.

File details

Details for the file social_media_downloader-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for social_media_downloader-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1a856a7b372382072875434f6e65930a5a311cdd09aad6906ea738e2f2f4e65b
MD5 bb0406fdd5aaf91c40b9aeb2311d30ac
BLAKE2b-256 2f89d390e5cf4199c9e2c220c9e7e3aab994dae47990b5f68a956a12f59ee198

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page