HomeTroubleshootingA video will not start

A video will not start or keeps buffering

Most of the time it is the connection, the space on the device, or a chip that draws the picture badly. These steps go from the quickest check to handing the video to another player.

Updated

What to try, in order

  1. Look at the speed

    A video starts while it is still arriving, so a slow or cut connection shows as buffering. While it waits TMPlayer shows the speed: at 0 the network is the cause, not the player. Try Wi-Fi instead of mobile data, or choose Download in the video's menu and play it from Downloads once it is all there.

  2. Check there is room

    A full device cannot keep the part of the video it is playing. TMPlayer says "Not enough space" with how much is short. The guide for a full phone has the fixes, and Low storage mode streams with only a small part kept.

  3. Try the other decoder

    On some chips the hardware decoder draws green, blocky or frozen frames and reports no error. In the player's menu choose Try the other decoder, or turn on Prefer software video in Settings, Playback, and the app's own decoder draws the picture.

  4. Open it in another app

    In the player's menu choose Open in another app (on a TV, hold OK on the video), and pick VLC, MX Player or any other player on the device. A video still downloading goes over as far as it has got. Videos from chats that do not allow saving stay in TMPlayer.

  5. Send the logs

    If it keeps happening, Send logs shows what would be sent before it goes, and tells the developer which device, codec and connection it was. That is what lets it be fixed for the next person.

Star it if it helped

Every feature here started as someone's request. A star keeps that going.

Star on GitHub

Why a video may not play

  • A video posted in pieces (Name.part001, Name.mkv.001) plays only when every piece is in the chat. TMPlayer says which piece is missing.
  • A video kept in a ZIP plays only when the ZIP stores it uncompressed. A compressed ZIP, RAR or 7z has to be unpacked with a file manager first, and the chat's list says so.
  • Seeking far ahead restarts the download from that point, so a jump into a part that has not arrived waits for it.
  • A file that is not a video, or is cut short, has nothing to play. Opening it in Telegram shows what it is.

Still stuck?

Ask in the Telegram group or open an issue on GitHub, with the logs from Send logs if you can. Say the device, the video's size and format, and whether it plays from Downloads.

The questions page has more, and the Telegram group and GitHub issues are where to ask.

More help

Nothing here fixed it? The questions page covers the rest.

Download TMPlayer

For Android TV, phones, Windows, Linux and Apple Silicon Macs. Free, no account, straight from GitHub.

Pay by UPI (India)

Any amount counts, and the smallest one is not a small thing. Support it if it is useful to you.

Scan this with GPay, PhonePe, Paytm or any UPI app.

nevilnicks4321@okaxis