Skip to content

al3x-X-y/Clip-Collector

Repository files navigation

Clip Collector

Clip Collector is a web application that allows users to search and download images and GIFs from Giphy, Pexels, Tenor, and Flaticon using Streamlit. This project uses various APIs and a custom scraper to gather and display media content.

This tool will be useful for video editors who visits multiple websites to search and download media files. With Clip Collector, you only need to search once to download all the media you need with a single click.

Features

  • Search and Download: Search and download images and GIFs from Giphy, Pexels, Tenor, and Flaticon.
  • Streamlit Interface: User-friendly web interface built with Streamlit.
  • Custom Scraper: Custom scraping functionality for Flaticon.
  • Random User-Agent: Uses a random user-agent for requests to avoid being blocked.

Libraries Used

The project makes use of the following libraries:

  • streamlit
  • urllib.parse
  • requests
  • PIL (Python Imaging Library)
  • io.BytesIO
  • base64
  • asyncio
  • giphy_client
  • lxml.html
  • argparse
  • uuid

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/easy-downloader.git
    cd easy-downloader
  2. Install the required dependencies:

    pip install -r requirements.txt
  3. Set up API keys for Giphy, Pexels, and Tenor. You can obtain these keys from their respective developer portals and set them as environment variables:

    export GIPHY_API_KEY='your_giphy_api_key'
    export PEXELS_API_KEY='your_pexels_api_key'
    export TENOR_API_KEY='your_tenor_api_key'

Usage

Run the Streamlit app:

streamlit run app.py

Contributing

Contributions are welcome! Please follow these steps to contribute:

  • Fork the repository:
git checkout -b feature-branch

Make your changes.

  • Commit your changes :
git commit -m 'Add new feature'
  • Push to the branch :
git push origin feature-branch

Open a pull request.


License

This project is licensed under the MIT License.

Acknowledgements

Giphy API

Pexels API

Tenor API

Flaticon

About

A simple gifs, sticker, video, pictures scraper that will show result in Streamlit

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages