📌 Pinterest-Media-Downloader

Pinterest Media Downloader is a Streamlit-based desktop/web app to download images and videos from Pinterest pins, boards, and profiles—quickly and reliably.

---

✨ What’s New

• 🎉 Initial release with core download and UI functionality
• 🔄 Improved URL normalization & validation
• 🕸️ Enhanced fallback scraping for robust media extraction
• ⚙️ Better error handling and user feedback
• 🖱️ Cleaner UI with quick-select buttons (“First 5”, “First 10”, “All Files”)

---

🛠️ All Features

• 📥 Download images & videos from Pinterest pins, boards, profiles
• 🔄 Dual extraction methods: gallery-dl + custom BeautifulSoup fallback
• 📦 Save media as original files or bundled ZIP archive
• ⚡ Quality & advanced settings: timeout, retries, concurrency
• 👁️‍🗨️ Media preview cards with progress tracking
• 🎛️ Professional Streamlit UI with sidebar settings & live metrics

---

🗂️ Folder Structure

Pinterest-Media-Downloader/
├── LICENSE                    # MIT license
├── README.md                  # This file
├── requirements.txt           # Python dependencies
├── src/                       # Source directory
|   └── main.py                # Streamlit app entry point
├── favicon.ico            # App icon
└── screenshots/           # UI previews
    └── screenshot.png

---

📋 Requirements

• Python 3.8+
• pip package manager
• Streamlit
• gallery-dl
• requests
• beautifulsoup4
• Pillow
• lxml

Install via:

pip install -r requirements.txt

Or manually:

pip install streamlit gallery-dl requests beautifulsoup4 pillow lxml

---

⚙️ Installation

1. Clone the repo

   git clone https://github.com/ukr-projects/pinterest-media-scraper.git
   cd pinterest-media-scraper/src

2. Install dependencies

   pip install -r ../requirements.txt

---

▶️ Usage

1. Run the app:

   streamlit run src/main.py

2. Enter a Pinterest URL (pin, board, or profile)

3. Click “🔍 Analyze URL” to fetch media links

4. Choose how many files to download or use quick-select

5. Click “🚀 Start Download” to save images/videos (ZIP option available)

6. Monitor progress and download individual files or archive

---

📸 Screenshot

---

🤝 How to Contribute

1. Fork the repository

2. Create a branch:

   git checkout -b feature/YourFeature

3. Implement your changes & commit

4. Push and open a Pull Request

---

🙏 Acknowledgments

• Streamlit for rapid UI development
• gallery-dl for Pinterest extraction
• BeautifulSoup for HTML parsing
• Requests for HTTP sessions
• Pillow for media handling

🌟 Star History

If you find this project useful, please consider giving it a star on GitHub! Your support helps us continue improving and maintaining this tool.

📞 Support

• GitHub Issues: Report bugs or request features
• Discussions: Community discussions and Q&A
• Email: [email protected]

---

Made with ❤️ by the Ujjwal Nova

⭐ Star this repo | 🐛 Report Bug | 💡 Request Feature