🎬 Cine Source Hub

Cine Source Hub is a Python-based movie search aggregator that searches for a given movie name across multiple torrent and movie indexing websites in parallel and returns only the working result links.

The tool is designed to be fast, lightweight, and terminal-friendly, making use of multithreading to reduce overall search time.

⚠️ Disclaimer: This project is for educational and research purposes only. The author does not host, store, or promote copyrighted content. Users are responsible for how they use the generated links and must comply with local laws.

---

🚀 Features

• 🔍 Search across 25+ movie and torrent websites
• ⚡ Parallel searching using ThreadPoolExecutor
• 🌐 Automatic URL encoding for movie names
• 🧠 Smart filtering for "No Results" pages
• ⏱️ Displays total search execution time
• 🖥️ Simple interactive CLI interface

---

📦 Requirements

• Python 3.8+

Python Dependencies

requests>=2.31.0
beautifulsoup4>=4.12.0
lxml>=5.0.0  # optional but recommended

Install all dependencies using:

pip install -r requirements.txt

---

📂 Project Structure

CineSourceHub/
│
├── movie_searcher.py   # Main script
├── requirements.txt   # Python dependencies
└── README.md           # Project documentation

---

▶️ Usage

Run the script from the terminal:

python movie_searcher.py

You will see an interactive prompt:

>>> Enter movie name (or 'q' to quit):

Example

>>> Enter movie name: Interstellar

✅ WORKING LINKS (12 found)
⭐ YTS: https://yts.mx/browse-movies/Interstellar/...
⭐ EZTV: https://eztv.re/search/Interstellar
...

⏱️ Search completed in 2.41 seconds

---

⚙️ How It Works

1. Accepts a movie name from the user
2. URL-encodes the input safely
3. Searches all configured sites in parallel
4. Parses HTML responses using BeautifulSoup
5. Filters out pages with "No Results" indicators
6. Displays only valid, working search result URLs

---

🛠️ Customization

Add New Sites

To add a new site, update the self.sites dictionary:

'sitename': 'https://example.com/search?q={name}'

Adjust Thread Count

Modify the executor workers:

ThreadPoolExecutor(max_workers=15)

Increase carefully to avoid IP blocking.

---

⚠️ Legal Notice

This tool does not download or store any media content. It only generates publicly accessible search URLs.

Users are solely responsible for complying with:

• Copyright laws
• ISP policies
• Regional cyber laws

The developer assumes no liability for misuse.

---

🤝 Contributors Welcome

Contributions are highly welcome and appreciated.

You can contribute in the following ways:

• 🆕 Adding new movie or torrent source websites
• 🛠️ Improving result detection and filtering logic
• ⚡ Optimizing performance and threading
• 🧪 Bug fixes and edge-case handling
• 📝 Enhancing documentation and examples

How to Contribute

1. Fork this repository
2. Create a new branch (feature/your-feature-name)
3. Commit your changes with clear messages
4. Push to your fork
5. Open a Pull Request

Please ensure your code:

• Follows clean Python coding practices
• Does not introduce malicious or illegal functionality
• Includes meaningful commit messages

By contributing, you agree that your work will be licensed under the same license as this project.

---

⭐ If you find this project useful, consider giving it a star on GitHub.