Waydroid - Revision history

Onny: /* V4L2 camera forwarding */ Simplify setup instructions

2026-05-29T05:42:31Z

V4L2 camera forwarding: Simplify setup instructions

@@ Line 122: / Line 122: @@
 === V4L2 camera forwarding ===
-Camera forwarding using V4L2 is broken on upstream, but can be achieved by using the Waydroid images of the [https://github.com/WayDroid-ATV Waydroid-ATV project]. Further we also need an unstable Waydroid version (>1.6.2) for running it.<syntaxhighlight lang="nix">
+Camera forwarding using V4L2 is broken on upstream, but can be achieved by using the Waydroid images of the [https://github.com/WayDroid-ATV Waydroid-ATV project]. You might [[Waydroid#Resetting Android Container|need to reset]] your existing Waydroid environment. Then stop the container and fetch the latest Waydroid-ATV images.<syntaxhighlight lang="bash">
 systemctl stop waydroid-container
 waydroid init -f \

Yuhohah: Added a helpful line to run waydroid in newer linux kernel versions

2026-05-13T01:57:38Z

Added a helpful line to run waydroid in newer linux kernel versions

← Older revision		Revision as of 01:57, 13 May 2026
Line 12:		Line 12:
	{		{
	virtualisation.waydroid.enable = true;		virtualisation.waydroid.enable = true;
			# Newer kernel versions may need
			virtualisation.waydroid.package = pkgs.waydroid-nftables;

	# Enable clipboard sharing		# Enable clipboard sharing
	environment.systemPackages = [ pkgs.wl-clipboard ];		environment.systemPackages = [ pkgs.wl-clipboard ];

Onny: /* Camera forwarding */

2026-05-05T08:58:28Z

Camera forwarding

← Older revision		Revision as of 08:58, 5 May 2026
Line 117:		Line 117:
	</syntaxhighlight>		</syntaxhighlight>

	=== ~~Camera~~ forwarding ===		=== V4L2 camera forwarding ===

	Camera forwarding using V4L2 is ~~not yet supported~~ upstream, but can be achieved by using the Waydroid images of the [https://github.com/WayDroid-ATV Waydroid-ATV project]. Further we also need an unstable Waydroid version (>1.6.2) for running it.<syntaxhighlight lang="nix">		Camera forwarding using V4L2 is broken on upstream, but can be achieved by using the Waydroid images of the [https://github.com/WayDroid-ATV Waydroid-ATV project]. Further we also need an unstable Waydroid version (>1.6.2) for running it.<syntaxhighlight lang="nix">
	disabledModules = [		disabledModules = [
	"virtualisation/waydroid.nix"		"virtualisation/waydroid.nix"

Onny: /* Notification forwarding */ Not required anymore in latest Waydroid versions

2026-05-04T07:02:47Z

Notification forwarding: Not required anymore in latest Waydroid versions

@@ Line 155: / Line 155: @@
 waydroid shell -- pm disable-user --user 0 com.google.android.gms.setup
 </syntaxhighlight>In case the camera access will crash the Waydroid container, there's a recent image which solves this on AMD GPUs. Download it and extract the contents to <code>/etc/waydroid-extra/images</code>. After that recreate the environment as mentioned above but only issue <code>waydroid init -f</code>.
 === Running applications that differ from the current host architecture via libhoudini or libndk<ref>Need help with activating libhoudini for waydroid on NixOS

Onny: /* Camera forwarding */ Add fix for AMD GPUs

2026-05-03T08:15:44Z

Camera forwarding: Add fix for AMD GPUs

← Older revision		Revision as of 08:15, 3 May 2026
Line 154:		Line 154:
	waydroid shell -- pm disable-user --user 0 com.google.android.setupwizard		waydroid shell -- pm disable-user --user 0 com.google.android.setupwizard
	waydroid shell -- pm disable-user --user 0 com.google.android.gms.setup		waydroid shell -- pm disable-user --user 0 com.google.android.gms.setup
	</syntaxhighlight>		</syntaxhighlight>In case the camera access will crash the Waydroid container, there's a recent image which solves this on AMD GPUs. Download it and extract the contents to <code>/etc/waydroid-extra/images</code>. After that recreate the environment as mentioned above but only issue <code>waydroid init -f</code>.

	=== Notification forwarding ===		=== Notification forwarding ===

Onny: /* Tips and tricks */ Add camera forwarding note

2026-05-03T08:08:37Z

Tips and tricks: Add camera forwarding note

← Older revision		Revision as of 08:08, 3 May 2026
Line 117:		Line 117:
	</syntaxhighlight>		</syntaxhighlight>

			=== Camera forwarding ===

			Camera forwarding using V4L2 is not yet supported upstream, but can be achieved by using the Waydroid images of the [https://github.com/WayDroid-ATV Waydroid-ATV project]. Further we also need an unstable Waydroid version (>1.6.2) for running it.<syntaxhighlight lang="nix">
			disabledModules = [
			"virtualisation/waydroid.nix"
			];
			imports = [
			"${inputs.nixpkgs-unstable}/nixos/modules/virtualisation/waydroid.nix"
			];

			nixpkgs.overlays = [
			(self: super: {
			waydroid = (inputs.nixpkgs-unstable.legacyPackages.x86_64-linux.waydroid.overrideAttrs (old: rec {
			version = "0-unstable-2026-04-26";
			src = pkgs.fetchFromGitHub {
			owner = "waydroid";
			repo = "waydroid";
			rev = "9478d59ad5c83b22478594e73d5879b93200fcb2";
			hash = "sha256-L4qU5TSWavxvyPUqVV00NCd0YZqAaKPWTe3dR/q15LE=";
			};
			}));
			})
			];
			</syntaxhighlight>You might [[Waydroid#Resetting Android Container\|need to reset]] your existing Waydroid environment. Then stop the container and fetch the latest Waydroid-ATV images.<syntaxhighlight lang="bash">
			systemctl stop waydroid-container
			waydroid init -f \
			-c https://waydroid-atv.github.io/ota/a16-qpr2/system \
			-v https://waydroid-atv.github.io/ota/a16-qpr2/vendor \
			-r lineage \
			-s GAPPS
			systemctl start waydroid-container
			waydroid session start

			</syntaxhighlight>In case the graphical interface wont show up or the setup wizard fails you can do<syntaxhighlight lang="bash">
			waydroid shell -- am start -a android.intent.action.MAIN -c android.intent.category.HOME
			waydroid shell -- pm disable-user --user 0 com.google.android.setupwizard
			waydroid shell -- pm disable-user --user 0 com.google.android.gms.setup
			</syntaxhighlight>
	=== Notification forwarding ===		=== Notification forwarding ===

Onny: /* Usage */

2026-04-30T06:45:50Z

Usage

← Older revision		Revision as of 06:45, 30 April 2026
Line 32:		Line 32:
	== Usage ==		== Usage ==

	Start the container		Start the container and userspace Wayland session. You'll know it is finished when you see the message "Android with user 0 is ready".

	<syntaxhighlight lang="console">		<syntaxhighlight lang="console">
	~~Start the Waydroid LXC container~~
	$ sudo systemctl start waydroid-container		$ sudo systemctl start waydroid-container

	~~You'll know it worked by checking the journal You should see "Started Waydroid Container".~~
	~~$ sudo journalctl -u waydroid-container -e~~

	~~Start Waydroid session~~
	~~You'll know it is finished when you see the message "Android with user 0 is ready".~~
	$ waydroid session start		$ waydroid session start
	</syntaxhighlight>		</syntaxhighlight>
Line 67:		Line 60:
	$ waydroid prop set persist.waydroid.width 608		$ waydroid prop set persist.waydroid.width 608
	</syntaxhighlight>		</syntaxhighlight>


	== Maintenance ==		== Maintenance ==

Onny: Restructuring

2026-04-30T06:40:35Z

Restructuring

← Older revision		Revision as of 06:40, 30 April 2026
Line 2:		Line 2:

	{{Warning\|Waydroid requires a [[Wayland]] desktop session and cannot be used on X11 directly, but can be run in a nested [[Wayland]] session, using e.g. [https://www.hjdskes.nl/projects/cage cage].}}		{{Warning\|Waydroid requires a [[Wayland]] desktop session and cannot be used on X11 directly, but can be run in a nested [[Wayland]] session, using e.g. [https://www.hjdskes.nl/projects/cage cage].}}
	~~{{Warning\|Installing Waydroid on your system before running nixos-generate-config will create unnecessary fstab entries that may interfere with system functionality.}}~~

	== Installation ==		== Installation ==

			{{Warning\|Installing Waydroid on your system before running nixos-generate-config will create unnecessary fstab entries that may interfere with system functionality.}}

	Enable Waydroid in your system configuration:		Enable Waydroid in your system configuration:

Onny: Restructuring and cleanup

2026-04-30T06:38:47Z

Restructuring and cleanup

@@ Line 67: / Line 67: @@
 </syntaxhighlight>
 == Maintenance  ==
@@ Line 119: / Line 108: @@
 === GPS/Location forwarding ===
 First enable ''geoclue2'' and ''adb'' daemon on the host<syntaxhighlight lang="nix">
 services.geoclue2.enable = true;
@@ Line 135: / Line 125: @@
 === Notification forwarding ===
 To forward notifications from the Waydroid container to the host system, [[KDE Connect]] can be used.
@@ Line 151: / Line 142: @@
 * If you get the system message "''Restricted setting / For your security, this setting is currently unavailable''", you'll have to enable restricted settings. Go to Android settings app, in the apps list select KDE connect and click in the upper right corner on the three dot menu to ''Allow restricted settings''
 * You may have to reboot the Waydroid container for notification forward to work.
 == Troubleshooting ==

Onny: /* Mount host directories */ Cleanup warning, not needed anymore

2026-04-30T06:37:08Z

Mount host directories: Cleanup warning, not needed anymore

← Older revision		Revision as of 06:37, 30 April 2026
Line 105:		Line 105:

	=== Mount host directories ===		=== Mount host directories ===
	~~{{Warning\|Parts of this instruction will only work with the latest waydroid-helper package in NixOS master and will be available with the next release 25.11}}~~Install and configure graphical application <code>waydroid-helper</code><syntaxhighlight lang="nix">
			Install and configure graphical application <code>waydroid-helper</code><syntaxhighlight lang="nix">
	environment.systemPackages = [ pkgs.waydroid-helper ];		environment.systemPackages = [ pkgs.waydroid-helper ];