etchdroid/Run with QEMU VM

Run a command while a QEMU VM is running

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Maintainedlast commit Apr 3, 2025
License: MIT

Pinned Snippet

workflow.ymlSHA-pinned

uses: etchdroid/qemu-kvm-action@44a25fe79f7d1defeca027ddc8fccbcabb966b04 # v1.0.2

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
qemu-executable	Path to the QEMU executable	no	qemu-system-x86_64
video-record	Whether to enable Xvfb and record a video. You still need to enable the display output in the QEMU flags.	no	false
video-output	Path to the video output file	no	recording.mkv
video-resolution	Video recording resolution (virtual display resolution)	no	1280x800
xbfb-screen	Xvfb screen number	no	0
x11-display	X11 display number	no	:95
cpu	Select CPU (run `qemu-system-x86_64 -cpu help` to see available CPUs)	no	host
enable-kvm	Whether to enable KVM	no	true
smp	Number of CPUs	no	4
memory	Memory size in MB	no	4096
kernel	Path to kernel image to boot, if booting a kernel directly	no	""
initrd	Path to initrd image to boot, if booting a kernel directly	no	""
cmdline	Kernel command line arguments, if booting a kernel directly	no	""
flags	Additional flags to pass to QEMU, newline-separated	no	""
run	Script to run in the VM	yes	—
shell	Shell to use to run the script	no	bash

Outputs

name	description
run-id	The ID of the run
ffmpeg-pid	The PID of the ffmpeg process, if video recording is enabled
xvfb-pid	The PID of the Xvfb process, if video recording is enabled
qemu-pid	The PID of the QEMU process
i3-pid	The PID of the i3 process, if video recording is enabled
video-output	The path to the video output file