This repository contains shell components for Plasma Bigscreen.

• Project page: plasma-bigscreen.org
• Repository: invent.kde.org/plasma/plasma-bigscreen
• Documentation: plasma-bigscreen.org/docs
• Wiki: userbase.kde.org/Plasma_Bigscreen
• Development channel: matrix.to/#/#plasma-bigscreen:kde.org

Plasma Bigscreen is a user-friendly, open-source, Wayland desktop environment designed for devices like HTPCs and SBCs connected to TVs and projectors. It provides an intuitive experience that allows for easy navigation from a distance using remote controls. Discover an engaging environment that adapts to your preferences, offering the safety and privacy protection that come with free and open source software!

• components - Shell components & controls libraries
• containments - Shell components (homescreen)
• envmanager - Utility that sets Plasma configuration
• inputhandler - Daemon that interprets controllers and TV remotes as keyboard input
• kcms - Settings modules
• lookandfeel - Plasma look-and-feel package
• settingsapp - The standalone settings application
• shell - Plasma shell package, provides implementations for applet and containment configuration dialogs
• uvcviewer - Standalone application to view camera input, paired with a UVC adapter it can view input from other devices (ex. consoles)
• webapp-viewer - Application to view webapps added from the settings

The plasma-bigscreen-inputhandler utility daemon handles CEC and game controller support. You can manually run it with:

PLASMA_PLATFORM=mediacenter plasma-bigscreen-inputhandler

For CEC support, ensure that your user has permission to access the device:

usermod -aG input $USER

If that doesn't work, the udev rule might not be working. Try this broader permission:

ls -l /dev/ttyACM* # Find the group the cec device belongs to

usermod -aG dialout $USER # Replace dialout with the group that the cec device belongs to

If CEC address detection fails, you can force the HDMI input used on the TV in ~/.config/plasma-bigscreen-inputhandlerrc. For example:

[CEC]
HDMIPort=2 # Default: 0 for automatic detection

It is recommended to use kde-builder to build this from source. See this wiki page in order to set it up.

To start the Bigscreen homescreen in a window, you can use the following script:

#/bin/bash

# Environment variables
export QT_ENABLE_GLYPH_CACHE_WORKAROUND=1
export PLASMA_INTEGRATION_USE_PORTAL=1
export PLASMA_PLATFORM=mediacenter
export QT_FILE_SELECTORS=mediacenter
export PLASMA_DEFAULT_SHELL=org.kde.plasma.bigscreen

# Set ~/.config/plasma-bigscreen/... as location for default bigscreen configs (i.e. envmanager generated)
export XDG_CONFIG_DIRS="$HOME/.config/plasma-bigscreen:/etc/xdg:$XDG_CONFIG_DIRS"

# ensure that we have our environment settings set properly prior to the shell being loaded (otherwise there is a race condition with autostart)
QT_QPA_PLATFORM=offscreen plasma-bigscreen-envmanager --apply-settings

export PLASMA_DEFAULT_SHELL=org.kde.plasma.bigscreen
dbus-run-session kwin_wayland "plasmashell -p org.kde.plasma.bigscreen"