Skip to content

A Video File Misbehaves — Re-encode It With the evmux Video Converter

When this is the answer

Reach for this whenever someone reports trouble with a video file they brought in themselves — uploaded to the studio as media, added as a video layer or intro, or pushed through Media Share. Typical wording:

  • the video will not play, or plays as a black screen
  • it stutters, lags, freezes or goes choppy, in the studio or on the stream
  • there is no sound, or the audio drifts out of sync with the picture
  • it takes a very long time to start, or stalls partway through
  • it looked fine on their computer but behaves badly in evmux

Why a “working” file can still be a problem

People get video files from all sorts of places, or export them themselves with whatever settings a tool happened to suggest. The file can be perfectly valid and still be hostile to live playback in a browser:

  • a very high bitrate, far beyond what live playback needs — it plays locally off a fast disk, but not smoothly when it has to be streamed and composited
  • the header data sitting at the end of the file instead of the beginning, so playback cannot begin until the whole file has been read
  • unusual codecs, profiles, colour depths, variable frame rates or oversized resolutions

None of this is visible while the file is uploading, and evmux cannot detect it for the user in advance — the upload succeeds and the trouble only shows up at playback. So a file that “uploaded fine” is not evidence that the file is fine.

The fix: re-encode the file

Re-encoding rewrites the video into clean, streaming-friendly settings and clears up almost every case of this. evmux publishes its own converter so nobody has to go hunting for one:

https://publicfiles.evmux.com/static/videoConverter/download.html

Always give that exact link. Never tell someone to search for a video converter or to find the evmux encoder themselves — send them straight to that page.

About the tool, so expectations are right:

  • it is the evmux Video Converter, a small desktop program for Windows and macOS (macOS has both Intel and Apple Silicon downloads; the page detects the system)
  • the interface is deliberately simple — pick the video, convert, done. There is nothing to configure and no video knowledge needed; anyone can handle it
  • encoding takes some time, and how long depends on the computer’s graphics performance. A big file on a modest machine is a coffee break, not a click. That wait is normal and is not a sign anything is wrong

Then have them use the converted file in place of the original — upload the new file to the studio, or share that one instead. It is worth deleting the original from the media panel afterwards so nobody picks it again by mistake.

Answering these

Lead with the fix, not with diagnosis. There is no way to inspect the file from inside the studio, so do not send people through a long checklist first — recommend the re-encode, give the full link, say it is a simple Windows/Mac program with an easy interface, and mention that the conversion itself can take a while depending on their machine.

Do not promise the file is “corrupted” or blame their editor. The honest framing is that some perfectly ordinary video files carry settings that do not suit live streaming, and re-encoding puts that right.