Search Documentation
Search across all documentation pages
H.265

H.265

H.265 (also known as HEVC) is the successor to H.264, delivering roughly 40% better compression at the same visual quality. It is the codec of choice for 4K content and is well-supported across Apple devices, modern smart TVs, and streaming platforms. Transcodely uses the libx265 encoder.

Quick Start

{
  "type": "mp4",
  "video": [
    {
      "codec": "h265",
      "resolution": "2160p",
      "quality": "standard"
    }
  ]
}

H265Options Reference

Override defaults by passing the h265 object on a video variant:

{
  "codec": "h265",
  "resolution": "2160p",
  "quality": "premium",
  "h265": {
    "profile": "main10",
    "preset": "slow",
    "crf": 22,
    "tune": "grain"
  }
}

Key Differences from H.264

PropertyH.264H.265
CRF range15-3518-35
Tune optionsfilm, animation, grain, stillimage, fastdecodegrain, fastdecode
Profilesbaseline, main, highmain, main10, main-still-picture
Level range3.0-5.23.0-6.2 (8K support)
Encoding speedFasterSlower at same preset
Default CRF (standard)2326

Presets

Same naming convention as H.264, but H.265 is generally slower at each preset level:

PresetAllowedNotes
ultrafastYesVery fast, poor compression
superfastYes
veryfastYesDefault for economy tier
fasterYes
fastYes
mediumYesDefault for standard tier
slowYesDefault for premium tier
slowerYes
veryslowNot allowedMinimal gain at extreme cost
placeboNot allowed

Default by quality tier:

Quality TierDefault PresetDefault CRF
economyveryfast32
standardmedium26
premiumslow22

Profiles

ProfileBit DepthUse Case
main8-bitMaximum compatibility (default)
main1010-bitBetter gradients, HDR content, higher quality at same bitrate
main-still-picture8-bitSingle-frame encoding (screencasts, slideshows)

The main10 profile is recommended for premium-tier encodes and any content that will be graded or color-corrected. It produces smoother gradients and eliminates banding artifacts common in 8-bit encoding.

Levels

H.265 extends the level system to support 8K resolution:

LevelMax ResolutionMax FramerateMax Bitrate
3.0960x54030 fps6 Mbps
3.11280x72033 fps10 Mbps
4.02048x108030 fps12 Mbps
4.12048x108060 fps20 Mbps
5.04096x216030 fps25 Mbps
5.14096x216060 fps40 Mbps
5.24096x2160120 fps60 Mbps
6.08192x432030 fps60 Mbps
6.18192x432060 fps120 Mbps
6.28192x4320120 fps240 Mbps

Levels are auto-selected based on resolution and framerate. Override only when targeting specific device profiles.

CRF (Constant Rate Factor)

Allowed range: 18-35 (stricter than H.264).

CRF RangeQualityUse Case
18-20Near-losslessArchival, mastering
21-24High qualityPremium streaming
25-28Good qualityStandard streaming (default: 26)
29-32AcceptableMobile, previews
33-35Lower qualityLow-bandwidth delivery

H.265 CRF values are not directly comparable to H.264. An H.265 CRF of 26 produces roughly the same visual quality as an H.264 CRF of 23, at a significantly smaller file size.

Tune

H.265 supports fewer tune options than H.264:

TuneBest ForEffect
grainFilm grain, vintage footagePreserves grain texture, reduces artifacts
fastdecodeLow-power playbackDisables computationally expensive features

The film, animation, and stillimage tunes from H.264 are not available in H.265. The encoder handles content adaptation automatically.

Advanced Parameters

ParameterRangeDefaultDescription
bitrate100-240,000 kbpsNone (CRF mode)Target bitrate
maxrate100-240,000 kbpsNoneMaximum bitrate for VBV
bufsize100-480,000 kbpsNoneVBV buffer size
keyint1-600 frames250Maximum keyframe interval
min_keyint1-60 frames25Minimum keyframe interval
bframes0-16Per presetB-frames between I and P
ref1-16Per presetReference frames
rc_lookahead0-250Per presetRate control lookahead
aq_mode0-31Adaptive quantization mode
aq_strength0.0-3.01.0Adaptive quantization strength
psy_rd"str:trellis"Per tunePsychovisual optimization

Example: 4K HDR-Ready Encode

{
  "codec": "h265",
  "resolution": "2160p",
  "quality": "premium",
  "h265": {
    "profile": "main10",
    "preset": "slow",
    "crf": 20,
    "ref": 6,
    "bframes": 8
  }
}

Example: Efficient Mobile Delivery

{
  "codec": "h265",
  "resolution": "720p",
  "quality": "economy",
  "h265": {
    "profile": "main",
    "crf": 30
  }
}

Container Compatibility

H.265 works with: MP4, MKV, MOV, TS, HLS, DASH

H.265 does not work with: WebM