Openbox: Difference between revisions

From Alpine Linux
(Fixed formatting of the code being shown as a single block with no newlines separating it. Split the repository edit code from the rest. Attempted to add guiding comments before two of the code sets. Got an automated warning when submitting edit. :s)
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
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.
= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that)<BR>


You can manually add them to the '''/etc/apk/repositories''' file if you prefer.
= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Repositories#Enabling_the_community_repository|Repositories]] page.


The command '''apk update''' should be run after updating the file in either method.
= Install packages =
Install openbox, xterm, and terminus font.<BR>


{{cmd|cat > /etc/apk/repositories << EOF; $(echo)
{{Cmd|# apk add openbox xterm terminus-font}}
<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}}
xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
Terminus is needed because without any fonts, you will not be able to see any text in OpenBox.


These following commands should set up Xorg with Openbox and some necessary packages.
= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}


{{cmd|setup-xorg-base openbox terminator slim dbus-x11 xf86-video-intel
= Configure user =
xf86-video-ati xf86-video-amdgpu xf86-input-mouse xf86-input-keyboard setxkbmap
To make Xorg work as normal user you need to add user to these groups: video, input.
{{Cmd|# addgroup <username> input}}
{{Cmd|# addgroup <username> video}}


rc-update add dbus
== 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.<BR>
{{Cmd|# rc-update add acpid}}


rc-service dbus start
= Set openbox as the default WM =
{{Cmd|$ echo 'exec openbox-session' >> ~/.xinitrc}}


apk add fuse gvfs gvfs-mtp gvfs-lang gvfs-archive gvfs-fuse gvfs-gphoto2
= Copy the config files to your home folder =
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}


rc-update add fuse
'''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].


apk add faenza-icon-theme
= Edit openbox settings =
}}
You can now edit the openbox settings for your user by editing the files located in
{{Cmd|~/.config/openbox}}


This will install lot of packages as gtk, cairo, python, perl, and some xorg modules for device user interaction.
The OpenBox configuration details can be studied on the [http://openbox.org/wiki/Help:Contents#Configuration OpenBox wiki].


{{cmd|setup-xorg-base xf86-video-intel  xf86-video-ati xf86-video-amdgpu xf86-video-modesetting-0.9.0-r6
= Start your X! =
xf86-video-intel-2.99.917_git20170325-r0
{{Cmd|$ startx}}
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
'''Note:''' The default OpenBox menu (right click on desktop) will have a lot of options that won't work because we didnt install anything else! Luckily XTerm will work if you added the package in the first step, and you can use that to add additional packages.
}}
 
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].

Revision as of 06:56, 17 September 2022

Initial setup

Start by booting Alpine (see these instructions on how to do that)

Enable Community Repository

We need the Community Repository available for access to the OpenBox packages. Instructions are available on the Repositories page.

Install packages

Install openbox, xterm, and terminus font.

# apk add openbox xterm terminus-font

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

Configure xorg-server

On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:

# setup-xorg-base

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 /home/<newuser>/.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 your X!

$ startx

Note: The default OpenBox menu (right click on desktop) will have a lot of options that won't work because we didnt install anything else! Luckily XTerm will work if you added the package in the first step, and you can use that to add additional packages.

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.