ROCm · kiritigowda · Jan 26, 2026 · Jan 28, 2026 · Jan 28, 2026 · Jan 28, 2026
diff --git a/.github/workflows/multi_arch_build_portable_linux.yml b/.github/workflows/multi_arch_build_portable_linux.yml
@@ -7,7 +7,7 @@
 # 4. comm-libs (per-arch) - RCCL (parallel to math-libs)
 # 5. dctools-core (generic) - RDC (parallel to math-libs)
 # 6. profiler-apps (generic) - rocprofiler-systems (parallel to math-libs)
-# 7. media (generic) - sysdeps-amd-mesa, rocdecode (todo), rocjpeg (todo)
+# 7. media-libs (generic) - sysdeps-amd-mesa, rocdecode, rocjpeg
 #
 # Artifacts flow between stages via S3 using the artifact_manager.py tool.
 #
@@ -684,10 +684,10 @@ jobs:
             --build-dir build
 
   # ==========================================================================
-  # STAGE: media (generic)
+  # STAGE: media-libs (generic)
   # ==========================================================================
-  media:
-    name: Stage - Media
+  media-libs:
+    name: Stage - Media Libs
     needs: foundation
     runs-on: azure-linux-scale-rocm
     timeout-minutes: 180  # 3 hours
@@ -698,7 +698,7 @@ jobs:
       options: -v /runner/config:/home/awsconfig/
     env:
       AWS_SHARED_CREDENTIALS_FILE: /home/awsconfig/credentials.ini
-      STAGE_NAME: media
+      STAGE_NAME: media-libs
     steps:
       - name: Checkout Repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

diff --git a/.gitmodules b/.gitmodules
@@ -68,3 +68,11 @@
 	path = math-libs/libhipcxx
 	url = https://github.com/ROCm/libhipcxx.git
 	branch = amd-develop
+[submodule "rocdecode"]
+	path = media-libs/rocdecode
+	url = https://github.com/ROCm/rocDecode.git
+	branch = therock
+[submodule "rocjpeg"]
+	path = media-libs/rocjpeg
+	url = https://github.com/ROCm/rocjpeg.git
+	branch = therock
diff --git a/BUILD_TOPOLOGY.toml b/BUILD_TOPOLOGY.toml
@@ -119,6 +119,11 @@ disable_platforms = ["windows"]
 description = "IREE integration submodules"
 submodules = ["iree", "fusilli"]
 
+[source_sets.media-libs]
+description = "ROCm media libraries submodules"
+submodules = ["rocdecode", "rocjpeg"]
+disable_platforms = ["windows"]
+
 # ==============================================================================
 # BUILD STAGES - Pipeline jobs that build sets of artifact groups
 # ==============================================================================
@@ -173,9 +178,9 @@ artifact_groups = ["iree-libs"]
 description = "Profiler applications (depends on profiler-core)"
 artifact_groups = ["profiler-apps"]
 
-[build_stages.media]
+[build_stages.media-libs]
 description = "Media Libraries"
-artifact_groups = ["media"]
+artifact_groups = ["media-libs"]
 
 # ==============================================================================
 # ARTIFACT GROUPS - Logical groupings of related artifacts
@@ -285,13 +290,11 @@ type = "generic"
 artifact_group_deps = ["hip-runtime"]
 source_sets = ["iree-libs"]
 
-[artifact_groups.media]
+[artifact_groups.media-libs]
 description = "Media Libraries"
 type = "generic"
 artifact_group_deps = ["third-party-sysdeps", "base"]
-# TODO: rocm-systems included for projects/hip/VERSION (see CMakeLists.txt)
-# amd-mesa disabled on Windows via source_set
-source_sets = ["amd-mesa", "rocm-systems"]
+source_sets = ["amd-mesa", "media-libs"]
 
 # ==============================================================================
 # ARTIFACTS - The actual build outputs that can be transmitted between stages
@@ -308,10 +311,10 @@ artifact_deps = []  # No dependencies on other artifacts
 feature_group = "CORE"  # Part of core, enabled by default
 
 [artifacts.sysdeps-amd-mesa]
-artifact_group = "media"
+artifact_group = "media-libs"
 type = "target-neutral"
 artifact_deps = ["sysdeps"]
-feature_group = "MEDIA"
+feature_group = "MEDIA_LIBS" # Controlled by THEROCK_ENABLE_MEDIA_LIBS
 disable_platforms = ["windows"]
 
 [artifacts.sysdeps-expat]
