Kodi Steam Deck development - Revision history

Garbear: /* Install missing pkg-config files */ Add groovy and jdk-openjdk packages

2026-03-07T14:27:11Z

Install missing pkg-config files: Add groovy and jdk-openjdk packages

← Older revision		Revision as of 14:27, 7 March 2026
Line 44:		Line 44:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	sudo pacman -S --overwrite '*' libx11 libxau libxcb libxdmcp libxrandr mesa		sudo pacman -S --overwrite '*' groovy jdk-openjdk libx11 libxau libxcb libxdmcp libxrandr mesa
	</syntaxhighlight>		</syntaxhighlight>

Garbear: /* Build depends (this takes about 45 minutes) */ Update build time

2026-03-07T13:07:01Z

Build depends (this takes about 45 minutes): Update build time

← Older revision		Revision as of 13:07, 7 March 2026
Line 68:		Line 68:
	</syntaxhighlight>		</syntaxhighlight>

	=== Build depends (this takes about 25 minutes) ===		=== Build depends (this takes about 45 minutes) ===

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">

Garbear: /* Create CMake files */ Organization

2026-03-04T14:15:15Z

Create CMake files: Organization

← Older revision		Revision as of 14:15, 4 March 2026
Line 76:		Line 76:
	=== Create CMake files ===		=== Create CMake files ===

	~~Optionally~~, ~~link~~ with LLD because ld.gold complains about newer DWARF formats:		First, set the parameters.

			Link with LLD because ld.gold complains about newer DWARF formats.

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	~~cd ~/Documents/kodi~~
	export CMAKE_EXTRA_ARGUMENTS="-DENABLE_LLD=ON"		export CMAKE_EXTRA_ARGUMENTS="-DENABLE_LLD=ON"
	export PKG_CONFIG_LIBDIR_EXTRA="/usr/lib/pkgconfig:/usr/share/pkgconfig"		export PKG_CONFIG_LIBDIR_EXTRA="/usr/lib/pkgconfig:/usr/share/pkgconfig"
			</syntaxhighlight>

			Generate the CMake files:

			<syntaxhighlight lang="bash" enclose="div">
			cd ~/Documents/kodi
	make -C tools/depends/target/cmakebuildsys		make -C tools/depends/target/cmakebuildsys
	</syntaxhighlight>		</syntaxhighlight>

Garbear: /* Create launcher script */ Add Alternative desktop Mode:

2026-03-04T14:09:53Z

Create launcher script: Add Alternative desktop Mode:

← Older revision		Revision as of 14:09, 4 March 2026
Line 128:		Line 128:
	# Desktop Mode (X11)		# Desktop Mode (X11)
	exec "${KODI_BIN}" -fs		exec "${KODI_BIN}" -fs

			# Alternative desktop Mode: provide a Wayland compositor via nested gamescope
			# and force 4K
			#exec /usr/bin/gamescope --expose-wayland -f -b -W 3840 -H 2160 -- "${KODI_BIN}" -fs

	EOL		EOL
	</syntaxhighlight>		</syntaxhighlight>

Garbear: /* Installation */ Update script and desktop file

2026-03-04T14:06:29Z

Installation: Update script and desktop file

← Older revision		Revision as of 14:06, 4 March 2026
Line 111:		Line 111:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	cat <<'EOL' > ~/bin/kodi~~-dev~~.sh		cat <<'EOL' > ~/bin/kodi.sh
	#!/usr/bin/env bash		#!/usr/bin/env bash
	set -euo pipefail		set -euo pipefail

	# Kodi needs this when running from the build tree		# Kodi needs this when running from the build tree
	export SSL_CERT_FILE=/home/deck/Documents/kodi/system/certs/cacert.pem		export SSL_CERT_FILE="/home/deck/Documents/kodi/system/certs/cacert.pem"

	~~# Disable SteamOS gamescope Vulkan implicit layer for this app~~		KODI_BIN="/home/deck/Documents/kodi/build/kodi.bin"
	~~# (prevents CreateSwapchainKHR "bad Vulkan layer" popup in Gaming Mode)~~
	~~export VK_LOADER_LAYERS_DISABLE~~="~~${VK_LOADER_LAYERS_DISABLE:-}:VK_LAYER_FROG_gamescope_wsi~~"

	~~# Clear any explicit Vulkan layer env that may be set~~		# Gaming Mode: already inside gamescope (Wayland)
	~~unset VK_LAYER_PATH~~
	~~unset VK_INSTANCE_LAYERS~~
	~~unset ENABLE_GAMESCOPE_WSI~~

	~~KODI_BIN="/home/deck/Documents/kodi/build/kodi-wayland"~~

	# Gaming Mode: already inside gamescope (~~do NOT nest gamescope again~~)
	if [[ -n "${STEAM_GAMEPADUI:-}" ]]; then		if [[ -n "${STEAM_GAMEPADUI:-}" ]]; then
	export WAYLAND_DISPLAY="${WAYLAND_DISPLAY:-gamescope-0}"		export WAYLAND_DISPLAY="${WAYLAND_DISPLAY:-gamescope-0}"
Line 135:		Line 126:
	fi		fi

	# Desktop Mode~~: provide a Wayland compositor via nested gamescope and force 4K~~		# Desktop Mode (X11)
	exec ~~/usr/bin/gamescope --expose-wayland -f -b -W 3840 -H 2160 --~~ "${KODI_BIN}" -fs		exec "${KODI_BIN}" -fs
	EOL		EOL
	</syntaxhighlight>		</syntaxhighlight>
Line 143:		Line 134:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	chmod +x ~/bin/kodi~~-dev~~.sh		chmod +x ~/bin/kodi.sh
	</syntaxhighlight>		</syntaxhighlight>

Line 151:		Line 142:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	cat <<'EOL' > ~/.local/share/applications/kodi~~-dev~~.desktop		cat <<'EOL' > ~/.local/share/applications/kodi.desktop
	[Desktop Entry]		[Desktop Entry]
	Version=1.0		Version=1.0
	Name=Kodi ~~(dev)~~		Name=Kodi
	GenericName=Media Center		GenericName=Media Center
	Comment=Manage and view your media ~~(dev build)~~		Comment=Manage and view your media
	Type=Application		Type=Application
	Terminal=false		Terminal=false
Line 162:		Line 153:
	Icon=/home/deck/Documents/kodi/tools/Linux/packaging/media/icon256x256.png		Icon=/home/deck/Documents/kodi/tools/Linux/packaging/media/icon256x256.png

	Exec=/home/deck/bin/kodi~~-dev~~.sh		Exec=/home/deck/bin/kodi.sh
	EOL		EOL
	</syntaxhighlight>		</syntaxhighlight>
Line 169:		Line 160:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	chmod +x ~/.local/share/applications/kodi~~-dev~~.desktop		chmod +x ~/.local/share/applications/kodi.desktop
	</syntaxhighlight>		</syntaxhighlight>

Line 181:		Line 172:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	cp ~/.local/share/applications/kodi~~-dev~~.desktop ~/Desktop/		cp ~/.local/share/applications/kodi.desktop ~/Desktop/
	</syntaxhighlight>		</syntaxhighlight>

Line 193:		Line 184:

	Click "Browse..." and select:		Click "Browse..." and select:
	<code>/home/deck/bin/kodi~~-dev~~.sh</code>		<code>/home/deck/bin/kodi.sh</code>

	After it is added, open Properties and set:		After it is added, open Properties and set:

	* Name: <code>Kodi ~~(dev)~~</code>		* Name: <code>Kodi</code>
	* Compatibility: ensure "Force the use of a specific Steam Play compatibility tool" is unchecked.		* Compatibility: ensure "Force the use of a specific Steam Play compatibility tool" is unchecked.

Garbear: /* Get/build the source code */ Update build instructions

2026-03-04T13:28:05Z

Get/build the source code: Update build instructions

← Older revision		Revision as of 13:28, 4 March 2026
Line 80:		Line 80:
	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	cd ~/Documents/kodi		cd ~/Documents/kodi
	make -C tools/depends/target/cmakebuildsys ~~CMAKE_EXTRA_ARGUMENTS="-DCORE_PLATFORM_NAME=wayland -DENABLE_LLD=ON"~~		export CMAKE_EXTRA_ARGUMENTS="-DENABLE_LLD=ON"
			export PKG_CONFIG_LIBDIR_EXTRA="/usr/lib/pkgconfig:/usr/share/pkgconfig"
			make -C tools/depends/target/cmakebuildsys
	</syntaxhighlight>		</syntaxhighlight>

Garbear: /* Environment Setup */ Update package list

2026-03-04T13:19:06Z

Environment Setup: Update package list

