FFmpeg: Re-Tag sRGB (IEC 61966-2-1) Footage as BT.709 Without Brightening the Image

Abstract: A true sRGB-to-BT.709 transfer conversion in FFmpeg lifts shadows and midtones; convert only matrix and range with zscale, then re-tag the transfer with setparams to keep the look identical.

Created: 2026-11-16 by

The brightening is not a bug: it is what a genuine sRGB-to-BT.709 transfer conversion does to display-referred material. If your goal is an output that is tagged BT.709 but looks identical to the source, do not convert the transfer at all. Convert only the matrix and range with zscale, then overwrite the transfer tag with setparams placed at the end of the filter chain. Command-line flags such as -color_trc bt709 will not work here, because the decoded frames carry their own color properties and those take precedence.

Why converting the transfer brightens the picture

sRGB (IEC 61966-2-1) and BT.709 share the same color primaries and white point, so the only real difference between the two tags is the transfer function. The catch is that the two curves are meant to be used differently. zscale treats t=bt709 as a scene-referred camera curve with an effective gamma of roughly 1.95, while a Blender sRGB export is display-referred data encoded near gamma 2.2. Re-encoding 2.2 display values through the BT.709 camera curve raises shadows and midtones, which is exactly the brightness lift you observed.

Nothing in the playback chain undoes this. mpv, ffplay, vlc and a straight PNG export all treat bt709 as display-referred as well, so the raised code values go straight to an sRGB screen unchanged. That is why every viewer you tested agrees on the brighter image.

Why the command-line flags did not take effect

Two separate mechanisms are at play:

  • Frame metadata outranks CLI options. The input frames carry iec61966-2-1 as a frame property. Output options such as -color_trc cannot override what the decoder attaches to each frame, so the sRGB tag survives into the output.
  • swscale ignores the transfer function. The default scaler only remaps matrix and range, which is why your first command produced visually identical output that was still tagged iec61966-2-1.

The working recipe: matrix and range only, then re-tag

Strip tin and t from the zscale invocation so it performs no transfer conversion, and append setparams after the pixel format conversion:

ffmpeg -i sample_original.mkv \
  -vf "zscale=min=gbr:rin=full:m=bt709:r=limited,format=yuv420p10le,setparams=colorspace=bt709:color_primaries=bt709:color_trc=bt709" \
  -c:v libx264 -qp 0 -preset ultrafast out.mkv

What each stage does:

  • zscale=min=gbr:rin=full:m=bt709:r=limited converts GBR full-range input to BT.709 limited-range YUV without touching the gamma-encoded values.
  • format=yuv420p10le finalizes the target pixel format.
  • setparams=... rewrites the frame properties so the output is tagged bt709/bt709/bt709. It changes metadata only, which is precisely why the picture stays the same.

Because this pipeline reduces 16-bit RGB to 10-bit YUV, consider adding d=error_diffusion to zscale to keep banding out of smooth gradients.

Verify the result

Check the stream properties rather than trusting the command you ran:

ffprobe -v error -select_streams v:0 -show_entries stream=pix_fmt,color_space,color_transfer,color_primaries,color_range -of default=noprint_wrappers=1 out.mkv

Also export the same frame from the input and the output as PNG and compare them. The images should match; only the tags differ.

Metadata re-tag vs. real conversion: which do you need?

Re-tagging is the right call when the content was mastered as sRGB, as with a Blender render, and must look identical in ordinary players. It is also widespread practice: the sRGB and BT.709 curves are close enough that virtually all playback pipelines treat them interchangeably, and labeling sRGB-like material as BT.709 is common in distribution.

A pixel-level conversion is only needed when a downstream tool requires files to be genuinely BT.709-encoded, or when the material will be mixed with true BT.709 camera footage in one pipeline. In that case use tin=iec61966-2-1 and t=bt709 on zscale, accept the brightness change, and compensate downstream if needed. There is no setting that gives you a true transfer conversion and an unchanged look at the same time; for this pair of curves the two goals are mathematically in conflict.

Frequently Asked Questions

Does setparams modify pixel values?

No. It rewrites the color metadata attached to frames. Confirm with ffprobe and by comparing a PNG export before and after; the picture should be unchanged.

