PixelyChat / Manual
English
EnglishDeutschFrançaisEspañolPortuguês (Brasil)Bahasa Indonesia日本語한국어简体中文繁體中文العربية
Website ↗

Help

Troubleshooting

Fixes for the most common problems: empty overlays, missing sound, alerts, logins and updates.

Overlays in OBS

The Browser Source is empty

  • Make sure PixelyChat is running. The overlays come from the app.
  • Copy the URL again from Overlays and paste it into the source properties.
  • Check that the source is visible (eye icon) and above your camera, game and background.
  • Open the source properties and click Refresh cache of current page.
  • On the Dashboard, Overlay Status shows whether PixelyChat sees the source. Inactive is normal for a scene that is not loaded right now.

Linux: the source is empty or garbled, but its sound plays

This is caused by OBS's browser hardware acceleration on some Linux systems, especially under Wayland.

  1. In OBS, open Settings → Advanced.
  2. Under Sources, untick Enable Browser Source Hardware Acceleration.
  3. Restart OBS.

The overlay is cut off or in the wrong place

  • Chat: use the width and height from Overlays → Chat. They change when you change the chat window size.
  • Stream Scene: the source must cover your whole canvas, for example 1920 × 1080.
  • With the OBS integration on, Integrations → OBS Studio shows wrong sizes and Fix corrects them.

Sound and Text-to-Speech

No sound on stream or in recordings

  • Keep “Control Audio via OBS” enabled for PixelyChat Browser Sources.
  • If audio plays through your system or disappears from the OBS Audio Mixer, open the Browser Source properties, turn “Control Audio via OBS” off and save, then turn it on again.
  • Check that the source is not muted in the OBS Audio Mixer.
  • Text-to-Speech plays through the Chat Overlay source, alert sounds through the Stream Scene source. The matching source must be in your live scene.

Alerts or speech play twice

  • Two copies of the same source are live at the same time, for example the Stream Scene in two scenes that are shown together.
  • Remove one copy, or mute it in OBS. With the OBS integration on, Fix does this for you.

Speech sounds robotic or stays silent

  • PixelyChat uses an online voice. When it can't be reached, it uses your computer's own voice, which sounds more robotic.
  • If speech stops completely, your computer has no voice for that language. On Windows, add one in Settings → Time & language → Speech → Add voices. On a Mac, use System Settings → Accessibility → Spoken Content → System voice → Manage Voices.
  • Your own messages are not read while Don't read own messages is on. See Text-to-Speech.

Accounts and alerts

Test alerts work, but real ones don't

  • Open Accounts and check that the platform shows your account name. If not, log in again.
  • Check that the event is turned on in Alerts → Events.
  • Some events only exist on some platforms. See Updates, diagnostics & logs.
  • Recent Activity on the Dashboard shows what happened to each event, including anything that was skipped and why.

The wrong account is connected

  1. Open Accounts and disconnect the platform.
  2. Open Advanced and turn on Force fresh login.
  3. Log in again. You now get the platform's login screen instead of the account you were signed in with.

YouTube features stop working during a stream

YouTube limits how much an app can do per day. PixelyChat shows a notice when a limit is reached. The limits reset at midnight Pacific Time.

Installing and updating

Windows shows “Windows protected your PC”

Click More info, then Run anyway. The Microsoft Store version never shows this warning. See Install & update.

macOS won't open PixelyChat

Open System Settings → Privacy & Security and choose Open Anyway. This can happen again after an update. See Install & update.

The update check or download fails

  • Check your internet connection and try About → Check for Updates again.
  • You can always download the newest version from the download page and install it over the old one. Your settings stay.

Still stuck?

  1. Open About and click Run Diagnostics.
  2. Make the problem happen once more, then click Export Logs….
  3. Ask on the PixelyChat Discord. Include the log file, your app version and what you did.