KDE: Difference between revisions

From Alpine Linux
m (Update links away from Post installation page)
m (added URL of upstream)
 
(30 intermediate revisions by 11 users not shown)
Line 1: Line 1:
[[File:KDEScreenshot.png |thumb |KDE Plasma screenshot.]]
[[File:KDEScreenshot.png |thumb |KDE Plasma screenshot.]]


KDE is a software project comprising a desktop environment known as Plasma, a collection of libraries and frameworks known as KDE Frameworks, and several applications known as KDE Applications. Their [https://userbase.kde.org/Welcome_to_KDE_UserBase UserBase wiki] has detailed information about most KDE Applications.
[https://kde.org/plasma-desktop/ Plasma] is the desktop environment from [https://kde.org/ KDE], a software project comprising of a collection of libraries known as [https://develop.kde.org/products/frameworks/ KDE Frameworks], and several applications known as [https://apps.kde.org/ KDE Applications]. Their [https://userbase.kde.org/Welcome_to_KDE_UserBase UserBase wiki] has detailed information about most KDE Applications.
 
{{Note|the {{Pkg|plasma}} package isn't available for the <code>ppc64le</code> and <code>s390x</code> architectures due to the {{Pkg|kdeplasma-addons}} dependency not being available there. However, the rest of Plasma can be installed separately to get a functional desktop.}}
 
<br>
 
== Prerequisites ==
 
* [[Installation|Install]] AlpineLinux
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Enable_Community_Repository|Enable the Community repository]]
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]]
 
{{Note|[[Wayland]] can be used but may be less stable and Plasma may still require Xorg}}
 
<br>
 
== Installation ==
 
==== Standard plasma installation ====
 