Why did -color_trc bt709 not appear in my output?

Decoded frames carry their own color properties, and those beat output flags such as -color_trc. Change the property inside the filter graph with setparams instead.

Why is the zscale result brighter when I set tin and t?

Because that performs a real transfer conversion. The BT.709 camera curve, with an effective gamma around 1.95, applied to display-referred sRGB data near 2.2 lifts shadows and midtones.

Is it incorrect to label sRGB-encoded pixels as bt709?

Strictly speaking the label no longer describes the exact encoding, but the primaries match, the curves are close, and players treat both as display-referred. For general playback this is standard practice; for measurement-critical pipelines, do a real conversion instead.

Can I use the scale filter instead of zscale?

swscale can remap matrix and range, but zscale offers higher-quality processing and explicit dithering control when reducing depth. Either way you still need setparams for the transfer tag, since swscale never touches the transfer function.

Why do ffplay, mpv, VLC and PNG export all show the same brighter image?

None of them compensates for a transfer difference; they pass display-referred code values to the screen as-is, so the brightness lift from a real conversion is visible everywhere.

Latest News

How to Display Output of xterm Command in Terminal Screen using Cron

Resolve the inability to display xterm output in a terminal screen from cron by redirecting logs or using wall instead of insecure X11 workarounds.

Read More
Expose Local Server on VPS Preserving Real Client IPs (OS Level)

Resolve VPS logging showing only gateway IPs by configuring reverse proxies to forward real client addresses via X-Forwarded-For headers.

Read More
How to Clear Recent Files History in Linux without Deleting Actual Files?

Clear recent files history in Linux by deleting ~/.local/share/recently-used.xbel without removing the actual files.

Read More
Best HDD Copy Strategy: Manually Syncing and Rewriting Scratch

Resolve data drift between two 4TB hard drives by using rsync with the --delete flag to manually sync and rewrite scratch data for an exact mirror.

Read More
Understanding Bash Prompt Abbreviations: An Overview

Resolve repetitive typing errors by creating and persisting Bash aliases in the .bashrc file for improved command-line efficiency.

Read More
Free Tools and Methods to Log Real-Time Performance Details in Task Manager

Log real-time CPU and memory metrics to CSV files using Windows Performance Monitor Data Collector Sets to troubleshoot system slowness.

Read More
Contact Qatar Airways Customer Service: Phone Number, Help Center, and More

Resolve urgent Qatar Airways reservation issues like flight changes and baggage claims using the US phone number +1801-855-5905 or online self-service tools.

Read More
Windows 11: Alt Codes Displaying Wrong Characters - Solutions

Resolve Windows 11 Alt codes showing wrong characters by verifying the US keyboard layout and enabling Num Lock.

Read More
Run Programs with Elevated Privileges: A Comprehensive Guide

Eliminates the need to type sudo for frequent administrative tasks by configuring .bashrc aliases or functions.

Read More
Dynamically Changing Dates in Excel Formulas Using Cells

Eliminate manual date updates in Excel by using cell references to create dynamic formulas that automatically adjust calculations when input dates change.

Read More
Granting Edit Access to a Specific Excel Sheet in an Office 365 User Email ID-Based Login

Excel Online lacks native sheet-level permissions, so users must split workbooks or use worksheet protection to isolate edit access for specific tabs.

Read More
Creating Network Load on Local Wi-Fi from One PC

Generate sustained Wi-Fi bandwidth load from a single PC using a VM SFTP server to test router stability and throughput.

Read More
Changing the Default Editor for Batch Files in Windows 11's File Explorer

Resolve the issue of batch files opening in Notepad by changing the default editor to a preferred application like VS Code.

Read More
Gain WiFi Connection Minutes Before Losing it by Changing MAC Address

Bypass MAC address filtering to restore WiFi connectivity temporarily when a device is blocked by network administrators.

Read More
Photos Folders Turned Black: Troubleshooting Picture Applications on Windows

Resolve black screens in Windows Photos by resetting the app, updating graphics drivers, and repairing system files.

Read More
Troubleshooting High CPU Temperature Values: A Step-by-Step Guide

