Plasma Bigscreen

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 interface 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 the Free and Open Source Software.

Locations

• components - Shell components & controls libraries
• containments - Shell components (homescreen)
• kcms - Settings modules
• look-and-feel - Plasma look-and-feel package
• shell Plasma shell package, provides implementations for applet and containment configuration dialogs

Test on a development machine

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

Click here to see dependencies

KDE Plasma Dependencies

• Plasma Nano - https://invent.kde.org/plasma/plasma-nano

KDE Frameworks Dependencies

• Activities
• ActivitiesStats
• Plasma
• I18n
• Kirigami
• KCMUtils
• GlobalAccel
• Milou
• Notifications
• PlasmaQuick
• KIO
• Wayland
• WindowSystem
• KDEConnect
• SVG
• KScreen

Qt dependencies

• Quick
• Core
• Qml
• DBus
• Network

To start the Bigscreen homescreen in a window, 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"