← All guides
Getting Started

Troubleshooting

2026-10-27 · 2 min read
On this page

    Installing and starting

    • "Windows protected your PC": More info > Run anyway (the app isn't code-signed yet)
    • "Nothing happened": Check your system tray, likely through "^"
    • Signed in as the wrong account: the browser's pyontan account is the one the app logs into, log out and sign in again

    Translation

    • "<name isn't set up yet": the engine in use is missing a key or model (Settings > Provider)
    • "<name> rejected this API key": no internet, the service is down or a local server isn't running
    • Daily lines used up: wait until tomorrow, upgrade or use your own key. Settings > Billing > Usage on the website shows what is used

    OCR Capture

    • "(nothing found)": you're likely using the Windows OCR and you need to add Japanese to Windows or draw a bigger box around the content

    Live Audio

    • Won't start: install its add-on (Settings > Live Audio > Add-ons)
    • Nothing appears: check you're using the correct Audio source (Settings > Live Audio), otherwise nothing is playing on the picked source
    • Falling behind: pick a smaller Whisper model or use Streaming mode
    • "Live Audio limit reached": you've used up the daily limit, you'll know when it frees up from your profile

    Song Lyrics

    • Nothing shows: the player must show in Windows' media controls
    • "No timed lyrics found": the song couldn't be found on the lyrics API with timings, the API isn't perfect

    Manga Library

    • Nothing syncs: paste the sync token from Dashboard > Desktop sync into Settings > Cloud
    • "Storage full": remove old chapters or upgrade your tier

    Study

    • Reviews due on one device but not another: give it some time to sync, then check the time zone (Settings > Study)

    Android and Screen translate

    • No Screen link: update the app, then reopen it from the icon
    • "Couldn't reach pyontan": check your connection
    • "Restricted setting" when allowing the bubble: Phone Settings > Apps > pyontan, tap ⋮, then Allow restricted settings
    • Bubble asks again: Android may ask you after you lock your phone
    • Black picture: the app blocks screenshots

    Browser extension

    • Nothing translating: the extension needs to be signed in (or connected to the app) is the app running and the extension menu "Connected"
    • Stopped connecting after a new pairing code: well obviously paste the new code in!

    Contacting

    Feel free to send feedback (/feedback) or through Discord. Please explain the steps to reproduce, the version (tray menu > Help, at the top) and what happened

    Related guides
    Ready to try pyontan?
    Free covers the basics. No card needed.
    Download