Welcome to ZynU MangA

This guide walks you through the full setup — from running the scraper to having a live manga website with ads. No coding experience needed. Follow each step in order.

✅ Before you start — what you need

A Windows, Mac, or Linux computer to run the scraper app
A free Supabase account — your online database (no credit card)
A free Vercel account — to host your website (no credit card)
A free GitHub account — to connect your site to Vercel
About 30–60 minutes for the full setup

💡

Everything after purchase is free to run.Supabase, Vercel, and GitHub all have free tiers that are more than enough. You pay $0/month to keep your manga platform live.

🗺️ The 4 steps at a glance

🗄️

Create a free Supabase databaseTakes 5 minutes — this is where your manga data lives

Step 1

🕷️

Run the scraper appDouble-click, press Start, walk away — it collects manga automatically

Step 2

☁️

Upload data to SupabaseOne click in the app sends everything to your online database

Step 3

🚀

Deploy your website to VercelConnect GitHub → Vercel, add two env vars, click Deploy

Step 4

What You Need

Four free accounts and Python on your computer. That's it. Everything below is free — no credit card required for any of it.

🐍 Python 3.10 or newer

Required to run the scraper app. If you're on Windows, you probably don't have it yet.

Go to python.org/downloads

Click the big yellow "Download Python" button. This downloads the installer.

Run the installer — tick "Add to PATH"

⚠️ Before clicking Install, make sure the checkbox "Add Python to PATH" is ticked at the bottom of the installer screen. This is critical — without it the scraper won't open.

Verify it worked

Open Command Prompt (Windows) or Terminal (Mac/Linux) and type:

Terminal

python --version

You should see something like Python 3.11.4. If you see an error, restart your computer and try again.

🌐 The three free accounts

Supabase — supabase.com — your manga database. Sign up with email or Google. Free forever for your usage level.
GitHub — github.com — used to store your website code so Vercel can deploy it. Sign up with email.
Vercel — vercel.com — hosts your website for free. Sign up with your GitHub account (easier).

✅

Ready? Once Python is installed and you have your three accounts, move to the next step.

Setup Supabase

Supabase is your free online database — think of it as the storage room where all your manga titles, chapters, and covers live. Your website reads from it to show content to visitors.

① Create a new project

Go to supabase.com → Dashboard → click the green "New Project" button.

Fill in the project details

Name: anything (e.g. "manga-site")
Database Password: pick something strong and save it — you'll need it later.
Region: pick the closest to your audience. Southeast Asia → Singapore.

Wait ~1 minute for it to provision

Supabase sets up your database automatically. A progress bar shows when it's ready.

② Copy your connection details

Go to Project Settings → Database. Scroll down to "Connection parameters" and copy these values into a text file:

Supabase → Settings → Database

Host db.xxxxxxxxxxxx.supabase.co Port 5432 Database postgres User postgres Password [the password you set above]

You'll paste these into the scraper app in the next steps.

③ Copy your API keys

Go to Project Settings → API. Copy and save these two:

Supabase → Settings → API

Project URL https://xxxxxxxxxxxx.supabase.co anon public key eyJhbGciOi... (long string)

You'll need these in Step 4 when deploying the website.

✅

Step 1 complete. You now have a free cloud database. Keep your Host, password, Project URL, and anon key saved in a text file — you'll use all four in the next steps.

Install the Scraper

The scraper is a desktop app included in your purchase ZIP. Before running it, you need to install its libraries once. This takes about 2 minutes.

① Extract your purchase ZIP

After purchasing, you received a download link. Download the ZIP file and extract it. Inside you'll find two folders:

scraper/ — contains the Python app (zynu_manga_poster_v2.py)
website/ — contains the Next.js website files

② Open your terminal in the scraper folder

Windows: Open the scraper folder in File Explorer. Click the address bar at the top, type cmd, and press Enter. A Command Prompt window opens already in that folder.

Mac / Linux: Open Terminal and type:

Terminal

cd ~/Downloads/zynu-manga/scraper

③ Install the required libraries

Run this command once. It installs everything the scraper needs:

Terminal

pip install PyQt5 requests beautifulsoup4 psycopg2-binary

