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
-
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.
-
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.
-
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.
-
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.
-
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.
stars forks
Star on GitHubWhy 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.
Support TMPlayer
TMPlayer has no ads of our own (Telegram's sponsored messages appear in public channels, as Telegram requires) and no paid tier. If it saves you some bother, a coffee or a monthly sponsorship pays for the time that goes into it. It is voluntary and unlocks nothing: every feature is free for everyone.
No ads of our own and no paid tier. A coffee pays for the time that goes into it.