initial commit

README.md

@@ -0,0 +1,50 @@
+# Giphy GIF Downloader
+
+This script downloads GIFs from Giphy pages. You provide a list of Giphy URLs, and the script will scrape the page to find the direct GIF link and download it.
+
+## How It Works
+
+The script reads a list of Giphy page URLs from `links.txt`, then visits each page to find the direct `.gif` image URL. It then downloads the GIF and saves it into the `downloaded_gifs` directory, using the GIF's unique ID as the filename.
+
+## Requirements
+
+- Python 3
+- `requests` library
+- `beautifulsoup4` library
+
+## Installation
+
+1.  **Clone the repository or download the files.**
+
+2.  **Install the required Python libraries:**
+    ```bash
+    pip install requests beautifulsoup4
+    ```
+
+## Usage
+
+1.  **Add Giphy URLs to `links.txt`**:
+    Open the `links.txt` file and add the Giphy page URLs you want to download. Each URL should be on a new line.
+
+    Example `links.txt`:
+    ```
+    https://giphy.com/gifs/hello-hi-hey-l41lZxzroU33typuU
+    https://giphy.com/gifs/cat-computer-hacker-J1G7rIvoyz4cwaqXWo
+    ```
+
+2.  **Run the script**:
+    Execute the Python script from your terminal:
+    ```bash
+    python giphy-downloader.py
+    ```
+
+3.  **Find your GIFs**:
+    The script will create a `downloaded_gifs` directory (if it doesn't already exist) and save all the downloaded GIFs there.
+
+## File Structure
+
+```
+.
+├── giphy-downloader.py   # The main Python script
+├── links.txt             # Your list of Giphy URLs
+└── downloaded_gifs/      # Directory where GIFs are saved