Wait for it to finish — you'll see a lot of text scroll by, ending with "Successfully installed...". This is normal. You only need to do this once.

⚠️

If you see "pip is not recognized": Python wasn't added to PATH during installation. Uninstall Python, then reinstall it and tick the "Add Python to PATH" checkbox.

✅

Libraries installed. You're ready to run the scraper.

Collect Manga Data

The scraper opens as a desktop app with two tabs. Tab 1 collects manga from the web into a local file on your computer. Tab 2 uploads it to Supabase.

① Open the scraper app

In your terminal (inside the scraper folder), run:

Terminal

python zynu_manga_poster_v2.py

A window opens with two tabs at the top: Tab 1: Scraper and Tab 2: Upload. Stay on Tab 1 for now.

② Configure the settings

Limit Manga — how many manga to collect. Start with 200–500 for your first run. You can always run it again for more.
Rate Delay — seconds to wait between requests. Leave at 2 (default). Don't set lower.
Specific URL — leave this empty. It will scrape the full list automatically.

③ Press "Mulai Scraping"

Click the Start button. The log panel fills with activity — this is normal. It shows every manga being collected in real time.

The app shows live stats:

Progress bar — how far along the collection is
Speed — manga per minute being processed
ETA — estimated time remaining

💡

Rough time estimates:200 manga ≈ 10–20 min · 500 manga ≈ 30–60 min · 1,000 manga ≈ 1–2 hours. You can minimize the window and do other things while it runs.

④ Wait for the completion popup

When scraping finishes, a popup appears and you'll see a ✅ message in the log. The file manga_database.db is now saved in the scraper folder.

You can safely Pause and Resume at any time using the buttons — progress is saved and nothing gets duplicated.

⚠️

Don't close the window while scraping. You can minimize it, but closing stops the process. If you do close it accidentally, just run it again — already-collected manga won't be duplicated.

Upload to Supabase

Tab 2 of the scraper sends all collected manga from your computer to your Supabase database. Once uploaded, your website can show it to visitors.

Click "Tab 2: Upload" in the app

Switch to the second tab at the top of the scraper window.

Fill in your Supabase connection details

Paste the values you saved from Supabase → Settings → Database:

Tab 2 fields

Host db.xxxxxxxxxxxx.supabase.co Port 5432 Database postgres User postgres Password [your Supabase password]

Click "Test Koneksi"

You should see a green ✅ message: "Koneksi berhasil". If you see a red error, double-check your Host and Password — a common mistake is a space at the end when copying.

Click "Preview Data" (optional)

Shows a summary of what's about to be uploaded. Confirms scraping worked correctly.

Click "Mulai Upload" and wait

The progress bar moves as manga, chapters, and image URLs upload in batches. Wait for the ✅ completion popup. 500 manga typically takes 5–10 minutes.

✅

Upload complete. Verify: go to Supabase dashboard → Table Editor. You should see tables called manga, chapters, genres, and chapter_images with rows of data.

Deploy to Vercel

Now you'll put the website online using Vercel's free hosting. This takes about 5 minutes — no server setup, no maintenance.

Upload the website folder to GitHub

Go to github.com → click "New repository" → name it (e.g. "manga-site") → click "Create repository".

On the next screen, click "uploading an existing file". Drag all files from the website/ folder into the GitHub upload area and commit.

Import the repo in Vercel

Go to vercel.com → "Add New Project" → "Import Git Repository" → select the GitHub repo you just created.

Add your environment variables

Before clicking Deploy, scroll down to "Environment Variables" and add these two:

Vercel — Environment Variables

NEXT_PUBLIC_SUPABASE_URL https://xxxxxxxxxxxx.supabase.co NEXT_PUBLIC_SUPABASE_ANON_KEY eyJhbGci... (your anon public key)

Both values come from Supabase → Settings → API.

Click Deploy — your site is live in ~2 minutes

Vercel builds and deploys automatically. You get a free URL like your-project.vercel.app. Open it — you should see your manga reader with all the titles you collected.

💡

Want a custom domain? Go to Vercel → your project → Domains → add your domain. Vercel handles the SSL certificate and DNS automatically.

🎉

Your manga platform is live! Share the URL on social media and manga communities to start building traffic. More visitors = more ad revenue.