Resolve high CPU temperatures and thermal throttling by monitoring with Speedfan, cleaning dust from cooling components, and replacing degraded thermal paste.

Read More
Make cURL establish TLS connection with CA unknown

Resolve cURL TLS connection failures with unknown or self-signed certificates by using the --insecure flag to bypass CA validation.

Read More
Troubleshooting Incorrect Network Metrics Values in Grafana, Prometheus, InfluxDB, and Telegraf

Fix incorrect network metrics in Grafana, Prometheus, InfluxDB, and Telegraf by verifying interface selection, resolving unit mismatches, and handling counter resets.

Read More
Start Another Terminal Window (cmd.exe) Windows Repair/Troubleshoot

Provides step-by-step instructions to access the Windows Command Prompt via bootable media for advanced system repair and troubleshooting.

Read More
Thinkpad P1 Gen 6: Sudden Thunderbolt 3 Dock USB-C Charging Stopped Working

Resolve sudden Thunderbolt 3 dock USB-C charging and internet failure on ThinkPad P1 Gen 6 by updating firmware, resetting the dock, and adjusting power settings.

Read More
ASUS Windows 11 Laptop: Internet Connection Issue with Hotspot

Resolve ASUS Windows 11 laptop spinning wheel issue when connecting to mobile hotspot by resetting network stack, disabling IPv6, and adjusting power settings.

Read More
Developing iOS Project with Firebase: Logging in and Sending Push Notifications

Integrates Firebase to enable secure user authentication and push notifications in iOS applications.

Read More
Troubleshooting Bash Script with Suspected Issues of Spaces, Dashes, Filenames and Quoting

Resolve Bash script failures caused by word splitting, globbing, and special characters in filenames by applying proper quoting techniques.

Read More
Populating OneDrive Folder for Local Backup without Affecting Remote Files

Prevent OneDrive from deleting remote files during Windows reinstallation by unlinking the account or using symbolic links to isolate local data.

Read More
Force First Frame as Keyframe Without Re-encoding: A Quick Solution

Resolve inaccurate seeking and playback glitches by re-encoding video to ensure the first frame is a valid keyframe.

Read More
Find Information in Database Using WSL (Ubuntu) on Windows-10

Resolve database connection issues from WSL Ubuntu on Windows 10 by configuring client tools and network access to query remote or local servers.

Read More
Configuring a New Router with Different Networks: One Family, One Guest

Resolve IP conflicts and isolate guest traffic by configuring a second router with a distinct subnet via its WAN port.

Read More
Quickly Open Multiple Stock Websites with a Single Command

Solve the problem of manually opening multiple stock research websites by creating a single command to launch them simultaneously on Windows, macOS, or Linux.

Read More
Improved Adobe Acrobat Search Experience: Access Advanced Search with Ease

Access advanced search filters like case sensitivity and regex in Adobe Acrobat by clicking More Options in the Find bar.

Read More
Port Forwarding VM via OpenVPN: A Comprehensive Guide

Configure OpenVPN server and iptables to forward specific ports from VPN clients to a virtual machine's internal IP address.

Read More
Understanding Partitions in the 1980s: A Look Back at MS-DOS and Master Boot Record

Explains how the Master Boot Record and partition table enabled MS-DOS to manage multiple disk volumes on a single physical drive.

Read More
Windows 10 Enterprise: Keyboard Not Detected in Managed Organization with Admin Privileges

Resolve Windows 10 Enterprise keyboard detection failures caused by Group Policy restrictions, driver corruption, or USB enumeration errors.

Read More
Can't Find x86_64 Versions of Applications on MacOS arm64 (M1)

Resolve missing x86_64 app issues on M1 Macs by installing Rosetta 2 and reinstalling apps as universal binaries.

Read More
How to Hide Installation Source for an Android App

Manage Android app installation source visibility by using USB transfers or file managers to reduce browser traces and isolate data via work profiles.

Read More
Connecting Momentus 4200.2 ST9808210A Hard Drive via USB Cable

Resolve inability to access Seagate Momentus 4200.2 ST9808210A hard drive by connecting it via USB using a compatible SATA-to-USB adapter and configuring the disk in Windows.

Read More