@@ -525,6 +528,22 @@ type = "target-neutral"
 artifact_deps = ["core-runtime", "core-hip", "hipdnn"]
 disable_platforms = ["windows"]
 
+# --- Media Integration ---
+
+[artifacts.rocdecode]
+artifact_group = "media-libs"
+type = "target-neutral"
+artifact_deps = ["core-runtime", "core-hip", "base", "sysdeps", "sysdeps-amd-mesa"]
+feature_group = "MEDIA_LIBS" # Controlled by THEROCK_ENABLE_MEDIA_LIBS
+disable_platforms = ["windows"]
+
+[artifacts.rocjpeg]
+artifact_group = "media-libs"
+type = "target-neutral"
+artifact_deps = ["core-runtime", "core-hip", "base", "sysdeps", "sysdeps-amd-mesa"]
+feature_group = "MEDIA_LIBS" # Controlled by THEROCK_ENABLE_MEDIA_LIBS
+disable_platforms = ["windows"]
+
 # --- Communication Libraries (per-arch) ---
 
 [artifacts.rccl]

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -87,7 +87,10 @@ ctest --test-dir build
 cmake -B build -GNinja \
   -DCMAKE_C_COMPILER_LAUNCHER=ccache \
   -DCMAKE_CXX_COMPILER_LAUNCHER=ccache \
-  -DTHEROCK_AMDGPU_FAMILIES=gfx1100
+  -DTHEROCK_AMDGPU_FAMILIES=gfx1100 \
+  -DTHEROCK_ENABLE_SYSDEPS_AMD_MESA=ON \
+  -DTHEROCK_ENABLE_ROCDECODE=ON \
+  -DTHEROCK_ENABLE_ROCJPEG=ON
 ```
 
 **Debug build for specific component:**
@@ -96,7 +99,10 @@ cmake -B build -GNinja \
 cmake -B build -GNinja \
   -DCMAKE_BUILD_TYPE=Release \
   -Drocblas_BUILD_TYPE=RelWithDebInfo \
-  -DTHEROCK_AMDGPU_FAMILIES=gfx1100
+  -DTHEROCK_AMDGPU_FAMILIES=gfx1100 \
+  -DTHEROCK_ENABLE_SYSDEPS_AMD_MESA=ON \
+  -DTHEROCK_ENABLE_ROCDECODE=ON \
+  -DTHEROCK_ENABLE_ROCJPEG=ON
 ```
 
 ### Top-Level Targets
@@ -171,6 +177,7 @@ base/           # rocm-systems (driver, runtime foundations)
 compiler/       # LLVM/Clang/LLD, device libraries
 core/           # HIP, CLR, ROCr
 math-libs/      # rocBLAS, rocFFT, etc.
+media-libs/     # rocdecode, and rocJPEG.
 ml-libs/        # MIOpen, composable_kernel
 comm-libs/      # RCCL
 profiler/       # rocprofiler, roctracer

diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -236,6 +236,7 @@ option(THEROCK_ENABLE_MATH_LIBS "Enable building of math libraries" "${THEROCK_E
 option(THEROCK_ENABLE_ML_LIBS "Enable building of ML libraries" "${THEROCK_ENABLE_ALL}")
 option(THEROCK_ENABLE_PROFILER "Enable building the profiler libraries" "${THEROCK_ENABLE_ALL}")
 option(THEROCK_ENABLE_DC_TOOLS "Enable building of data center tools" "${THEROCK_ENABLE_ALL}")
+option(THEROCK_ENABLE_MEDIA_LIBS "Enable building of Media libraries" "${THEROCK_ENABLE_ALL}")
 option(THEROCK_ENABLE_HOST_MATH "Build all bundled host math libraries by default" OFF)
 option(THEROCK_RESET_FEATURES "One-shot flag which forces all feature flags to their default state for this configuration run" OFF)
 # TODO(iree-org/fusilli/issues/57): Enable fusilli build once multi-arch support lands.
@@ -372,6 +373,8 @@ set(THEROCK_BUNDLED_NUMACTL)
 set(THEROCK_BUNDLED_SQLITE3)
 set(THEROCK_BUNDLED_ZLIB)
 set(THEROCK_BUNDLED_ZSTD)
+set(THEROCK_BUNDLED_AMDMESA)
+
 
 if(THEROCK_BUNDLE_SYSDEPS)
   message(STATUS "Building with bundled system dependencies enabled")
@@ -398,6 +401,9 @@ if(THEROCK_BUNDLE_SYSDEPS)
     set(THEROCK_BUNDLED_SQLITE3 therock-sqlite3)
     set(THEROCK_BUNDLED_ZLIB therock-zlib)
     set(THEROCK_BUNDLED_ZSTD therock-zstd)
+    if(THEROCK_ENABLE_SYSDEPS_AMD_MESA)
+      set(THEROCK_BUNDLED_AMDMESA therock-amd-mesa)
+    endif()
   elseif(CMAKE_SYSTEM_NAME STREQUAL "Windows")
     set(THEROCK_BUNDLED_BZIP2 therock-bzip2)
     set(THEROCK_BUNDLED_SQLITE3 therock-sqlite3)
@@ -440,6 +446,9 @@ add_subdirectory(comm-libs)
 add_subdirectory(math-libs)
 add_subdirectory(ml-libs)
 add_subdirectory(iree-libs)
+if(THEROCK_ENABLE_SYSDEPS_AMD_MESA)
+  add_subdirectory(media-libs)
+endif()
 
 if(THEROCK_BUILD_TESTING)
   add_subdirectory(examples)

diff --git a/README.md b/README.md
@@ -155,6 +155,7 @@ enable/disable selected subsets:
 | `-DTHEROCK_ENABLE_ML_LIBS=OFF`     | Disables all ML libraries            |
 | `-DTHEROCK_ENABLE_PROFILER=OFF`    | Disables profilers                   |
 | `-DTHEROCK_ENABLE_DC_TOOLS=OFF`    | Disables data center tools           |
+| `-DTHEROCK_ENABLE_MEDIA_LIBS=OFF`  | Disables all media libraries         |
 
 Individual features can be controlled separately (typically in combination with
 `-DTHEROCK_ENABLE_ALL=OFF` or `-DTHEROCK_RESET_FEATURES=ON` to force a
@@ -185,6 +186,9 @@ minimal build):
 | `-DTHEROCK_ENABLE_RDC=ON`              | Enables ROCm Data Center Tool (Linux only)    |
 | `-DTHEROCK_ENABLE_FUSILLI_PLUGIN=ON`   | Enables Fusilli Plugin                        |
 | `-DTHEROCK_ENABLE_LIBHIPCXX=ON`        | Enables libhipcxx                             |
+| `-DTHEROCK_ENABLE_SYSDEPS_AMD_MESA=ON` | Enables AMD Mesa for media libs (Linux only)  |
+| `-DTHEROCK_ENABLE_ROCDECODE=ON`        | Enables rocDecode video decoder (Linux only)  |
+| `-DTHEROCK_ENABLE_ROCJPEG=ON`          | Enables rocJPEG JPEG decoder (Linux only)     |
 
 > [!TIP]
 > Enabling any features will implicitly enable their *minimum* dependencies. Some

diff --git a/build_tools/analyze_build_times.py b/build_tools/analyze_build_times.py
@@ -64,6 +64,7 @@
     "dctools",
     "profiler",
     "ml-libs",
+    "media-libs",
 }
 
 # Regex to parse artifact filenames: <project>_<variant>[_suffix].tar.xz

diff --git a/build_tools/build_python_packages.py b/build_tools/build_python_packages.py
@@ -74,6 +74,14 @@ def run(args: argparse.Namespace):
         tarball_compression=args.devel_tarball_compression,
     )
 
+    # populate the media package
+    media = PopulatedDistPackage(params, logical_name="media")
+    media.populate_runtime_files(
+        params.filter_artifacts(
+            filter=functools.partial(media_artifact_filter),
+        )
+    )
+
     if args.build_packages:
         build_packages(args.dest_dir, wheel_compression=args.wheel_compression)
 
@@ -126,6 +134,15 @@ def libraries_artifact_filter(target_family: str, an: ArtifactName) -> bool:
     return libraries
 
 
