Python
CSS
JavaScript
HTML
DockerfileCinebyhub
A fully automated pipeline that scrapes 37,000+ movies, TV shows, and anime from TMDB, wraps every stream link with Linkvertise monetisation, and deploys a professional static web app to GitHub Pages
About the Project
A fully automated pipeline that scrapes 37,000+ movies, TV shows, and anime from TMDB, wraps every stream link with Linkvertise monetisation, and deploys a professional static web app to GitHub Pages â all for free.
ð 100% Free Deployment (GitHub Actions + Pages)
This project is designed to be fully autonomous using GitHub's free infrastructure.
1-Click Setup Instructions
- Fork this Repository to your own GitHub account.
- Configure Secrets:
- Go to your repo Settings > Secrets and variables > Actions.
- Add the following Repository secrets:
TMDB_API_KEY: Your TMDB API Key (v3).TMDB_READ_TOKEN: Your TMDB Read Access Token (v4 - Recommended).LINKVERTISE_USER_ID: Your Linkvertise User ID (e.g.,738317).
- Enable GitHub Pages:
- Go to Settings > Pages.
- Under Build and deployment > Source, select GitHub Actions.
- Run the Pipeline:
- Go to the Actions tab.
- Select the Update Content and Deploy workflow.
- Click Run workflow > Run workflow.
The pipeline will now run automatically every 12 hours to fetch new content and redeploy your site.
ð° AdSense Integration
CinebyHub includes built-in placeholders to help you get approved by Google AdSense quickly.
1. Enable the AdSense Script
Open index.html and look for the AdSense placeholder in the <head> section. Uncomment the script and replace ca-pub-XXXXXXXXXXXXXXXX with your actual AdSense Publisher ID:
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-YOUR_ID" crossorigin="anonymous"></script>
2. Legal Pages (Pre-created)
Google requires specific pages for approval. We have pre-configured:
about.html(Accessible at/about.html)privacy-policy.html(Accessible at/privacy-policy.html)contact.html(Accessible at/contact.html)
You can modify the content of these files in the root directory to match your specific details.
âï¸ Configuration Essentials
TMDB Credentials
- Get your free key at â themoviedb.org/settings/api
- Supported via environment variables:
TMDB_API_KEYandTMDB_READ_TOKEN.
Linkvertise
- Get your User ID from your Linkvertise dashboard.
- Supported via environment variable:
LINKVERTISE_USER_ID.
ð How the Automation Works
The GitHub Actions workflow (.github/workflows/update.yml) performs the following steps every 12 hours:
- ð Scrape: Runs
cineby_scraper.pyto fetch the latest trending content from TMDB. - ð Linkvertise: Runs
linkvertise_api_lite.pyonly if new rows are detected. It uses_checkpoints/andcineby_content.xlsxto skip already processed links. - ðï¸ Build: Uses Vite to compile the static site into the
dist/folder. - ð Deploy: Pushes the
dist/folder to GitHub Pages. - ð¾ Persist: Uses GitHub Actions Cache and Git commits to ensure checkpoints and row counts are preserved for the next 12-hour cycle.
Limitations of Static Hosting
- Search: Search is client-side (handled by
main.js). With 37k+ rows, the first load fetches a ~12MB Excel file once. - Dynamic Content: Updates are not real-time; they occur every 12 hours.
- State: Any user settings (like theme) are stored in
localStoragein the browser.
ð Project Structure
watch-hub-cineby/
âââ .github/workflows/update.yml â 12-hour GHA Scheduler
âââ cineby_scraper.py â TMDB API scraper
âââ linkvertise_api_lite.py â Linkvertise link generator
âââ run_all.py â Master orchestrator
âââ vite.config.js â Vite config (Pages compatible)
â
âââ index.html â Main Web App
âââ about.html â Legal Page
âââ privacy-policy.html â Legal Page
âââ contact.html â Legal Page
â
âââ cineby_content.xlsx â Source Data
âââ public/
âââ cineby_content.xlsx â Built Data (Linked)
ð ï¸ Local Development
If you want to run the project locally:
- Install Dependencies:
pip install -r requirements.txt npm install - Environment Variables: Create a
.envfile:TMDB_API_KEY=your_key TMDB_READ_TOKEN=your_token LINKVERTISE_USER_ID=your_id - Run Pipeline:
python run_all.py --once - Start Dev Server:
npm run dev
ð License
MIT â Created for premium entertainment indexing.
Project Timeline
Technologies
External Links
Related Projects
Projects built with similar technologies.
Online Html Editor And Viewer
The Online HTML Editor and Viewer is a simple web application built with Flask that allows users to write and preview HTML code in real-time.
Qrgen
A premium, feature-rich QR Code Generator engineered with Python (Flask) and a pristine Glassmorphism frontend.
Examina Ai
Using AI, It transforms raw study materials into structured, verified examination sets with support for institutional export formats like Moodle XML.