Openbox: Difference between revisions

Latest revision as of 07:19, 9 January 2025

Openbox is a minimalistic, highly configurable, next generation window manager with extensive standards support.

Note: Before installing any desktop,

Ensure you have Internet connectivity. If the test fails, setup your Internet access first, before you proceed further.
Create a non-privileged user account for security reasons, if you skipped this step during Installation.
Enable community repository.
Install graphics driver for your video hardware.

Installation

Install X11 and set it up using the setup-xorg-base script.

# setup-xorg-base

Install the basic packages for a minimal installation:

# apk add openbox xterm font-terminus

xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic. font-terminus is needed because without any fonts, you will not be able to see any text in Openbox.

Configure user

To make Xorg work as normal user you need to add user to these groups: video, input.

# addgroup <username> input

# addgroup <username> video

acpid

If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown.

# rc-update add acpid

Set Openbox as the default WM

$ echo 'exec openbox-session' >> ~/.xinitrc

Copy the config files to your home folder

$ mkdir ~/.config

$ cp -r /etc/xdg/openbox ~/.config

Note: The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages. More information is available in the Openbox configuration documentation. 🔓

Edit Openbox settings

You can now edit the Openbox settings for your user by editing the files located in ~/.config/openbox

The Openbox configuration details can be studied on the Openbox wiki.

Start X

$ startx

Note: The default Openbox menu (right-click on desktop) will have a lot of options that won't work because the required packages haven't been installed. XTerm will work if you added the package in the first step, and you can use that to add additional packages.

