Escbase user guide

Download and install

1. Get the installerOpen www.escbase.xyz, go to Download, and choose Mac or Windows. macOS needs Apple Silicon or Intel on macOS 14+. Windows needs 64-bit Windows 10+.
2. Install on macOSOpen the DMG, drag Escbase into Applications, then open it from Applications. Gatekeeper may ask you to allow Developer ID software once.
3. Install on WindowsRun the setup EXE. If SmartScreen warns that Windows protected your PC, choose More info → Run anyway — Escbase is notarized/signed for Preview and Production releases.
4. First launch downloads the engineThe app installer is light. On first open Escbase downloads the render engine (Python, Chromium, FFmpeg) into app data. Stay online until it finishes; later updates are usually app-only.

Google sign-in

• Failed, cancelled or incomplete renders do not use a trial slot.
• After a web purchase, keep the app open a few minutes or use Refresh so Pro appears.

1. Sign in inside the appChoose Continue with Google. Finish in the browser tab that opens, then return to Escbase. Use the same Google account if you buy Pro on the website.
2. Trial vs ProTrial has no day limit: 3 successful renders, 720p, Escbase watermark + outro, no batch. Pro Monthly is 30 days; Pro Yearly is 365 days. English checkout uses PayPal ($5 / $20). Vietnamese checkout uses PayOS (99.000đ / 499.000đ). Renewal is manual — no auto-charge.

How projects appear

• Keep Escbase open so the local API listens on 127.0.0.1:8775.
• In the app, open Tools and copy the ready-made prompt, or paste the prompt below into your agent.
• The agent writes a project under your local projects folder. Use Refresh in Escbase if it does not show up immediately.
• Each project is a folder with index.html, script, assets and later output/final_video.mp4.

Use the Escbase app API that is already open to create a new project from the following content [link/script,...]

What the agent needs

• GET /api/agent from the open app tells the agent kit paths and tooling.
• You do not need to know how to code — the Dashboard and Preview Editor are enough after the project exists.
• Projects stay on your computer even if Trial slots run out or Pro expires.

Typical preview pass

1. Open the projectPick it from Tất cả dự án / All projects on the dashboard.
2. Preview the slidePlay through captions and scenes. Fix text, timing or assets that look wrong before render.
3. Save preferencesVoice provider, speed, outro/logo ticks and render size are remembered for the next run (Trial keeps watermark and outro locked on).

Edge TTS

Built-in Microsoft voices. Good for a first trial render without any API key.

• Pick Edge TTS in the voice panel.
• Choose a Vietnamese or English voice and generate.
• No Escbase fee and no external account required.

Gemini voice

Use a Google AI Studio key when you prefer Gemini TTS.

• Create an API key in Google AI Studio.
• Save it in Escbase Settings under Gemini.
• Generate voiceover the same way as other providers.

Upload a voice file

• If you already have an MP3/WAV voiceover, choose the file pick in the voice panel.
• Desktop uses the system file dialog so the panel matches Finder / Explorer.

Single render

1. Stay signed inYou must be signed in with Google. If the app says the Google session is invalid, sign out and sign in again.
2. Start RenderConfirm voice, size and branding options, then start. A small Chromium window may appear while the slide is recorded — that is expected.
3. Find the fileWhen the job finishes, open the project → output → final_video.mp4, or use Watch in the app.

Stop a bad run

• Use Stop Render if something looks wrong — cancelled jobs do not use a trial slot.
• Do not force-quit mid-render unless the app is frozen; prefer Stop so the permit can finish cleanly.

Before you upload

• Finish a successful render so final_video.mp4 exists.
• Confirm Pro is active on the same Google account.
• Connect at least one YouTube channel or Facebook Page in Upload Center.

Accounts

• YouTube: set OAuth Client ID/Secret once (Khoá OAuth), then Add channel.
• Facebook: Add Page and complete the Meta login flow.
• You can keep several channels/Pages and remove any row with Xoá.

Google Cloud checklist

1. Create a Cloud projectIn Google Cloud Console, create a project and enable YouTube Data API v3.
2. Configure OAuth consentAdd yourself as a test user while the app is in Testing, or publish the consent screen for production use.
3. Create OAuth credentialsCreate an OAuth client. Copy Client ID and Client Secret into Escbase → Upload Center → Khoá OAuth.
4. Add channelChoose Thêm channel, finish Google consent, then pick the channel Escbase should upload to.

Meta checklist

1. Create a Meta appIn developers.facebook.com, create an app suitable for Page publishing.
2. PermissionsGrant the Page permissions Escbase requests (typically pages_manage_posts / pages_read_engagement style access). Keep the app Live or add yourself as a tester.
3. Add Page in EscbaseUpload Center → Thêm Page, finish Facebook login, and choose the Page.

App and Google session

• “Supabase could not verify the Google session” / phiên Google: sign out, sign in again, then retry.
• Pro from the website missing in the app: confirm the same Google account, wait a few minutes, or refresh account.
• First launch stuck: check the network; the engine download needs HTTPS to www.escbase.xyz.

Audio and render

• ElevenLabs errors: check key permissions, Voice ID and remaining credit.
• Gemini errors: confirm the AI Studio key and that Gemini voice is selected.
• Render stuck at 0%: make sure you are signed in and online so the export permit can be issued.

YouTube and Facebook

• redirect_uri_mismatch: paste the exact callback URI from Escbase into Google Cloud.
• YouTube invalid_grant: remove the old Escbase permission in Google Account → Security and connect again.
• Facebook permission errors: confirm Page role, app Live/tester status and token expiry.