This repository contains shell components for Plasma Bigscreen.

• Project page: plasma-bigscreen.org
• Repository: invent.kde.org/plasma/plasma-bigscreen
• Documentation: invent.kde.org/plasma/plasma-bigscreen/-/wikis/home
• 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

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_QUICK_CONTROLS_STYLE=org.kde.breeze
export QT_ENABLE_GLYPH_CACHE_WORKAROUND=1
export QT_QUICK_CONTROLS_MOBILE=true
export PLASMA_INTEGRATION_USE_PORTAL=1
export PLASMA_PLATFORM=mediacenter
export QT_FILE_SELECTORS=mediacenter

# 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"