{{Cmd|# apk add plasma elogind polkit-elogind dbus}}
 
This will install the required Plasma packages, {{Pkg|sddm}} and pre-configure it to use the Breeze theme.


{{Note|the {{Pkg|plasma-desktop-meta|arch=}} package isn't available for the <code>ppc64le</code>, <code>s390x</code>, <code>armhf</code>, or <code>riscv64</code> architectures due to the {{Pkg|kdeplasma-addons|arch=}} dependency not being available there. However, the rest of Plasma may be installed separately to potentially get a functional desktop.}}
<br>
<br>


==== Lightweight plasma installation ====
{{:Include:Setup-desktop}}
 
Alternatively, a smaller installation can be done:


{{Cmd|# apk add plasma-desktop systemsettings sddm breeze elogind polkit-elogind dbus}}
When Plasma is chosen, the above utility also installs [[PipeWire|Pipewire]] for audio and [[SDDM]] as display manager.


<br>
== Manual Installation ==


{{Note|If you are missing something that is in a standard Plasma installation check out the dependencies of the {{Pkg|plasma}} package because it is likely you will find whatever your missing there.}}
=== Prerequisites ===


<br>
* For users interested in Xorg as opposed to Wayland, install the [[Alpine_setup_scripts#setup-xorg-base|Xorg base packages]]
* [[D-Bus#Installation|Install and configure D-Bus]]
* [[Elogind#Installation|Install and configure Elogind]]
* Wayland users: Install package {{pkg|xf86-input-libinput|arch=}}


For both installation methods you need to enable the following services:
The following command will install the Plasma desktop as specified by the plasma metapackage, including the {{Pkg|sddm|arch=}} display manager and other assorted niceties.


{{Cmd|# rc-update add dbus}}
{{Cmd|# apk add {{pkg|plasma-desktop-meta|arch=}}}}
{{Cmd|# rc-update add elogind}}
{{Cmd|# rc-update add polkit}}
{{Cmd|# rc-update add udev}}


<br>
{{:Include:Setup_Device_Manager}}


{{Note|'''polkit''' and '''udev''' are technically optional (or have other alternatives) but if they are not installed/started features (or the system) may not work properly, modify this at your own risk!}}
{{Note|'''polkit''' and '''udev''' are optional services for authentication and device management respectively. While KDE will function without these services enabled, some functionality may be missing or incomplete.}}


<br>
<br>
Line 57: Line 33:
To install the full set of KDE Applications, install {{Pkg|kde-applications}}. You can also choose to install a smaller set of applications by installing any of the subpackages:
To install the full set of KDE Applications, install {{Pkg|kde-applications}}. You can also choose to install a smaller set of applications by installing any of the subpackages:


* {{Pkg|kde-applications-accessibility}}
{{Note|Most of these are not available on <code>ppc64le</code> or <code>s390x</code>.}}
* {{Pkg|kde-applications-admin}}
* {{Pkg|kde-applications-accessibility|arch=}}
* {{Pkg|kde-applications-base}}
* {{Pkg|kde-applications-admin|arch=}}
* {{Pkg|kde-applications-edu}}, not available for <code>ppc64le</code> and <code>s390x</code>
* {{Pkg|kde-applications-base|arch=}}
* {{Pkg|kde-applications-games}}
* {{Pkg|kde-applications-edu|arch=}}
* {{Pkg|kde-applications-graphics}}
* {{Pkg|kde-applications-games|arch=}}
* {{Pkg|kde-applications-multimedia}}
* {{Pkg|kde-applications-graphics|arch=}}
* {{Pkg|kde-applications-network}}, not available for <code>ppc64le</code> and <code>s390x</code>
* {{Pkg|kde-applications-multimedia|arch=}}
* {{Pkg|kde-applications-pim}}, not available for <code>ppc64le</code> and <code>s390x</code>
* {{Pkg|kde-applications-network|arch=}}
* {{Pkg|kde-applications-sdk}}
* {{Pkg|kde-applications-pim|arch=}}
* {{Pkg|kde-applications-utils}}
* {{Pkg|kde-applications-sdk|arch=}}
* {{Pkg|kde-applications-webdev}}
* {{Pkg|kde-applications-utils|arch=}}
* {{Pkg|kde-applications-webdev|arch=}}


<br>
<br>
Line 76: Line 53:
Plasma can be started using a display manager or from the console.
Plasma can be started using a display manager or from the console.


==== Using a display manager ====
=== Using a display manager ===


When Plasma is installed via the {{Pkg|plasma}} meta-package, the display manager is set up using {{Pkg|sddm}}.
When Plasma is installed via the plasma meta-package, the display manager is set up using sddm.


Make sure you enable and start the SDDM service.
Make sure you enable and start the SDDM service.


<pre>
{{Cmd|rc-update add sddm
rc-update add sddm
rc-service sddm start
rc-service sddm start
</pre>
}}


* Select ''Plasma'' to launch a new session in Wayland
* Select ''Plasma'' to launch a new session in Wayland
* Select ''Plasma (X11)'' to launch a new session in Xorg
* Select ''Plasma (X11)'' to launch a new session in Xorg


==== From the console ====
=== From the console ===


The Xorg session can be launched by installing {{Pkg|xinit}} and appending <code>exec startplasma-x11</code> to your <code>.xinitrc</code> file. To start X:
The Xorg session can be launched by installing {{Pkg|xinit|arch=}} and appending <code>exec startplasma-x11</code> to your <code>.xinitrc</code> file. To start X:
{{Cmd|xinit}}
{{Cmd|xinit}}


For the Wayland session run
For the Wayland session run
<pre>
{{Cmd|XDG_SESSION_TYPE{{=}}wayland dbus-run-session startplasma-wayland}}
XDG_SESSION_TYPE=wayland dbus-run-session startplasma-wayland
</pre>


<br>
<br>
== Troubleshooting ==
=== HiDPI Scaling ===
When using high resolution screens, e.g. 4K, you might need to apply scaling so the fonts and windows are not too small.
In order to achieve this you can open <code>Settings -> Display and Monitor</code> and change the slider under ''Global Scale'' to an appropriate value.
You can also change the mouse cursor and icon size under <code>Settings -> Appearance</code>.
If your taskbar and window decorations are still too small, you might want to create the file {{path|~/.xprofile}} to define the ''PLASMA_USE_QT_SCALING'' environment variable:
{{Cmd|export PLASMA_USE_QT_SCALING{{=}}1}}
After creating this file, you may need to restart your session to apply this modification.


== See also ==
== See also ==
* [[Installation#Post-Install|Post Install]]
* [[Installation#Post-Installation|Post installation]]
* [[Flatpak]]
* [[Flatpak]]
* [https://wiki.archlinux.org/title/KDE KDE - Archwiki]


[[Category:Desktop]]
[[Category:Desktop]]
[[Category:Desktop Environments]]
[[Category:Wayland]]

Latest revision as of 10:34, 12 August 2024

KDE Plasma screenshot.

Plasma is the desktop environment from KDE, a software project comprising of a collection of libraries known as KDE Frameworks, and several applications known as KDE Applications. Their UserBase wiki has detailed information about most KDE Applications.

Note: the plasma-desktop-meta package isn't available for the ppc64le, s390x, armhf, or riscv64 architectures due to the kdeplasma-addons dependency not being available there. However, the rest of Plasma may be installed separately to potentially get a functional desktop.


Note: Before installing any desktop,

Installation using setup-desktop

The Alpine Linux script for setting up a desktop quickly is setup-desktop.

# setup-desktop

On running the above command, you will be prompted to select a desktop environment.

Which desktop environment? ('gnome', 'plasma', 'xfce', 'mate', 'sway' or 'none') [none]

Once you have chosen a desktop environment, this script installs the chosen desktop along with all the necessary packages, firefox browser and adds the necessary services to run on startup. You can reboot when complete and the system will boot into a graphical login screen with the desktop environment. Depending on the desktop chosen, the script also activates the necessary services like dbus, elogind, login manager etc..

To view all the packages that are installed by the script for the chosen desktop you can issue the below command:

# cat /sbin/setup-desktop

When Plasma is chosen, the above utility also installs Pipewire for audio and SDDM as display manager.

Manual Installation

Prerequisites

The following command will install the Plasma desktop as specified by the plasma metapackage, including the sddm display manager and other assorted niceties.

# apk add plasma-desktop-meta

Setting up eudev on a desktop system is recommended:

# setup-devd udev

For more details and advanced instructions see Device Manager.

Note: polkit and udev are optional services for authentication and device management respectively. While KDE will function without these services enabled, some functionality may be missing or incomplete.


KDE Applications

To install the full set of KDE Applications, install kde-applications. You can also choose to install a smaller set of applications by installing any of the subpackages:

Note: Most of these are not available on ppc64le or s390x.


Starting Plasma

Plasma can be started using a display manager or from the console.

Using a display manager

When Plasma is installed via the plasma meta-package, the display manager is set up using sddm.

Make sure you enable and start the SDDM service.

rc-update add sddm rc-service sddm start

  • Select Plasma to launch a new session in Wayland
  • Select Plasma (X11) to launch a new session in Xorg

From the console

The Xorg session can be launched by installing xinit and appending exec startplasma-x11 to your .xinitrc file. To start X:

xinit

For the Wayland session run

XDG_SESSION_TYPE=wayland dbus-run-session startplasma-wayland


Troubleshooting

HiDPI Scaling

When using high resolution screens, e.g. 4K, you might need to apply scaling so the fonts and windows are not too small.

In order to achieve this you can open Settings -> Display and Monitor and change the slider under Global Scale to an appropriate value.

You can also change the mouse cursor and icon size under Settings -> Appearance.

If your taskbar and window decorations are still too small, you might want to create the file ~/.xprofile to define the PLASMA_USE_QT_SCALING environment variable:

export PLASMA_USE_QT_SCALING=1

After creating this file, you may need to restart your session to apply this modification.

See also