Troubleshooting
Fixes for common problems with outputs, the output server, media, sign-in and more.
Start here when something doesn’t work. If your problem isn’t listed, ask in the Discord community or report a bug.
Nothing shows in OBS or vMix
Section titled “Nothing shows in OBS or vMix”Work through these in order:
- Is a project open in Kinetra? The output server only runs while a project is open.
- Is the server running? The top of Kinetra’s window should show an address like
127.0.0.1:7770. If it says Port 7770 is in use or Server couldn’t start, see Port is in use. - Is the URL complete? It must end in
/screen/and the screen’s ID. Copy it again from Screens. - Is anything on air? The page is transparent when nothing is on air. Take a layer in Control.
- Is the connection working? Add
?debugto the end of the URL in OBS or vMix. A badge shows connected, connecting, reconnecting or unknown screen.- unknown screen: the screen was deleted, or another project is open.
- connecting for a long time: check the address and port.
- In OBS, check that the browser source is above your video in the source list, and its size matches the screen’s resolution.
- On another computer, see Outputs from another computer don’t load.
Port is in use
Section titled “Port is in use”Another program, or another copy of Kinetra, uses the port. Kinetra doesn’t switch ports by itself.
- Close the other program if you can, or
- Open Preferences › Network & API › Server and choose another Port, such as
7780. - Update the URLs in OBS or vMix to the new port.
Kinetra Canary uses port 7771 by default, so it can run next to Kinetra.
Outputs from another computer don’t load
Section titled “Outputs from another computer don’t load”- Turn on Preferences › Network & API › Server › Allow access from other devices on the network.
- Use the address under On your network, not
127.0.0.1. - If Windows asked about the firewall, allow Kinetra on private networks. If you missed the question, allow Kinetra in Windows Security › Firewall & network protection › Allow an app through firewall.
- Check that both computers are on the same network.
Graphics look wrong in OBS or vMix
Section titled “Graphics look wrong in OBS or vMix”- Animations don’t play, graphics just appear: make sure your templates don’t use
prefers-reduced-motion. See Template format. - Wrong font: templates can only use Kinetra’s fonts.
- Graphic is too small or cut off: set the browser source’s width and height to the screen’s resolution.
A graphic stays on screen after Clear
Section titled “A graphic stays on screen after Clear”The out-animation is still playing; it ends after at most 3 seconds. To remove everything at once, use Panic (Shift+Esc in Control).
Changes don’t go to air
Section titled “Changes don’t go to air”- The layer shows Changes on next take: Live edit is on On take. Click Take again. See Control.
- Studio mode is on: changes go to Preview. Click TAKE. See Studio mode.
Something happens by itself
Section titled “Something happens by itself”A flow or automation is running. Turn on Automation off in the Control toolbar to stop everything automatic. Cues and hotkeys still work. See Automation.
Video doesn’t play, or plays without sound
Section titled “Video doesn’t play, or plays without sound”Select the file in Sources › Media and read its playback warnings. Most problems are codecs: convert the file to H.264 MP4 with the Convert… command. See Will it play?.
A project file was damaged
Section titled “A project file was damaged”If a file in the project can’t be read, Kinetra says … was damaged and has been reset to defaults, and keeps the damaged copy next to it. Restore a snapshot from Preferences › Advanced › Backups to get your work back.
I can’t find Flows, MIDI, OSC or the HTML and CSS tabs
Section titled “I can’t find Flows, MIDI, OSC or the HTML and CSS tabs”They’re hidden in Simple mode. Switch to Advanced in Preferences › General › Mode.
Sign-in and license problems
Section titled “Sign-in and license problems”See Accounts and plans. The most common fixes:
- Check your internet connection, then click Check now in Preferences › License.
- Set your computer’s date and time automatically.
Kinetra asks “Exit Kinetra?”
Section titled “Kinetra asks “Exit Kinetra?””Graphics are still on air, or display outputs are showing. Closing Kinetra takes them off. Click Cancel to keep the show going, or Exit.
Updates won’t install
Section titled “Updates won’t install”You can’t install an update while graphics are on air or a display output is showing. Clear everything, turn the outputs off, and click Install and restart again.
A feature doesn’t work on a Mac
Section titled “A feature doesn’t work on a Mac”Some features don’t work on a Mac yet, such as display outputs and MIDI input. See Kinetra on macOS.
The app won’t start or open
Section titled “The app won’t start or open”On a new install, see Windows SmartScreen or macOS Gatekeeper.
Find the log file
Section titled “Find the log file”Kinetra writes a log file, kinetra.log. Open Preferences › About and click Open log folder. Include the log when you report a bug.