Openbox: Difference between revisions
Prabuanand (talk | contribs) (added heading Prerequisites) |
|||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
== | [https://openbox.org/ Openbox] is a minimalistic, highly configurable, next generation window manager with extensive standards support. | ||
== Prerequisites == | |||
{{:Include:Desktop prerequisites}} | |||
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]] | |||
== Installation == | |||
Install the basic packages for a minimal installation:{{Cmd|# apk add openbox xterm font-terminus}} | |||
Install the basic packages for a minimal installation: | |||
{{Cmd|# apk add openbox xterm font-terminus}} | |||
{{Pkg|xterm}} is needed so you have a way to access the terminal in X. There are alternatives but this is the classic. | {{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. | |||
= | === Configure user === | ||
== Configure user == | |||
To make Xorg work as normal user you need to add user to these groups: video, input. | To make Xorg work as normal user you need to add user to these groups: video, input. | ||
| Line 30: | Line 19: | ||
{{Cmd|# addgroup <username> video}} | {{Cmd|# addgroup <username> video}} | ||
== acpid == | === 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. | If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. | ||
| Line 36: | Line 25: | ||
{{Cmd|# rc-update add acpid}} | {{Cmd|# rc-update add acpid}} | ||
== Set Openbox as the default WM == | === Set Openbox as the default WM === | ||
{{Cmd|$ echo 'exec openbox-session' >> ~/.xinitrc}} | {{Cmd|$ echo 'exec openbox-session' >> ~/.xinitrc}} | ||
== Copy the config files to your home folder == | === Copy the config files to your home folder === | ||
{{Cmd|$ mkdir ~/.config}} | {{Cmd|$ mkdir ~/.config}} | ||
| Line 46: | Line 35: | ||
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}} | {{Cmd|$ 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 [http://openbox.org/wiki/Help:Configuration Openbox configuration documentation].}} | {{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}}}} | ||
== Edit Openbox settings == | === Edit Openbox settings === | ||
You can now edit the Openbox settings for your user by editing the files located in <code>~/.config/openbox</code> | You can now edit the Openbox settings for your user by editing the files located in <code>~/.config/openbox</code> | ||
| Line 59: | Line 48: | ||
{{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.}} | {{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:Desktop]] | ||
[[category: Window | [[category: Window Managers]] | ||
Latest revision as of 10:07, 17 March 2025
Openbox is a minimalistic, highly configurable, next generation window manager with extensive standards support.
Prerequisites
- Internet connectivity, unless the packages have been pre-fetched into a local cache.
- A non-root user account.
- The community repository must be enabled.
- Set up eudev.
- Install and configure D-Bus. without D-Bus icons and keyboard shortcuts may be missing.
- Install appropriate Graphics driver drivers for your hardware. Without graphics drivers, errors are likely to occur.
- Install Xorg
Installation
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.