Skip to content

feat: indicate which decoder is the reference with a mark in the list command #405

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rgonzalezfluendo merged 1 commit into from
Oct 26, 2026
Merged

feat: indicate which decoder is the reference with a mark in the list command #405

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 19 additions & 14 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,11 @@ For complete setup, usage examples, hardware acceleration configuration, and tro
3. List the test suites and the decoders available `./fluster.py list`.
Tip: You can list the decoders that can run in the current system with `./fluster.py list -c`.


The `[R]` mark identifies reference decoders, i.e. the decoders used to obtain
the reference results that other decoders are compared against.


```bash
List of available test suites:

Expand Down Expand Up @@ -424,16 +429,16 @@ H.264
GStreamer-H.264-VA: GStreamer H.264 VA decoder for GStreamer
GStreamer-H.264-VAAPI: GStreamer H.264 VAAPI decoder for GStreamer
GStreamer-H.264-Vulkan: GStreamer H.264 Vulkan decoder for GStreamer
JCT-VT-H.264: JCT-VT H.264/AVC reference decoder
JCT-VT-H.264: JCT-VT H.264/AVC reference decoder [R]
VKVS-H.264: Vulkan Video Samples H.264 decoder
ccdec-H.264: H.264 cros-codecs decoder

AC4
DolbyPADSReferenceDecoder: AC-4 Dolby Pro Audio Decoder Software Development Kit reference decoder implementation
DolbyPADSReferenceDecoder: AC-4 Dolby Pro Audio Decoder Software Development Kit reference decoder implementation [R]
Fluendo-AC4-SW: Fluendo AC4 SW decoder for GStreamer

EAC3
Dolby_EAC3PRODEC_ReferenceDecoder: Dolby EC-3 Online Delivery Kit 1.6 elementary stream reference decoder implementation
Dolby_EAC3PRODEC_ReferenceDecoder: Dolby EC-3 Online Delivery Kit 1.6 elementary stream reference decoder implementation [R]
Fluendo-EAC3-SW: Fluendo EAC3 SW decoder for GStreamer

Dummy
Expand All @@ -456,7 +461,7 @@ AV1
VKVS-AV1: Vulkan Video Samples AV1 decoder
ccdec-AV1: AV1 cros-codecs decoder
dav1d-AV1: dav1d AV1 decoder
libaom-AV1: libaom AV1 reference decoder
libaom-AV1: libaom AV1 reference decoder [R]

H.265
FFmpeg-H.265: FFmpeg H.265 SW decoder
Expand Down Expand Up @@ -484,7 +489,7 @@ H.265
GStreamer-H.265-VA: GStreamer H.265 VA decoder for GStreamer
GStreamer-H.265-VAAPI: GStreamer H.265 VAAPI decoder for GStreamer
GStreamer-H.265-Vulkan: GStreamer H.265 Vulkan decoder for GStreamer
JCT-VT-H.265: JCT-VT H.265/HEVC reference decoder
JCT-VT-H.265: JCT-VT H.265/HEVC reference decoder [R]
VKVS-H.265: Vulkan Video Samples H.265 decoder
ccdec-H.265: H.265 cros-codecs decoder

Expand All @@ -494,7 +499,7 @@ H.266
GStreamer-H.266-Libav: GStreamer H.266 Libav decoder for GStreamer
GStreamer-H.266-VA: GStreamer H.266 VA decoder for GStreamer
GStreamer-H.266-VVdeC: GStreamer H.266 VVdeC decoder for GStreamer
VVCSoftware_VTM-H266: VVCSoftware_VTM H.266/VVC reference decoder
VVCSoftware_VTM-H266: VVCSoftware_VTM H.266/VVC reference decoder [R]
VVdeC-H266: VVdeC H.266/VVC decoder

MPEG2_VIDEO
Expand All @@ -508,15 +513,15 @@ MPEG2_VIDEO
GStreamer-MPEG2_VIDEO-SW: GStreamer MPEG2_VIDEO SW decoder for GStreamer
GStreamer-MPEG2_VIDEO-V4L2: GStreamer MPEG2_VIDEO V4L2 decoder for GStreamer
GStreamer-MPEG2_VIDEO-V4L2SL: GStreamer MPEG2_VIDEO V4L2SL decoder for GStreamer
ISO-MPEG2-VIDEO: ISO MPEG2 Video reference decoder
ISO-MPEG2-VIDEO: ISO MPEG2 Video reference decoder [R]

MPEG4_VIDEO
FFmpeg-MPEG4_VIDEO: FFmpeg MPEG4_VIDEO SW decoder
Fluendo-MPEG4_VIDEO-SW: Fluendo MPEG4_VIDEO SW decoder for GStreamer
Fluendo-MPEG4_VIDEO-VAAPI: Fluendo MPEG4_VIDEO VAAPI decoder for GStreamer
Fluendo-MPEG4_VIDEO-VDPAU: Fluendo MPEG4_VIDEO VDPAU decoder for GStreamer
GStreamer-MPEG4_VIDEO-Libav: GStreamer MPEG4_VIDEO Libav decoder for GStreamer
ISO-MPEG4-VIDEO: ISO MPEG4 Video reference decoder
ISO-MPEG4-VIDEO: ISO MPEG4 Video reference decoder [R]

VP8
FFmpeg-VP8: FFmpeg VP8 SW decoder
Expand All @@ -533,7 +538,7 @@ VP8
GStreamer-VP8-VAAPI: GStreamer VP8 VAAPI decoder for GStreamer
GStreamer-VP8-libvpx: GStreamer VP8 libvpx decoder for GStreamer
ccdec-VP8: VP8 cros-codecs decoder
libvpx-VP8: VP8 reference decoder
libvpx-VP8: VP8 reference decoder [R]

VP9
FFmpeg-VP9: FFmpeg VP9 SW decoder
Expand All @@ -555,16 +560,16 @@ VP9
GStreamer-VP9-libvpx: GStreamer VP9 libvpx decoder for GStreamer
VKVS-VP9: Vulkan Video Samples VP9 decoder
ccdec-VP9: VP9 cros-codecs decoder
libvpx-VP9: VP9 reference decoder
libvpx-VP9: VP9 reference decoder [R]

AAC
Fluendo-AAC-SW: Fluendo AAC SW decoder for GStreamer
ISO-MPEG2-AAC: ISO MPEG2 AAC reference decoder
ISO-MPEG4-AAC: ISO MPEG4 AAC reference decoder
ISO-MPEG4-AAC-ER: ISO MPEG4 AAC ER reference decoder
ISO-MPEG2-AAC: ISO MPEG2 AAC reference decoder [R]
ISO-MPEG4-AAC: ISO MPEG4 AAC reference decoder [R]
ISO-MPEG4-AAC-ER: ISO MPEG4 AAC ER reference decoder [R]

MPEGH_3DA
ISO-MPEGH-3DA: ISO MPEG-H 3D Audio reference decoder
ISO-MPEGH-3DA: ISO MPEG-H 3D Audio reference decoder [R]

List of available profiles:

Expand Down
1 change: 1 addition & 0 deletions fluster/decoders/av1_aom.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ class AV1AOMDecoder(Decoder):
binary = "aomdec"
codec = Codec.AV1
annexb = False
is_reference = True
Comment thread
rgonzalezfluendo marked this conversation as resolved.
Resolved

def decode(
self,
Expand Down
1 change: 1 addition & 0 deletions fluster/decoders/h264_jct_vt.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ class H264JCTVTDecoder(Decoder):
description = "JCT-VT H.264/AVC reference decoder"
codec = Codec.H264
binary = "ldecod"
is_reference = True

def decode(
self,
Expand Down
1 change: 1 addition & 0 deletions fluster/decoders/h265_jct_vt.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ class H265JCTVTDecoder(Decoder):
description = "JCT-VT H.265/HEVC reference decoder"
codec = Codec.H265
binary = "TAppDecoder"
is_reference = True

def decode(
self,
Expand Down
1 change: 1 addition & 0 deletions fluster/decoders/h266_vvc_vtm.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ class H266VVCVTMDecoder(Decoder):
description = "VVCSoftware_VTM H.266/VVC reference decoder"
codec = Codec.H266
binary = "DecoderApp"
is_reference = True

def decode(
self,
Expand Down
1 change: 1 addition & 0 deletions fluster/decoders/libvpx.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ class VPXDecoder(Decoder):
description = ""
binary = "vpxdec"
codec = Codec.NONE
is_reference = True

def __init__(self) -> None:
super().__init__()
Expand Down
2 changes: 2 additions & 0 deletions fluster/fluster.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -210,6 +210,8 @@ def list_decoders(self, check: bool, verbose: bool, codec: Optional[Codec] = Non
print(f"\n{current_codec}")
for decoder in decoder_list:
string = f"{decoder}"
if decoder.is_reference:
string += " [R]"
if check:
string += "... " + (
self.emoji[TestVectorResult.SUCCESS]
Expand Down
Loading