@@ Line 1: / Line 1: @@
-= Initial setup =
+[https://openbox.org/ Openbox] is a minimalistic, highly configurable, next generation window manager with extensive standards support.
-Start by booting Alpine (see [[Installation|these]] instructions on how to do that)<BR>
-= Enable Community Repository =
+{{:Include:Desktop prerequisites}}
-We need the Community Repository available for access to the OpenBox packages.
- Uncomment {{codeline|http://<url>/alpine/<version>/community}} in {{path|/etc/apk/repositories}}. For example:
+== Installation ==
-{{cat|/etc/apk/repositories|<nowiki># /etc/apk/repositories
+Install X11 and set it up using the <code>setup-xorg-base</code> script.{{Cmd|# setup-xorg-base}}
-The following commands will add the main and community repositories for the version you're using to APK, as well as the edge/testing repository.
+Install the basic packages for a minimal installation:{{Cmd|# apk add openbox xterm font-terminus}}
-You can manually add them to the '''/etc/apk/repositories''' file if you prefer.
+{{Pkg|xterm}} is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
+{{Pkg|font-terminus}} is needed because without any fonts, you will not be able to see any text in Openbox.
-The command '''apk update''' should be run after updating the file in either method.
+=== Configure user ===
-{{cmd|cat > /etc/apk/repositories << EOF; $(echo)
+To make Xorg work as normal user you need to add user to these groups: video, input.
-<nowiki>
-http://dl-cdn.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/main
-http://dl-cdn.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/community
-http://dl-cdn.alpinelinux.org/alpine/edge/testing
-</nowiki>
-EOF
-apk update}}
+{{Cmd|# addgroup <username> input}}
-These following commands should set up Xorg with Openbox and some necessary packages.
+{{Cmd|# addgroup <username> video}}
-{{cmd|setup-xorg-base openbox terminator slim dbus-x11 xf86-video-intel
+=== acpid ===
- xf86-video-ati xf86-video-amdgpu xf86-input-mouse xf86-input-keyboard setxkbmap
-rc-update add dbus
+If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown.
-rc-service dbus start
+{{Cmd|# rc-update add acpid}}
-apk add fuse gvfs gvfs-mtp gvfs-lang gvfs-archive gvfs-fuse gvfs-gphoto2
+=== Set Openbox as the default WM ===
-rc-update add fuse
+{{Cmd|$ echo 'exec openbox-session' >> ~/.xinitrc}}
-apk add faenza-icon-theme
+=== Copy the config files to your home folder ===
-}}
+{{Cmd|$ mkdir ~/.config}}
-This will install lot of packages as gtk, cairo, python, perl, and some xorg modules for device user interaction.
+{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}
-{{cmd|setup-xorg-base xf86-video-intel  xf86-video-ati xf86-video-amdgpu xf86-video-modesetting-0.9.0-r6
+{{Note|The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages. More information is available in the [http://openbox.org/wiki/Help:Configuration Openbox configuration documentation].{{insecure url|This server could not prove that it is openbox.org; its security certificate is from 2007.cccg.ca}}}}
-xf86-video-intel-2.99.917_git20170325-r0
-xf86-video-amdgpu-doc-1.3.0-r0
-xf86-video-sunleo-doc-1.2.2-r0
-xf86-video-nouveau-doc-1.0.15-r0
-xf86-video-vmware-doc-13.2.1-r0
-xf86-video-dummy-0.3.8-r0
-xf86-video-vesa-doc-2.3.4-r2
-xf86-video-nv-doc-2.1.21-r0
-xf86-video-nouveau-1.0.15-r0
-xf86-video-siliconmotion-doc-1.7.9-r0
-xf86-video-i740-1.3.6-r0
-xf86-video-apm-doc-1.2.5-r8
-xf86-video-savage-doc-2.3.9-r0
-xf86-video-amdgpu-1.3.0-r0
-xf86-video-s3virge-1.10.7-r1
-xf86-video-openchrome-doc-0.6.0-r1
-xf86-video-s3-doc-0.6.5-r8
-xf86-video-ast-1.1.5-r1
-xf86-video-apm-1.2.5-r8
-xf86-video-s3-0.6.5-r8
-xf86-video-fbdev-doc-0.4.4-r5
-xf86-video-siliconmotion-1.7.9-r0
-xf86-video-vmware-13.2.1-r0
-xf86-video-r128-doc-6.10.2-r0
-xf86-video-ati-doc-7.9.0-r0
-xf86-video-sunleo-1.2.2-r0
-xf86-video-fbdev-0.4.4-r5
-xf86-video-dummy-doc-0.3.8-r0
-xf86-video-rendition-doc-4.2.6-r1
-xf86-video-ati-7.9.0-r0
-xf86-video-rendition-4.2.6-r1
-xf86-video-i128-1.3.6-r8
-xf86-video-tdfx-doc-1.4.7-r0
-xf86-video-glint-doc-1.2.9-r0
-xf86-video-i740-doc-1.3.6-r0
-xf86-video-tdfx-1.4.7-r0
-xf86-video-chips-1.2.7-r0
-xf86-video-chips-doc-1.2.7-r0
-xf86-video-sis-0.10.9-r0
-xf86-video-qxl-0.1.5-r0
-xf86-video-intel-doc-2.99.917_git20170325-r0
-xf86-video-vesa-2.3.4-r2
-xf86-video-xgixp-1.8.1-r8
-xf86-video-glint-1.2.9-r0
-xf86-video-ast-doc-1.1.5-r1
-xf86-video-ark-doc-0.7.5-r7
-xf86-video-r128-6.10.2-r0
-xf86-video-xgixp-doc-1.8.1-r8
-xf86-video-sis-doc-0.10.9-r0
-xf86-video-nv-2.1.21-r0
-xf86-video-s3virge-doc-1.10.7-r1
-xf86-video-openchrome-0.6.0-r1
-xf86-video-ark-0.7.5-r7
-xf86-video-savage-2.3.9-r0
-xf86-video-i128-doc-1.3.6-r8
-apk add xf86-input-mouse xf86-input-keyboard
+=== Edit Openbox settings ===
-}}
+You can now edit the Openbox settings for your user by editing the files located in <code>~/.config/openbox</code>
+The Openbox configuration details can be studied on the [http://openbox.org/wiki/Help:Contents#Configuration Openbox wiki].
+== Start X ==
+{{Cmd|$ startx}}
+{{Note|The default Openbox menu (right-click on desktop) will have a lot of options that won't work because the required packages haven't been installed. XTerm will work if you added the package in the first step, and you can use that to add additional packages.}}
+== Troubleshooting ==
+== See also ==
+* [https://wiki.archlinux.org/title/Openbox Openbox - Archwiki]
+[[Category:Desktop]]
+[[category: Window Managers]]