Welcome to ZynU BSP
This guide walks you through everything — from downloading the tool to seeing your first post go live on Binance Square. No technical experience needed. If you can follow steps, you can do this.
Before you start — what you need
- A Binance account with Binance Square enabled (free)
- A computer running Windows 10/11, macOS, or Linux — or a cheap VPS
- A free Groq AI key — takes 2 minutes to get (we'll walk you through it)
- A stable internet connection
- About 15–20 minutes for the full setup
The 5 steps at a glance
Download & Install
The installer handles everything automatically — Python packages, browser engine, desktop shortcut. You only need to run one command.
Step 1 — Open your terminal
Press Ctrl + Alt + T on your keyboard to open the terminal. It's the black window where you type commands.
Step 2 — Go to the ZynU folder
After purchasing, you'll receive a .zip or .tar.gz file. Extract it, then navigate into the folder:
Replace ~/Downloads/zynu-bsq with the actual path where you extracted the files.
Step 3 — Run the installer
This single command installs everything — Python libraries, browser engine, desktop shortcut.
It will take 2–5 minutes. You'll see text scrolling — that's normal. Wait until you see a success message.
Why a VPS?
A VPS (Virtual Private Server) is a computer in the cloud that runs 24/7. It costs about $4–5 per month and means the tool keeps posting even when your own computer is off.
Good options: Hetzner (cheapest), DigitalOcean, or Contabo. Pick Ubuntu 22.04 when creating the server.
Connect to your VPS
After creating the server, you'll get an IP address and a password. Connect from your PC:
Upload the ZynU files
Open a new terminal tab on your PC and upload the extracted ZynU folder to the VPS:
Install on the VPS
Step 1 — Extract the ZIP
After purchasing, extract the ZIP file you received. Open the installer_windows/ folder inside.
Step 2 — Run the installer
Right-click INSTALL_WINDOWS.bat and select Run as Administrator. The installer will automatically set up Python, Chromium, and all dependencies.
It will take 3–8 minutes. You'll see text scrolling — that's normal. Wait for the success message.
Step 3 — Launch the app
After install, a ZynU BSP shortcut appears on your Desktop. Double-click it to open the dashboard. No terminal needed from here.
Step 1 — Extract and open Terminal
After purchasing, extract the ZIP file. Open Terminal (press Cmd + Space, type Terminal, press Enter).
Step 2 — Navigate to the installer folder
Step 3 — Run the installer
The installer handles Python (via Homebrew if needed), Chromium, and all dependencies. It takes 3–8 minutes. Wait for the success message.
Step 4 — Launch the app
After install, run the app from Terminal or use the created launcher shortcut in your Applications folder.
Get your free AI key
The tool uses Groq to write your posts. Groq is a free AI service — no credit card, no trial period, no limits that affect normal use. Getting a key takes about 2 minutes.
Create a Groq account
Open your browser and go to console.groq.com. Click Sign Up.
Use your Google account for the fastest signup, or create one with your email. No credit card asked.
Once logged in, look for API Keys in the left sidebar. Click it.
Click Create API Key. Give it any name (e.g. "ZynU"). Copy the key that appears — it starts with gsk_.
Add the key to ZynU
Launch the app from your desktop. In the left sidebar, click API Keys.
Click the ➕ Add Key button at the top right of the API Keys tab.
Paste the key you copied from Groq into the text box. Click Save Key. Done.
Connect your Binance account
You log in to Binance Square once inside the app. The session is saved automatically — you never need to log in again, even after restarting your computer.
How to connect
Open ZynU and click Session in the left sidebar.
A Chrome browser window will open automatically, showing the Binance Square homepage.
In that browser window, enter your Binance email and password. Complete 2FA if you have it enabled. Wait until the Binance Square feed loads fully.
Back in the ZynU window, click the green CONFIRM button. The browser closes and your session is saved. You'll see "Status: ✅ Logged In".
Your first post
Everything is set up. Now let's make sure it all works by posting manually before turning on the automatic scheduler.
Post manually — test it now
Click Dashboard in the left sidebar. You should see your stats at the top: API Keys, Session Status.
This triggers one full cycle: scraping news → writing the post → publishing to your Binance Square. Watch the Live Output box on the right to see what's happening.
Open Binance Square in your browser and go to your profile. The post should appear within 30–60 seconds of the "✅ Post published!" message in ZynU.
Set your posting schedule
Tell ZynU how often to post, then press Start. The scheduler runs in the background and handles everything — you don't need to do anything else.
Mode 1 — Every N hours
The simplest option. ZynU posts once, waits N hours, posts again, repeats forever.
- In the Dashboard, select "Every N hours"
- Use the spinner to set the interval — e.g. 3 hours
- Click ▶ START SCHEDULER
- The first post fires immediately, then every 3 hours after that
Mode 2 — Specific times
Posts at exact times you choose each day — useful if you want to hit peak Binance Square traffic hours.
- Select "Specific times"
- Type your times separated by commas — e.g. 08:00,14:00,20:00
- Click ▶ START SCHEDULER
Stopping the scheduler
Click ⏹ STOP SCHEDULER at any time. Any post currently in progress finishes normally. The scheduler doesn't run when ZynU is closed — reopen the app and click Start again if needed.
Square API key (optional)
This is an official key from Binance that lets ZynU post directly — without opening a browser at all. It's faster, more reliable, and completely optional. The tool works fine without it.
With this key: ZynU posts via official API — faster, no browser needed.
How to get the key
Go to binance.com/square and log in.
Click your profile icon → Creator Center. Look for an "API Key" or "Create API Key" button.
Click Create, copy the key shown. This key is only for posting — it cannot access your funds or trading account.
In ZynU, click API Keys in the sidebar. Find the Binance Square API Key field. Paste your key and click Save Key.
Choosing news sources
ZynU can pull from 9 crypto news sites. By default, all of them are enabled. You can turn individual sources on or off from the Articles tab.
Available sources
- CoinDesk
- CoinTelegraph
- Decrypt
- The Block
- Blockworks
- Bitcoin Magazine
- CryptoSlate
- The Defiant
- Crypto.News
How to enable / disable
Open the Articles tab. At the top you'll see checkboxes for each source. Uncheck any source you don't want. Your selection is remembered automatically.
Coin analysis & posts
The Analysis tab reads the live market data for any coin and gives you a full trading picture — then writes and publishes a professional-looking analysis post to Binance Square in one click.
How to use it
Click Analysis in the sidebar.
Enter the coin you want to analyse, like BTCUSDT, ETHUSDT, or SOLUSDT. Choose a timeframe (1H, 4H, or 1D).
🔍 Analyze shows you the data. 🚀 Generate & Post writes an analysis post and gives you a Publish button to send it to Binance Square.
Token lookup & security audit
Search any crypto token by name, symbol, or contract address. Get live price data and an instant safety check — useful before you invest in anything.
How to look up a token
Click Token Lookup in the left menu.
E.g. "pepe", "DOGE", or paste a contract address. Choose the chain (BSC, Solana, Ethereum, or Base) and click Search.
Click any token in the results list to see price, market cap, holders, and the security audit results.
Understanding the security audit
- Risk: LOW — token passed all safety checks
- Buy/Sell Tax 0% — no hidden fees when trading
- Verified ✅ — source code is publicly verified
- No risks detected — no honeypot or rugpull patterns found
Wallet tracker
Paste any wallet address and see every token it holds, with current prices and values. Useful for tracking wallets of known traders or keeping an eye on smart money.
How to track a wallet
Click Wallet Track in the left menu.
Enter any on-chain wallet address. Choose the chain (BSC, Solana, or Base) and click 📡 Fetch.
A table shows every token in that wallet with current price, 24h change, quantity, and total USD value.
Install problems
Something went wrong during install? Every issue below has a simple fix. Click the problem that matches yours.
This means the terminal is not in the right folder. Run this to navigate to the correct place:
Replace ~/Downloads/zynu-bsq with the actual folder name where you extracted the files. Use ls to list what's in the current folder if you're unsure.
Python isn't installed on your system. Fix it with:
After that, run bash install.sh again.
The installer downloads Chromium (the browser engine), which is about 200MB. If your internet is slow this can take 5–10 minutes and look frozen — it's not. Wait up to 10 minutes.
If it's genuinely stuck (no progress for more than 15 minutes), press Ctrl + C to cancel, then run bash install.sh again.
This usually means a library didn't install correctly. Try reinstalling from scratch:
Then try opening the app again.
The file needs execute permission. Run:
Post not going through
The app ran but nothing appeared on your Binance Square? Here's how to diagnose and fix the most common causes.
First, scroll up in the Live Output box to find the exact red error message. The most common causes:
- Session expired — go to the Session tab and log in again (takes 2 minutes)
- No Groq key — go to API Keys and check that at least one key is listed
- No pending articles — go to Articles tab, click SCRAPE NOW, then try posting again
The Live Output said "✅ Published" but the post isn't on your profile? Two things to check:
- Wait 1–2 minutes and refresh your Binance Square profile — sometimes there's a short delay
- Check if Binance Square silently filtered the post — this can happen if the account is very new. Try posting once manually from the Binance Square website to confirm your account can post
This happens when all recent articles have already been used. Fix:
The browser-based posting failed. Most common fix: your session has expired. Go to Session tab → Open Browser & Login → log in → Confirm.
If that doesn't help, try adding a Binance Square API key (see the Square API Key section) — API posting bypasses the browser completely and is much more reliable.
Session & login issues
Session problems are the most common issue — and they're always fixable. Here's everything you need to know.
Your Binance session has expired or was never saved. Fix it in 2 minutes:
A browser opens. Log in to Binance and wait for the Square feed to load.
The browser may have an old corrupted session. Clear it first:
In the Session tab, click 🗑 Clear Session, then click Open Browser & Login again. This starts fresh with a clean browser.
Binance detected an unusual browser session and invalidated it. This is normal and happens every few weeks. The scheduler pauses automatically.
Fix: Log in again via Session tab → CONFIRM → restart the scheduler. To reduce how often this happens, consider adding a Binance Square API key — API posting doesn't expire like browser sessions do.
Complete the CAPTCHA manually in the browser window. After it passes, you'll see the normal Binance login page. Log in as usual, then click CONFIRM.
If CAPTCHAs appear frequently, try logging in from a different network (e.g. switch from WiFi to mobile hotspot once to get a clean session).
Content & AI issues
Problems with the post content — wrong language, too short, repetitive? These are all fixable.
ZynU instructs the AI to write in English. If posts appear in another language, it's usually because a Groq key has been rate-limited and the AI is behaving unexpectedly. Try clicking 🔍 Check All Keys in the API Keys tab to see which keys are still valid, and remove any that show "Invalid" or "Rate Limited."
The AI aims for 1,000–2,000 characters. If posts are shorter, the Groq API may be under heavy load. Two things to try:
- Add more Groq API keys — ZynU tries them in rotation until one succeeds
- In the Settings tab, check the Groq model — make sure it's set to llama-3.3-70b-versatile
ZynU rotates between 5 writing styles automatically. If posts feel similar it may be because the same news article topics keep appearing. Go to the Articles tab → SCRAPE NOW to pull in fresh news. You can also try enabling more news sources in the source checkboxes at the top of the Articles tab.
All Groq API keys failed. Go to the API Keys tab → 🔍 Check All Keys. Keys shown as "Rate Limited" will recover on their own in a few minutes. Keys shown as "Invalid" need to be replaced.
To get a new key: log in to console.groq.com, go to API Keys, create a new one, and add it via the ➕ Add Key button in ZynU.