← Older revision		Revision as of 13:19, 4 March 2026
Line 44:		Line 44:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	sudo pacman -S --overwrite '*' libx11 libxcb ~~libxau~~ libxdmcp		sudo pacman -S --overwrite '*' libx11 libxau libxcb libxdmcp libxrandr mesa
	</syntaxhighlight>		</syntaxhighlight>

Garbear: /* Environment Setup */ Add section for missing X11 files

2026-03-04T12:17:56Z

Environment Setup: Add section for missing X11 files

← Older revision		Revision as of 12:17, 4 March 2026
Line 11:		Line 11:
	The following steps will allow you to compile Kodi on the Steam Deck:		The following steps will allow you to compile Kodi on the Steam Deck:

	=== Disable the read-only filesystem===		=== Disable the read-only filesystem ===

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
Line 33:		Line 33:
	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	sudo pacman -Syu		sudo pacman -Syu
			</syntaxhighlight>

			=== Refresh the file database ===

			<syntaxhighlight lang="bash" enclose="div">
			sudo pacman -Fy
			</syntaxhighlight>

			=== Install missing pkg-config files ===

			<syntaxhighlight lang="bash" enclose="div">
			sudo pacman -S --overwrite '*' libx11 libxcb libxau libxdmcp
	</syntaxhighlight>		</syntaxhighlight>

Garbear: /* Create desktop entry */ Improve readability

2026-02-22T06:09:26Z

Create desktop entry: Improve readability

← Older revision		Revision as of 06:09, 22 February 2026
Line 133:		Line 133:

	=== Create desktop entry ===		=== Create desktop entry ===

			Write the desktop file:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	~~mkdir -p ~/.local/share/applications~~

	cat <<'EOL' > ~/.local/share/applications/kodi-dev.desktop		cat <<'EOL' > ~/.local/share/applications/kodi-dev.desktop
	[Desktop Entry]		[Desktop Entry]
Line 150:		Line 150:
	Exec=/home/deck/bin/kodi-dev.sh		Exec=/home/deck/bin/kodi-dev.sh
	EOL		EOL
			</syntaxhighlight>

			Make it executable:

			<syntaxhighlight lang="bash" enclose="div">
	chmod +x ~/.local/share/applications/kodi-dev.desktop		chmod +x ~/.local/share/applications/kodi-dev.desktop
			</syntaxhighlight>

			Update the launcher database:

			<syntaxhighlight lang="bash" enclose="div">
	update-desktop-database ~/.local/share/applications 2>/dev/null \|\| true		update-desktop-database ~/.local/share/applications 2>/dev/null \|\| true
	</syntaxhighlight>		</syntaxhighlight>

			Copy the launcher to your desktop:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	cp ~/.local/share/applications/kodi-dev.desktop ~/Desktop/		cp ~/.local/share/applications/kodi-dev.desktop ~/Desktop/
	~~chmod +x ~/Desktop/kodi-dev.desktop~~
	</syntaxhighlight>		</syntaxhighlight>

Garbear: /* Create launcher script */ Improve readability

2026-02-22T06:07:32Z

Create launcher script: Improve readability

← Older revision		Revision as of 06:07, 22 February 2026
Line 87:		Line 87:

	=== Create launcher script ===		=== Create launcher script ===

			First, create a script directory:

	<syntaxhighlight lang="bash" enclose="div">		<syntaxhighlight lang="bash" enclose="div">
	mkdir -p ~/bin		mkdir -p ~/bin
			</syntaxhighlight>

			Then, write the script:

			<syntaxhighlight lang="bash" enclose="div">
	cat <<'EOL' > ~/bin/kodi-dev.sh		cat <<'EOL' > ~/bin/kodi-dev.sh
	#!/usr/bin/env bash		#!/usr/bin/env bash
Line 118:		Line 124:
	exec /usr/bin/gamescope --expose-wayland -f -b -W 3840 -H 2160 -- "${KODI_BIN}" -fs		exec /usr/bin/gamescope --expose-wayland -f -b -W 3840 -H 2160 -- "${KODI_BIN}" -fs
	EOL		EOL
			</syntaxhighlight>

			Finally, make it executable:

			<syntaxhighlight lang="bash" enclose="div">
	chmod +x ~/bin/kodi-dev.sh		chmod +x ~/bin/kodi-dev.sh
	</syntaxhighlight>		</syntaxhighlight>