Troubleshooting and FAQ
Most problems show up as a hint in the People table or a note at the top of the window. Here is what they mean.
Clicking a share link doesn't open the app
- Bellion Share has to be installed. The Windows installer and the Linux package register it for share links. If you use the portable zip, start it once so it registers itself, then click the link again.
- Your browser may ask whether to open Bellion Share; allow it.
- You can always copy the link and paste it into Watch someone in the app instead.
Someone shows "can't connect, retrying"
Bellion Share connects people directly. A direct connection can fail when a firewall or a strict router blocks it.
- A note at the top of the window says whether others can reach you. Bellion Share asks your router to open its UDP port (30471) with UPnP, NAT-PMP or PCP; if your router doesn't allow that, or sits behind another router or your provider's NAT, calls with people behind strict routers may fail.
- If you run a firewall, allow Bellion Share through it.
- When a direct path is blocked, a TURN server can forward the traffic (the connection hint then says so). It's still end-to-end encrypted.
- If it keeps failing, send logs from both sides (see below).
Low quality, stutter or delay
- The Connection column rates each link Good, Fair or Poor. Loss usually means an upload or download is full: try a lower resolution (Share > Resolution), or set someone's video to Low.
- For games pick Share > Tuned for > Game (60 fps); for text and code keep Desktop (sharper, 30 fps).
- If your computer can't encode fast enough, Bellion Share lowers the resolution itself and shows a note. Hardware encoding (NVIDIA, Intel, AMD) helps a lot.
- In a full mesh every sharer uploads once per viewer. Above about 5 people, set up a relay: someone with a fast upload volunteers from the People menu, or a spare PC or server relays for your group.
- "You can't see someone's stream: its quality is too high for your connection or computer right now" means Bellion Share couldn't find a size you can take. It keeps trying.
No sound from someone, or they hear an echo
- Sharing audio is off by default: the sharer picks Share > Audio you share. With Only these apps..., apps appear in the list while they play audio.
- Check you haven't muted them or turned their volume down, and pick the right device under Share > Play the call on.
- All apps leaves out Bellion Share itself, so the call isn't sent back.
Linux: nothing to share, or no windows listed
Bellion Share captures the screen through X11. Wayland sessions aren't supported yet: log in with an X11 (Xorg) session from your login screen's session menu.
I closed a video window
Use View > Show the video window (everyone in one window), or People > their name > Show their window.
The safety codes don't match
If someone's safety code differs from yours, the connection may be intercepted. Leave the session and start a new one. Bellion Share also refuses to connect to anyone whose encryption keys don't match their identity, and warns about it.
"Bellion Share ... is required"
Your version is too old to start or join sessions. Press Install and restart in the note (or use Help > Check for updates). When the app only says a newer version is available, you can keep using it and update when convenient; installing during a call restarts the app and rejoins the call.
Sending logs and feedback
Help > Logs and problem reports > Send logs to the developers sends your log; when two people can't connect, send logs from both sides. Help > Send feedback... sends an idea or a problem in your own words. Logs contain names and network addresses of the people you were in a session with; they're used only to fix problems and deleted after 30 days (see the Privacy Policy).
Is it free? Do I need an account?
Yes, it's free, and no account is needed. Bellion Share is open source under the AGPL-3.0: the source code is on GitHub.
Does it work on macOS or phones?
No. Bellion Share runs on Windows 10 and 11, and on Linux with X11.