{
  "schemaVersion": 1,
  "contentVersion": "ca42e61ede0a24f789d7287a0001244ad22f4abf",
  "id": "docs/tools/utilities/yuview",
  "collection": "docs",
  "title": "YUView",
  "description": "YUView is a raw YUV player and bitstream analyser for comparing frames side by side and inspecting HEVC, VVC and AV1 coding decisions.",
  "canonicalUrl": "https://encode.wiki/tools/utilities/yuview/",
  "apiUrl": "https://encode.wiki/api/v1/documents/docs/tools/utilities/yuview.json",
  "markdownUrl": "https://encode.wiki/api/v1/markdown/docs/tools/utilities/yuview.md",
  "status": "current",
  "tags": [
    "migrated"
  ],
  "license": "CC BY-SA 4.0",
  "dates": {
    "lastVerified": "2026-10-08T00:00:00.000Z"
  },
  "authors": [],
  "sources": [
    {
      "title": "YUView repository and README",
      "url": "https://github.com/IENT/YUView",
      "accessedAt": "2026-10-08T00:00:00.000Z"
    },
    {
      "title": "YUView v2.14 release",
      "url": "https://github.com/IENT/YUView/releases/tag/v2.14",
      "accessedAt": "2026-10-08T00:00:00.000Z"
    },
    {
      "title": "YUView wiki: external decoders",
      "url": "https://github.com/IENT/YUView/wiki/External-Decoders",
      "accessedAt": "2026-10-08T00:00:00.000Z"
    },
    {
      "title": "YUView wiki: YUV file names",
      "url": "https://github.com/IENT/YUView/wiki/YUV-File-Names",
      "accessedAt": "2026-10-08T00:00:00.000Z"
    },
    {
      "title": "YUView on Linux",
      "url": "https://github.com/IENT/YUView/wiki/YUView-on-Linux",
      "accessedAt": "2026-10-08T00:00:00.000Z"
    },
    {
      "title": "yuview source package in Ubuntu",
      "url": "https://launchpad.net/ubuntu/+source/yuview",
      "accessedAt": "2026-10-08T00:00:00.000Z"
    }
  ],
  "provenance": {
    "originUrl": "https://github.com/av1-community-contributors/codec-wiki/blob/37c3317fd058b23c71a87679bed5619a98f77752/docs/utilities/YUView.mdx",
    "originCommit": "37c3317fd058b23c71a87679bed5619a98f77752",
    "migratedAt": "2026-08-21T00:00:00.000Z",
    "modified": true,
    "originPath": "docs/utilities/YUView.mdx"
  },
  "headings": [
    {
      "depth": 2,
      "text": "Install it",
      "anchor": "install-it"
    },
    {
      "depth": 2,
      "text": "Open raw video",
      "anchor": "open-raw-video"
    },
    {
      "depth": 2,
      "text": "Compare encodes",
      "anchor": "compare-encodes"
    },
    {
      "depth": 2,
      "text": "Inspect bitstreams",
      "anchor": "inspect-bitstreams"
    },
    {
      "depth": 2,
      "text": "Related pages",
      "anchor": "related-pages"
    }
  ],
  "sections": [
    {
      "id": "_preamble",
      "title": "Page introduction",
      "depth": 0,
      "canonicalUrl": "https://encode.wiki/tools/utilities/yuview/",
      "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/_preamble.json",
      "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/_preamble.md",
      "checksum": "4a5219ff890f7f1193c403a1dd60ba1fa1981d66d55c5373b2602a06eb178cda",
      "bytes": 1056
    },
    {
      "id": "install-it",
      "title": "Install it",
      "depth": 2,
      "anchor": "install-it",
      "canonicalUrl": "https://encode.wiki/tools/utilities/yuview/#install-it",
      "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/install-it.json",
      "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/install-it.md",
      "checksum": "0f2bd44c96a39390c5b121bb7b2e68be147d89217ab6b53c3eb30479f529a861",
      "bytes": 514
    },
    {
      "id": "open-raw-video",
      "title": "Open raw video",
      "depth": 2,
      "anchor": "open-raw-video",
      "canonicalUrl": "https://encode.wiki/tools/utilities/yuview/#open-raw-video",
      "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/open-raw-video.json",
      "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/open-raw-video.md",
      "checksum": "6c73e8e00e246e964bfe09f8bc60083bbe72e4a8fe01877d23b6fdfd98a5eb24",
      "bytes": 865
    },
    {
      "id": "compare-encodes",
      "title": "Compare encodes",
      "depth": 2,
      "anchor": "compare-encodes",
      "canonicalUrl": "https://encode.wiki/tools/utilities/yuview/#compare-encodes",
      "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/compare-encodes.json",
      "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/compare-encodes.md",
      "checksum": "9c1ac75f4cafdf9a649a086e75b38c095005d6e3a234aeeb1c172195e3543fcd",
      "bytes": 422
    },
    {
      "id": "inspect-bitstreams",
      "title": "Inspect bitstreams",
      "depth": 2,
      "anchor": "inspect-bitstreams",
      "canonicalUrl": "https://encode.wiki/tools/utilities/yuview/#inspect-bitstreams",
      "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/inspect-bitstreams.json",
      "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/inspect-bitstreams.md",
      "checksum": "b1d11c9b7c720a17d8846e41647a8d4fc4ee852a727a007a84264e7caff31fb1",
      "bytes": 1034
    },
    {
      "id": "related-pages",
      "title": "Related pages",
      "depth": 2,
      "anchor": "related-pages",
      "canonicalUrl": "https://encode.wiki/tools/utilities/yuview/#related-pages",
      "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/related-pages.json",
      "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/utilities/yuview/related-pages.md",
      "checksum": "f981d90b8c08ff315ae682fac9cdea0021d3e64bcf249e0310a29e7e910a8e6a",
      "bytes": 156
    }
  ],
  "outboundReferences": [
    "/guides/compare-encoding-quality/",
    "/img/yuview.webp",
    "/tools/utilities/dav1d/",
    "/tools/utilities/ffmpeg/",
    "https://flathub.org/apps/de.rwth_aachen.ient.YUView",
    "https://github.com/IENT/YUView",
    "https://github.com/IENT/YUView/releases",
    "https://github.com/IENT/YUView/releases/tag/v2.14",
    "https://github.com/IENT/YUView/wiki/External-Decoders"
  ],
  "checksum": "ef581f6acf3dbcef9cd2a13a7010c2e95494c8f1aaee51de000e8196fc5efee7",
  "contentFormat": "markdown",
  "markdown": "<picture>\n  <source srcset=\"/img/yuview.avif\" type=\"image/avif\" />\n  <img src=\"/img/yuview.webp\" alt=\"YUView main window\" />\n</picture>\n\n> **Repository:** [IENT/YUView](https://github.com/IENT/YUView). The Free and Open Source Cross Platform YUV Viewer with an advanced analytics toolset. Latest release: [v2.14](https://github.com/IENT/YUView/releases/tag/v2.14), Sep 21, 2023. Last commit: Oct 8, 2026. Stars: 2,312.\n\n[YUView](https://github.com/IENT/YUView) is a Qt-based player and analysis tool from the Institut für Nachrichtentechnik (IENT) at RWTH Aachen. It is built for looking at video the way a codec developer does:\n\n- plays raw YUV and RGB files in almost any subsampling and bit depth, plus image sequences and anything FFmpeg can open;\n- zooms down to individual pixels and shows their values;\n- compares two videos side by side, in a comparison view, or as a difference image;\n- decodes HEVC, VVC and AV1 bitstreams with instrumented decoders and overlays their internals, such as block partitioning, prediction modes and motion vectors.\n\n## Install it\n\nThe latest release is v2.14 (September 2023), with Windows and macOS builds on the [releases page](https://github.com/IENT/YUView/releases). On Linux, install it from [Flathub](https://flathub.org/apps/de.rwth_aachen.ient.YUView) or from the Ubuntu archive (`sudo apt install yuview`; 24.04 LTS ships 2.13, 22.04 the much older 2.9). Development continues on the `develop` branch. On macOS, remove the quarantine flag after copying the app: `xattr -d com.apple.quarantine /Applications/YUView.app`.\n\n## Open raw video\n\nRaw `.yuv` files have no header, so YUView has to be told, or has to guess, the width, height, pixel format and frame rate. It reads them from the file name, so name files like `clip_1920x1080_24_yuv420p10le.yuv` (size, frame rate, FFmpeg pixel-format name) and it opens them correctly; otherwise it guesses from the file size and the first frames, and you correct the values in the properties panel. Wrong guesses are obvious: wrong dimensions give diagonal shearing, a wrong bit depth or subsampling gives garbled colours and stripes.\n\nTo produce a raw file from any video:\n\n```sh\nffmpeg -i input.mkv -frames:v 240 -pix_fmt yuv420p10le clip_1920x1080_24_yuv420p10le.yuv\n```\n\nRaw files are large (1080p 10-bit 4:2:0 is about 6 MB per frame), so export only the section you need. You can also open the MKV or MP4 directly through FFmpeg instead.\n\n## Compare encodes\n\nOpen the source and the encode, select both in the playlist, and choose the side-by-side or comparison view. The difference view highlights where an encode deviates from the source, which quickly points you at banding, smeared detail or ringing worth looking at. Use the same frame of each: if one file has extra or missing frames at the start, trim the raw export rather than comparing offset frames.\n\n## Inspect bitstreams\n\nOpen a raw bitstream to decode it with an analysis-capable decoder and show its statistics as overlays:\n\n| Codec | Input                                    | Decoder                                                    |\n| ----- | ---------------------------------------- | ---------------------------------------------------------- |\n| HEVC  | Annex B stream (`.hevc`, `.h265`)        | libde265 (a YUView-specific build), or the HM reference decoder |\n| AV1   | AV1 bitstream                            | dav1d (a YUView-specific build)                            |\n| VVC   | Annex B stream                           | VTM reference decoder (experimental)                       |\n\nThe instrumented decoder libraries are separate downloads, linked from the [external decoders](https://github.com/IENT/YUView/wiki/External-Decoders) wiki page. To get an Annex B HEVC stream out of a container (FFmpeg converts it to Annex B automatically for raw `.hevc` output):\n\n```sh\nffmpeg -i input.mkv -c:v copy out.hevc\n```\n\n## Related pages\n\n- [FFmpeg](/tools/utilities/ffmpeg/) and [dav1d](/tools/utilities/dav1d/)\n- [Compare encoding quality](/guides/compare-encoding-quality/)\n"
}
