Supported file types

Telegram-upload supports uploading of any file type supported by Telegram. This includes all common image formats, video, audio, and document files. But some file types supports extra features like video streaming or audio playback.

This document describes the supported file types and their features. The files are downloaded from filesamples.com using the supported_file_types.py script in the docs folder.

Keep in mind that the results may differ across platforms and Telegram clients. You can contribute by making a pull request to the repository.

Video file types

The following section shows the supported video file types and their features. This features includes:

  • Metadata: The file metadata is extracted correctly using Hachoir.

  • Video playback: The video can be played in Telegram.

  • Video streaming: The video can be streamed while it is being downloaded.

The default file name is “sample_960x400_ocean_with_audio” with 960x400 resolution and audio.

3gp

Third Generation Partnership Project.

  • Metadata: Yes.

  • Video playback: No.

  • Video streaming: No.

asf

Advanced Systems Format.

  • Metadata: Yes.

  • Video playback: No.

  • Video streaming: No.

avi

Audio Video Interleave.

  • Metadata: Yes.

  • Video playback: No.

  • Video streaming: No.

f4v

Flash Video.

  • Metadata: Yes.

  • Video playback: No.

  • Video streaming: No.

flv

Flash Video.

  • Metadata: Yes.

  • Video playback: No.

  • Video streaming: No.

hevc

High Efficiency Video Coding.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

m2ts

MPEG-2 Transport Stream.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

m2v

MPEG-2 Video.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

m4v

MPEG-4 Video.

  • Metadata: Yes.

  • Video playback: Yes.

  • Video streaming: Yes.

mkv

Matroska Multimedia Container.

  • Metadata: Yes.

  • Video playback: Yes.

  • Video streaming: No.

mov

QuickTime File Format.

  • Metadata: Yes.

  • Video playback: Yes.

  • Video streaming: Yes.

mp4

MPEG-4 Part 14.

  • Metadata: Yes.

  • Video playback: Yes.

  • Video streaming: Yes.

mjpeg

Motion JPEG.

Error uploading the file. See the issue #204

mpeg

MPEG-1 Video.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

mpg

MPEG-1 Video.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

mts

MPEG-2 Transport Stream.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

mxf

Material Exchange Format.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

ogv

Ogg Video.

  • Metadata: Yes.

  • Video playback: No.

  • Video streaming: No.

rm

RealMedia.

  • Metadata: Yes (but width & height are not available).

  • Video playback: No.

  • Video streaming: No.

ts

MPEG-2 Transport Stream.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

vob

DVD Video Object.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

webm

WEB Media.

  • Metadata: Yes.

  • Video playback: Yes.

  • Video streaming: No.

wmv

Windows Media Video.

  • Metadata: Yes.

  • Video playback: No.

  • Video streaming: No.

wtv

Windows Media Center TV.

  • Metadata: No.

  • Video playback: No.

  • Video streaming: No.

Audio file types

The following section shows the supported audio file types and their features. This features includes:

  • Metadata: The file metadata is extracted correctly using Hachoir.

  • Detected as audio: The file is detected as audio by Telegram.

  • Audio playback in Telegram desktop: The audio can be played in Telegram desktop.

  • Audio playback in Telegram Android: The audio can be played in Telegram android.

The tested Telegram desktop version is 4.8.3 under GNU/Linux and the tested Telegram android version is 9.6.7 under Android 13 (Google Pixel 6a).

The default file name is “sample4” with 4 minutes and 4 seconds of duration.

8svx

8-Bit Sampled Voice.

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

acc

Advanced Audio Coding.

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

ac3

Audio Codec 3.

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

aiff

Audio Interchange File Format.

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: No.

amb

Ambisonic B-Format.

  • Metadata: Yes.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

au

Sun Microsystems AUdio.

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: No.

avr

Audio Visual Research.

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

caf

Apple Core Audio File.

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

cdda

GSM 06.10 Lossy Speech Compression

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

cvs

Continuously Variable Slope Delta modulation.

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

cvsd

Continuously Variable Slope Delta modulation.

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

cvu

Continuously Variable Slope Delta modulation.

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

dts

Digital Surround Audio

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

dvms

Variable Slope Delta Modulation Audio

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

fap

PARIS Audio File Format

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

flac

Free Lossless Audio Codec

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: Yes.

fssd

FSSD Sound

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

gsrt

Grandstream Ring-tone Files

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

hcom

Macintosh HCOM files

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

htk

HTK

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

ima

Disk Image

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

ircam

Ircam Audio File

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

m4a

MPEG-4 Apple Lossless Audio Codec

  • Metadata: Yes.

  • Detected as audio: Yes (in desktop).

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: No.

m4r

iTunes Ringtone File

  • Metadata: Yes.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

maud

Amiga MAUD Audio Format

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

mp2

MPEG-1/2 Audio Layer 2 Format

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: Partially (no audio) but the progress bar works.

mp3

MPEG-1 Audio Layer-3

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: Yes.

nist

NIST (National Institute of Standards and Technology)

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

oga

OGG Vorbis Audio

  • Metadata: No.

  • Detected as audio: Yes (in mobile).

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: Yes.

ogg

Ogg Vorbis Compressed Audio

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: Yes.

opus

Opus Audio

  • Metadata: Yes.

  • Detected as audio: Yes (in mobile).

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: Yes.

paf

PARIS Audio File Format

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

prc

Psion Record Format

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

pvf

Portable Voice Format

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

ra

RealPlayer Audio

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: No.

sd2

Sound Designer 2

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

sln

Asterisk PBX

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

smp

Turtle Beach SampleVision File Format

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

snd

MS-DOS Audio

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: No.

sndr

MS-DOS 90’s Audio

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

sndt

MS-DOS 90’s Audio

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

sou

Solution User Options

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

sph

SPeech HEader Resources

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

spx

Speex Audio Compression Format

  • Metadata: No.

  • Detected as audio: Yes (in mobile).

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

tta

Free Lossless True Audio Codec

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

txw

Yamaha TX-16W sampler

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

vms

Dreamcast Visual Memory System File

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

voc

Creative Labs Audio File

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

vox

Dialogic Voice Audio File

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

w64

Sonic Foundry’s 64-bit RIFF/WAV Format

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

wav

Waveform Audio File Format

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: Yes.

wma

Microsoft Windows Media Audio Format

  • Metadata: Yes.

  • Detected as audio: Yes.

  • Audio playback in Telegram desktop: Yes.

  • Audio playback in Telegram Android: No.

wv

WavPack

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.

wve

Wondershare Filmora Project File

  • Metadata: No.

  • Detected as audio: No.

  • Audio playback in Telegram desktop: No.

  • Audio playback in Telegram Android: No.