+def media_artifact_filter(an: ArtifactName) -> bool:
+    media = an.name in [
+        "rocdecode",
+        "rocjpeg",
+        "sysdeps-amd-mesa",
+    ]
+    return media
+
+
 def main(argv: list[str]):
     p = argparse.ArgumentParser()
     p.add_argument(

diff --git a/build_tools/bump_submodules.py b/build_tools/bump_submodules.py
@@ -104,10 +104,10 @@ def parse_components(components: list[str]) -> list[list]:
     else:
         arguments.append("--no-include-debug-tools")
 
-    if "rocm-media" in components:
-        arguments.append("--include-rocm-media")
+    if "media-libs" in components:
+        arguments.append("--include-media-libs")
     else:
-        arguments.append("--no-include-rocm-media")
+        arguments.append("--no-include-media-libs")
 
     if "math-libraries" in components:
         arguments.append("--include-math-libraries")
@@ -204,7 +204,7 @@ def main(argv):
                   profiler,
                   iree-libs,
                   debug-tools,
-                  rocm-media,
+                  media-libs,
                   math-libraries
              """,
     )

diff --git a/build_tools/detail/linux_portable_build_in_container.sh b/build_tools/detail/linux_portable_build_in_container.sh
@@ -41,6 +41,8 @@ set -o xtrace
 time cmake -GNinja -S /therock/src -B "$OUTPUT_DIR/build" \
   -DTHEROCK_BUNDLE_SYSDEPS=ON \
   -DTHEROCK_ENABLE_SYSDEPS_AMD_MESA=ON \
+  -DTHEROCK_ENABLE_ROCDECODE=ON \
+  -DTHEROCK_ENABLE_ROCJPEG=ON \
   ${PYTHON_EXECUTABLES_ARG} \
   "$@"
 time cmake --build "$OUTPUT_DIR/build" --target therock-archives therock-dist
diff --git a/build_tools/fetch_sources.py b/build_tools/fetch_sources.py
@@ -106,8 +106,8 @@ def get_enabled_projects(args) -> List[str]:
         projects.extend(["rocm-systems"])
     if args.include_ml_frameworks:
         projects.extend(args.ml_framework_projects)
-    if args.include_rocm_media:
-        projects.extend(args.rocm_media_projects)
+    if args.include_media_libs:
+        projects.extend(args.media_libs_projects)
     if args.include_iree_libs:
         projects.extend(args.iree_libs_projects)
     if args.include_math_libraries:
@@ -463,7 +463,7 @@ def main(argv):
         help="Include machine learning frameworks that are part of ROCM",
     )
     parser.add_argument(
-        "--include-rocm-media",
+        "--include-media-libs",
         default=True,
         action=argparse.BooleanOptionalAction,
         help="Include media projects that are part of ROCM",
@@ -509,7 +509,7 @@ def main(argv):
         default=[],
     )
     parser.add_argument(
-        "--rocm-media-projects",
+        "--media-libs-projects",
         nargs="+",
         type=str,
         default=(
@@ -518,6 +518,8 @@ def main(argv):
             else [
                 # Linux only projects.
                 "amd-mesa",
+                "rocdecode",
+                "rocjpeg",
             ]
         ),
     )

diff --git a/build_tools/github_actions/build_configure.py b/build_tools/github_actions/build_configure.py
@@ -126,6 +126,8 @@ def build_configure(manylinux=False):
         )
         cmd.append(f"-DTHEROCK_DIST_PYTHON_EXECUTABLES={python_executables}")
         cmd.append("-DTHEROCK_ENABLE_SYSDEPS_AMD_MESA=ON")
+        cmd.append("-DTHEROCK_ENABLE_ROCDECODE=ON")
+        cmd.append("-DTHEROCK_ENABLE_ROCJPEG=ON")
 
     if PLATFORM == "windows":
         # VCToolsInstallDir is required for build. Throwing an error if environment variable doesn't exist

diff --git a/build_tools/github_actions/fetch_test_configurations.py b/build_tools/github_actions/fetch_test_configurations.py
@@ -267,6 +267,24 @@ def _get_script_path(script_name: str) -> str:
         "platform": ["linux"],
         "total_shards": 1,
     },
+    # rocdecode
+    "rocdecode": {
+        "job_name": "rocdecode",
+        "fetch_artifact_args": "--rocdecode",
+        "timeout_minutes": 60,
+        "test_script": f"python {_get_script_path('test_rocdecode.py')}",
+        "platform": ["linux"],
+        "total_shards": 1,
+    },
+    # rocjpeg
+    "rocjpeg": {
+        "job_name": "rocjpeg",
+        "fetch_artifact_args": "--rocjpeg",
+        "timeout_minutes": 60,
+        "test_script": f"python {_get_script_path('test_rocjpeg.py')}",
+        "platform": ["linux"],
+        "total_shards": 1,
+    },
     # aqlprofile tests
     "aqlprofile": {
         "job_name": "aqlprofile",