Add Adsterra Ads

Adsterra works great for manga sites — no strict approval, starts earning almost immediately. Here's how to add it to your live site.

Go to adsterra.com → click "Sign Up" → choose "Publisher" (not Advertiser). Verify your email.

Add your website

Dashboard → Sites → Add Site. Enter your Vercel URL. Category: Entertainment / Comics. Adsterra typically approves within 24 hours.

Get your ad code

Once approved: Sites → your site → Get Code. Choose Banner or Social Bar as your ad format. Copy the code snippet.

Paste the code into layout.js

Open the website/ folder. Find app/layout.js. Paste your Adsterra snippet just before the closing </body> tag. Save the file.

app/layout.js — paste here

<body> {children} /* ← paste Adsterra code here */ </body>

Push to GitHub — Vercel redeploys automatically

Go to your GitHub repo → upload the updated app/layout.js file (drag and drop, then commit). Vercel detects the change and redeploys in about 1 minute. Ads will appear on your live site.

💡

Tip: 2–3 ad placements per page is a good balance. One banner at the top, one in the middle of the manga list, and optionally a Social Bar (floats at the edge of the screen). More placements = more earnings, but don't overwhelm readers.

Scraper Problems

Common issues when installing or running the scraper app.

Make sure Python is installed and added to PATH. Open Command Prompt and run: python --version
Run the app from terminal instead of double-clicking: python zynu_manga_poster_v2.py
If you see an error message in the terminal, copy it and check the next items below.

The libraries aren't installed yet. Run: pip install PyQt5 requests beautifulsoup4 psycopg2-binary
If pip gives an error, try: python -m pip install PyQt5 requests beautifulsoup4 psycopg2-binary

The source site may be temporarily rate-limiting you. Increase Rate Delay to 3 or 4 seconds.
Check your internet connection — a brief disconnection can pause scraping.
Use the Pause/Resume button — don't close the window. The scraper retries failed pages automatically.

Python was installed without being added to PATH.
Fix: Uninstall Python, re-download from python.org, and tick "Add Python to PATH" before installing.
Alternatively, restart your computer — sometimes PATH changes need a restart to take effect.

Upload & Connection Errors

Issues when connecting to Supabase or uploading your manga data.

Double-check the Host — copy it exactly from Supabase → Settings → Database. Watch for extra spaces.
Make sure the Password is correct. It's case-sensitive.
Port must be 5432. Don't change it.
Turn off any VPN — it can block the Supabase connection.
In Supabase: Settings → Database → scroll to "Connection Pooling" — make sure it's enabled.

This is usually a timeout. Click "Mulai Upload" again — it won't duplicate data already uploaded.
Make sure your internet connection is stable during upload.
If it keeps failing at the same point, contact Telegram support.

Run: pip install psycopg2-binary
If that fails, try: pip install psycopg2

Website Not Working

Issues with the Vercel deployment or the live site.

Most common cause: missing environment variables. Go to Vercel → your project → Settings → Environment Variables. Make sure NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY are both set.
Trigger a manual redeploy: Vercel → Deployments → three dots on the latest → Redeploy.
If you see "Cannot find module" in the build log, make sure package.json was uploaded to GitHub along with the other files.

Check that the upload in Step 3 finished successfully.
Go to Supabase → Table Editor → click "manga". If the table is empty, run the upload again from Tab 2.
Verify your env vars in Vercel are the correct URL and anon key (not the service_role key).
In Supabase → Authentication → Policies: make sure "anon" role has SELECT access on the manga, chapters, genres, and chapter_images tables.

This is normal for some manga — images are hosted on the source site and some may expire or block hotlinking.
The website has a fallback image system built in — broken images show a placeholder, not an error.
Re-scraping the same manga later often gets fresh image URLs.

Make sure your Adsterra site status shows "Approved" in the dashboard.
Confirm the code was pasted correctly in app/layout.js and the file was re-uploaded to GitHub.
Disable your browser's ad blocker when testing — it will block your own ads.
It can take up to 24 hours after approval for ads to fully start serving.

💬

Still stuck? Send a Telegram message with a screenshot of the error. Support is included with your purchase. Contact support →