Alpine Linux - User contributions [en]

PulseAudio

2025-02-10T21:45:26Z

Craft: Adding information about pulseaudio-utils since this fixes volume control support with Window Managers.

{{Note|[[PipeWire]] is a PulseAudio replacement, consider migrating.}}

== Installation ==

{{Cmd|apk add pulseaudio pulseaudio-alsa}}

== Alsa only applications support ==

Most applications on Alpine Linux are compiled to support only ALSA, foregoing linking against libpulse and the ability to dynamically switch to pulseaudio output when it finds that pulseaudio is running. Install the pulse output plugin for ALSA so applications can output to Pulseaudio.

{{Cmd|apk add alsa-plugins-pulse}}

== PulseAudio Utils ==

For pactl, which Window Managers commonly use for managing volume control, install pulseaudio-utils.

{{Cmd|apk add pulseaudio-utils}}

== Bluetooth ==

Before you can connect your device to Bluetooth speakers or headphones, you'll have to make sure {{Pkg|pulseaudio-bluez}} is installed. See the [[Bluetooth]] page for more general Bluetooth installation instructions.

{{Cmd|apk add pulseaudio-bluez}}

== Process Priority ==

Pulseaudio should run with an elevated priority, because e.g. crackling or delayed audio is more annoying than a low framerate in games.

Installing the shadow package (which is compiled against linux-pam) is an easy way for the non-root user to be granted the ability to change niceness, and pulseaudio is recommended to be run as the user, rather than as root. E.g. in {{Path|/etc/security/limits.d/audio.conf}} (and putting the user in the "audio" group):

@audio - nice -11

== See also ==
* [https://wiki.archlinux.org/title/PulseAudio Arch wiki]
* [https://wiki.gentoo.org/wiki/PulseAudio Gentoo wiki]
* [https://wiki.gentoo.org/wiki/PulseAudio#Without_udev_or_systemd Gentoo wiki - pipewire without udev]
* [https://wiki.postmarketos.org/wiki/Audio PostmarketOS Wiki - Audio]

[[category:Multimedia]]
[[Category:Sound]]

Include:Setup-desktop

2024-09-01T18:08:52Z

Craft:

{{Tip|Before installing a desktop, you may want to create a non-privileged [[Setting_up_a_new_user#Creating_a_new_user|user account]] for security reasons.}}
<br>
{{Note|To Install any desktop environment, [[Repositories#Managing_repositories|enable]] the <code>community</code> repository. [[Alpine_setup_scripts#setup-desktop|Setup-desktop]] script referred in [[Setup-desktop#Quickstart_Installation|Quickstart Installation]] automatically does this for you. }}

= Quickstart Installation =

The Alpine Linux script for setting up any desktop quickly is [[Alpine_setup_scripts#setup-desktop|setup-desktop]]. Desktop environements can be installed with this script, which is part of the standard Alpine Linux installation package {{pkg|alpine-conf|repo=main}}.

{{Cmd|# setup-desktop}}

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

{{Cmd|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 dependencies, standard utilities, commonly used applications and {{pkg|firefox|repo=main}} as browser. This script also activates the necessary services like dbus etc..

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

{{Cmd|# cat /sbin/setup-desktop}}

LXQt

2024-05-31T17:56:30Z

Craft: Listing Xorg suggested packages as a Cmd

{{TOC right}}

[[File:LXQt Minimal Installation.png | thumb | LXQt 1.3.0 Basic Install with Papirus icons]]

'''[https://lxqt-project.org/ LXQt]''' is a lightweight QT based desktop environment. LXQt was originally a port of LXDE to QT (called LXDE-Qt), it was created due to LXDE maintainer Hong Jen Yee being dissatisfied with GTK 3. On 21 July 2013 the LXDE(-Qt) and [https://en.wikipedia.org/wiki/Razor-qt Razor-qt] projects merged creating LXQt.

== Prerequisites ==

* [[Installation|Install]] Alpine Linux
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]] (running {{ic|setup-xorg-base}} is still a requirement even if using wayland)

== Basic LXQt Desktop Installation ==
Begin the installation by adding basic packages:
{{Cmd|# apk add {{Pkg|lxqt-desktop}} {{Pkg|lximage-qt}} {{Pkg|obconf-qt}} {{Pkg|pavucontrol-qt}}}}
If using Xorg, the following packages are also suggested:<br>
{{Cmd|# apk add {{Pkg|arandr}} {{Pkg|screengrab}} {{Pkg|sddm}}}}

{{Note|By default LXQt on Xorg uses [[Openbox]] as its window manager (it is a dependency of the {{Pkg|lxqt-desktop}} package). LXQt supports many different window managers and wayland compositors. Openbox has not been maintained for 9 years. Similar window managers are JWM and PeKWM. For additional Window Manager options See: [https://github.com/lxqt/lxqt/wiki/ConfigWindowManagers Window Managers Configuration on the LXQt GitHub wiki]}}

Starting dbus (desktop bus) service:
{{Cmd|# rc-service dbus start}}

Enabling dbus to start on boot:
{{Cmd|# rc-update add dbus}}

If dbus is not running it leads to issues like missing icons and keyboard shortcuts.

{{:Include:Setup_Device_Manager}}

== Starting LXQt ==

=== With a display manager (DM) ===

If the package {{Pkg|sddm}} has been installed, SDDM may be started to log in graphically with your new user.
{{Cmd|# rc-service sddm start}}

After correct operation is verified, sddm can be enabled to start up during boot:
{{Cmd|# rc-update add sddm}}

=== From the command line ===

LXQt for X11 may be started with:
{{cmd|# startlxqt}}

== Localized keyboard layout ==

Preferences → LXQt Settings → Keyboard and Mouse → Keyboard Layout

== Allowing shut down and reboot ==

To enable users to shut down the machine or reboot, the packages {{Pkg|elogind}} and {{Pkg|polkit-elogind}} need to be installed.
{{Cmd|# apk add elogind polkit-elogind}}

A reboot is required to let it take effect.

== Auto-mounting USB drives ==

To enable automatic mounting of USB drives, install these packages:
{{Cmd|# apk add {{pkg|gvfs|arch=}} {{pkg|udisks2|arch=}}}}

Depending on what devices you intend to mount, some additional packages may be needed:
{{Cmd|{{pkg|ntfs-3g|arch=}} Stable, full-featured, read-write NTFS (driver)
{{pkg|gvfs-cdda|arch=}} CDDA support for gvfs
{{pkg|gvfs-afp|arch=}} AFP support for gvfs
{{pkg|gvfs-goa|arch=}} GNOME Online Accounts support for gvfs
{{pkg|gvfs-mtp|arch=}} MTP support for gvfs
{{pkg|gvfs-smb|arch=}} Windows fileshare support for gvfs
{{pkg|gvfs-lang|arch=}} Languages for package gvfs
{{pkg|gvfs-afc|arch=}} Apple mobile devices support for gvfs
{{pkg|gvfs-nfs|arch=}} NFS support for gvfs
{{pkg|gvfs-dev|arch=}} Backends for the gio framework in GLib (development files)
{{pkg|gvfs-archive|arch=}} Archiving support for gvfs
{{pkg|gvfs-dav|arch=}} WebDAV support for gvfs
{{pkg|gvfs-fuse|arch=}} FUSE support for gvfs
{{pkg|gvfs-gphoto2|arch=}} gphoto2 support for gvfs
{{pkg|gvfs-avahi|arch=}} DNS-SD support for gvfs}}

To list descriptions of all gvfs- packages:

{{cmd|# apk info -d {{pkg|gvfs-*|arch=x86_64}}}}

== Network browsing ==

For browsing of network shares within LXQt that works with file associations, you can install the gvfs packages for the network protocols you use.

For example, to browse in a SMB/cifs windows network:

{{Cmd|# apk add gvfs-smb}}

(Check: If the above may already be sufficient for gvfs to initiate the fuse kernel module. Else, try to identify if there are necessary steps in:)

{{Cmd|# apk add gvfs-fuse}}

The OpenRC script for fuse is in a separate package.

{{Cmd|# apk add {{pkg|fuse-openrc|arch=}}}}

Then the fuse service can be started manually.

{{Cmd|# rc-service fuse start}}

If it works, the fuse service can be added to start up automatically at boot time:

{{Cmd|# rc-update add fuse}}

== Enabling privilege escalation GUI ==

To enable the privilege escalation GUI for a doas/sudo user, you need to install {{Pkg|elogind}}, {{Pkg|polkit-elogind}}, and {{Pkg|sddm}}.

To have elogind run, either make them start automatically at system start:

{{Cmd|# rc-update add elogind}}

or start them manually for this time only:

{{Cmd|# rc-service elogind start }}

== Panel Widgets ==

If you cannot add the CPU and System Statistics widgets to the panel, make sure {{Pkg|libstatgrab}} and {{Pkg|libsysstat}} are installed.

== Troubleshooting ==

=== Missing Icons and Fonts ===

By default a Desktop Environments needs icons. {{Pkg|adwaita-icon-theme}} is a good start.
{{Cmd|# apk add adwaita-icon-theme}}

See [[Fonts]] for more information on fonts.

== Optional Configuration ==

=== Screen Compositor ===

To enable different effects (transparency, for example) {{Pkg|picom}} can be used.

After installation, add it to the ''Autostart'' section of the '''LXQt Session Settings'''.

The default configuration is available in {{Path|/etc/xdg/picom.conf.example}}. For modifications, it can be copied to {{Path|~/.config/picom/picom.conf}} or {{Path|~/.config/picom.conf}}.

Either modify the config file to your taste, or change the Autostart command line options. For example, <code>picom --vsync -r 12 --no-fading-openclose -b</code>.

=== Appearance Tweaking ===

==== Location of appearance-related configuration files ====

User-specific configuration is stored in {{Path|~/.config/lxqt/}}.

LXQt themes are [https://doc.qt.io/qt-6/stylesheet.html qss stylesheets]. They are located in {{Path|/usr/share/lxqt/themes/}} or {{Path|~/.local/share/lxqt/themes}}.

Qt Palette colors can be modified in lxqt-config-appearence > Widget Style > Qt Palette. Custom palettes are saved in {{Path|~/.local/share/lxqt/palettes/}}.

==== Additional QT Styles ====

Several packages provide additional QT Styles:

{{Cmd|# apk add {{Pkg|adwaita-qt}} {{Pkg|breeze}} {{Pkg|oxygen}}}}

They also provide additional cursors.

==== Consistant Theming ====

Adding the KEY=VAL <code>QT_QPA_PLATFORMTHEME=lxqt</code> to the Environment section of the Session Settings [https://github.com/lxqt/lxqt-qtplugin#configuration-usage is suggested by the LXQt developers]. Then every Qt5 program can load the theme plugin.

Another option, however, is to to install the package {{Pkg|qt5ct}} (from [[Repositories | Testing]]) and appending the line <code>QT_QPA_PLATFORMTHEME=qt5ct</code> to the environmental settings in the Environment section of the Session Settings will allow you to achieve a unified appearance between apps. Then, in the LXQt Appearance Configuration, under Widget Style, set Qt Style to <code>qt5ct-style</code>.

==== Additional Packages ====

When using themes found around the web, it is possible that they are dependant on different packages. Consider using {{Pkg|qt5-qtgraphicaleffects}}, {{Pkg|qt5-qtquickcontrols}}, and {{Pkg|qt5-qtquickcontrols2}}.

== Documentation ==

* {{Pkg|lxqt-config-doc}}
* {{Pkg|lxqt-openssh-askpass-doc}}
* {{Pkg|lxqt-panel-doc}}
* {{Pkg|lxqt-policykit-doc}}
* {{Pkg|lxqt-runner-doc}}
* {{Pkg|lxqt-session-doc}}
* {{Pkg|lxqt-sudo-doc}}

== Development files ==

* {{Pkg|lxqt-globalkeys-dev}}
* {{Pkg|lxqt-panel-dev}}

== Misc ==

* {{Pkg|lxqt-build-tools}}

== See Also ==

* [[Installation#Post-Installation|Post Install]]
* [[Desktop environments and Window managers]]

= External Resources =

* [https://lxqt.github.io/ LXQt Homepage]
* [https://github.com/lxqt/lxqt LXQt on GitHub]
* [https://wiki.archlinux.org/title/LXQt LXQt entry on ArchWiki]
* [https://github.com/sddm/sddm SDDM Project on GitHub]

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

Weston

2024-05-26T14:36:09Z

Craft: Removed redirect to Wayland

== Installation ==

Steps to install Weston on Alpine 3.20

# doas apk add weston weston-backend-drm seatd weston-backend-wayland weston-shell-desktop weston-terminal font-dejavu
# doas rc-update add seatd
# doas adduser $USER seat
# doas setup-devd udev
# ~/.profile add:
if [ -z "$XDG_RUNTIME_DIR" ]; then
XDG_RUNTIME_DIR="/tmp/$(id -u)-runtime-dir"

mkdir -pm 0700 "$XDG_RUNTIME_DIR"
export XDG_RUNTIME_DIR
fi
# reboot
# Start weston with: weston

==== References ====
https://github.com/crftbt/OpenSourcedMe/blob/main/alpine/weston.md

LXQt

2024-05-22T19:52:07Z

Craft:

{{TOC right}}

[[File:LXQt Minimal Installation.png | thumb | LXQt 1.3.0 Basic Install with Papirus icons]]

'''[https://lxqt-project.org/ LXQt]''' is a lightweight QT based desktop environment. LXQt was originally a port of LXDE to QT (called LXDE-Qt), it was created due to LXDE maintainer Hong Jen Yee being dissatisfied with GTK 3. On 21 July 2013 the LXDE(-Qt) and [https://en.wikipedia.org/wiki/Razor-qt Razor-qt] projects merged creating LXQt.

== Prerequisites ==

* [[Installation|Install]] Alpine Linux
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]] (running {{ic|setup-xorg-base}} is still a requirement even if using wayland)

== Basic LXQt Desktop Installation ==
Begin the installation by adding basic packages:
{{Cmd|# apk add {{Pkg|lxqt-desktop}} {{Pkg|lximage-qt}} {{Pkg|obconf-qt}} {{Pkg|pavucontrol-qt}}}}
If using Xorg, the following packages are also suggested:<br>
{{Pkg|arandr}} {{Pkg|screengrab}} {{Pkg|sddm}}

{{Note|By default LXQt on Xorg uses [[Openbox]] as its window manager (it is a dependency of the {{Pkg|lxqt-desktop}} package). LXQt supports many different window managers and wayland compositors. Openbox has not been maintained for 9 years. Similar window managers are JWM and PeKWM. For additional Window Manager options See: [https://github.com/lxqt/lxqt/wiki/ConfigWindowManagers Window Managers Configuration on the LXQt GitHub wiki]}}

Starting dbus (desktop bus) service:
{{Cmd|# rc-service dbus start}}

Enabling dbus to start on boot:
{{Cmd|# rc-update add dbus}}

If dbus is not running it leads to issues like missing icons and keyboard shortcuts.

{{:Include:Setup_Device_Manager}}

== Starting LXQt ==

=== With a display manager (DM) ===

If the package {{Pkg|sddm}} has been installed, SDDM may be started to log in graphically with your new user.
{{Cmd|# rc-service sddm start}}

After correct operation is verified, sddm can be enabled to start up during boot:
{{Cmd|# rc-update add sddm}}

=== From the command line ===

LXQt for X11 may be started with:
{{cmd|# startlxqt}}

== Localized keyboard layout ==

Preferences → LXQt Settings → Keyboard and Mouse → Keyboard Layout

== Allowing shut down and reboot ==

To enable users to shut down the machine or reboot, the packages {{Pkg|elogind}} and {{Pkg|polkit-elogind}} need to be installed.
{{Cmd|# apk add elogind polkit-elogind}}

A reboot is required to let it take effect.

== Auto-mounting USB drives ==

To enable automatic mounting of USB drives, install these packages:
{{Cmd|# apk add {{pkg|gvfs|arch=}} {{pkg|udisks2|arch=}}}}

Depending on what devices you intend to mount, some additional packages may be needed:
{{Cmd|{{pkg|ntfs-3g|arch=}} Stable, full-featured, read-write NTFS (driver)
{{pkg|gvfs-cdda|arch=}} CDDA support for gvfs
{{pkg|gvfs-afp|arch=}} AFP support for gvfs
{{pkg|gvfs-goa|arch=}} GNOME Online Accounts support for gvfs
{{pkg|gvfs-mtp|arch=}} MTP support for gvfs
{{pkg|gvfs-smb|arch=}} Windows fileshare support for gvfs
{{pkg|gvfs-lang|arch=}} Languages for package gvfs
{{pkg|gvfs-afc|arch=}} Apple mobile devices support for gvfs
{{pkg|gvfs-nfs|arch=}} NFS support for gvfs
{{pkg|gvfs-dev|arch=}} Backends for the gio framework in GLib (development files)
{{pkg|gvfs-archive|arch=}} Archiving support for gvfs
{{pkg|gvfs-dav|arch=}} WebDAV support for gvfs
{{pkg|gvfs-fuse|arch=}} FUSE support for gvfs
{{pkg|gvfs-gphoto2|arch=}} gphoto2 support for gvfs
{{pkg|gvfs-avahi|arch=}} DNS-SD support for gvfs}}

To list descriptions of all gvfs- packages:

{{cmd|# apk info -d {{pkg|gvfs-*|arch=x86_64}}}}

== Network browsing ==

For browsing of network shares within LXQt that works with file associations, you can install the gvfs packages for the network protocols you use.

For example, to browse in a SMB/cifs windows network:

{{Cmd|# apk add gvfs-smb}}

(Check: If the above may already be sufficient for gvfs to initiate the fuse kernel module. Else, try to identify if there are necessary steps in:)

{{Cmd|# apk add gvfs-fuse}}

The OpenRC script for fuse is in a separate package.

{{Cmd|# apk add {{pkg|fuse-openrc|arch=}}}}

Then the fuse service can be started manually.

{{Cmd|# rc-service fuse start}}

If it works, the fuse service can be added to start up automatically at boot time:

{{Cmd|# rc-update add fuse}}

== Enabling privilege escalation GUI ==

To enable the privilege escalation GUI for a doas/sudo user, you need to install {{Pkg|elogind}}, {{Pkg|polkit-elogind}}, and {{Pkg|sddm}}.

To have elogind run, either make them start automatically at system start:

{{Cmd|# rc-update add elogind}}

or start them manually for this time only:

{{Cmd|# rc-service elogind start }}

== Panel Widgets ==

If you cannot add the CPU and System Statistics widgets to the panel, make sure {{Pkg|libstatgrab}} and {{Pkg|libsysstat}} are installed.

== Troubleshooting ==

=== Missing Icons and Fonts ===

By default a Desktop Environments needs icons. {{Pkg|adwaita-icon-theme}} is a good start.
{{Cmd|# apk add adwaita-icon-theme}}

See [[Fonts]] for more information on fonts.

== Optional Configuration ==

=== Screen Compositor ===

To enable different effects (transparency, for example) {{Pkg|picom}} can be used.

After installation, add it to the ''Autostart'' section of the '''LXQt Session Settings'''.

The default configuration is available in {{Path|/etc/xdg/picom.conf.example}}. For modifications, it can be copied to {{Path|~/.config/picom/picom.conf}} or {{Path|~/.config/picom.conf}}.

Either modify the config file to your taste, or change the Autostart command line options. For example, <code>picom --vsync -r 12 --no-fading-openclose -b</code>.

=== Appearance Tweaking ===

==== Location of appearance-related configuration files ====

User-specific configuration is stored in {{Path|~/.config/lxqt/}}.

LXQt themes are [https://doc.qt.io/qt-6/stylesheet.html qss stylesheets]. They are located in {{Path|/usr/share/lxqt/themes/}} or {{Path|~/.local/share/lxqt/themes}}.

Qt Palette colors can be modified in lxqt-config-appearence > Widget Style > Qt Palette. Custom palettes are saved in {{Path|~/.local/share/lxqt/palettes/}}.

==== Additional QT Styles ====

Several packages provide additional QT Styles:

{{Cmd|# apk add {{Pkg|adwaita-qt}} {{Pkg|breeze}} {{Pkg|oxygen}}}}

They also provide additional cursors.

==== Consistant Theming ====

Adding the KEY=VAL <code>QT_QPA_PLATFORMTHEME=lxqt</code> to the Environment section of the Session Settings [https://github.com/lxqt/lxqt-qtplugin#configuration-usage is suggested by the LXQt developers]. Then every Qt5 program can load the theme plugin.

Another option, however, is to to install the package {{Pkg|qt5ct}} (from [[Repositories | Testing]]) and appending the line <code>QT_QPA_PLATFORMTHEME=qt5ct</code> to the environmental settings in the Environment section of the Session Settings will allow you to achieve a unified appearance between apps. Then, in the LXQt Appearance Configuration, under Widget Style, set Qt Style to <code>qt5ct-style</code>.

==== Additional Packages ====

When using themes found around the web, it is possible that they are dependant on different packages. Consider using {{Pkg|qt5-qtgraphicaleffects}}, {{Pkg|qt5-qtquickcontrols}}, and {{Pkg|qt5-qtquickcontrols2}}.

== Documentation ==

* {{Pkg|lxqt-config-doc}}
* {{Pkg|lxqt-openssh-askpass-doc}}
* {{Pkg|lxqt-panel-doc}}
* {{Pkg|lxqt-policykit-doc}}
* {{Pkg|lxqt-runner-doc}}
* {{Pkg|lxqt-session-doc}}
* {{Pkg|lxqt-sudo-doc}}

== Development files ==

* {{Pkg|lxqt-globalkeys-dev}}
* {{Pkg|lxqt-panel-dev}}

== Misc ==

* {{Pkg|lxqt-build-tools}}

== See Also ==

* [[Installation#Post-Installation|Post Install]]
* [[Desktop environments and Window managers]]

= External Resources =

* [https://lxqt.github.io/ LXQt Homepage]
* [https://github.com/lxqt/lxqt LXQt on GitHub]
* [https://wiki.archlinux.org/title/LXQt LXQt entry on ArchWiki]
* [https://github.com/sddm/sddm SDDM Project on GitHub]

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