AwesomeWM: Difference between revisions
m (→See also) |
Prabuanand (talk | contribs) (added xorg to Prerequisites) |
||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
[[file: awesome-01.png |thumb |Screenshot]] | [[file: awesome-01.png |thumb |Screenshot]] | ||
{{TOC right}} | {{TOC right}} | ||
[https://awesomewm.org/ Awesome] is a highly configurable, next generation framework window manager for X. It is primarily targeted at power users, developers and any people dealing with every day computing tasks and who want to have fine-grained control on their graphical environment. | |||
= Prerequisites = | == Prerequisites == | ||
{{:Include:Desktop prerequisites}} | |||
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]] | |||
* | |||
= | == Installation == | ||
Install awesome, xterm | |||
Install awesome, xterm and terminus font. {{Cmd|# apk add {{pkg|awesome|arch=}} {{pkg|xterm|arch=}} {{pkg|font-terminus|arch=}}}} | |||
{{Cmd|# apk add awesome xterm | |||
=== Video and Input packages === | === Video and Input packages === | ||
You <u>might</u> want to install a package suitable for your video chipset and input devices.<BR> | You <u>might</u> want to install a package suitable for your video chipset and input devices.<BR> | ||
For example | For example: | ||
{{Cmd|# apk add | {{Cmd|# apk add {{pkg|xf86-input-synaptics|arch=}}}} | ||
{{ | |||
= | Run {{ic|apk search {{pkg|xf86-video*|arch=}}}} to see available xf86-video packages.<BR> | ||
{{ | Run {{ic|apk search {{pkg|xf86-input*|arch=}}}} to see available xf86-input packages.<BR> | ||
===VMWare Users=== | === VMWare Users === | ||
{{Cmd|# apk add xf86-video-vmware}} | {{Cmd|# apk add {{pkg|xf86-video-vmware|arch=}}}} | ||
and/or | and/or | ||
{{Cmd|# apk add xf86-input-vmmouse}} | {{Cmd|# apk add {{pkg|xf86-input-vmmouse|arch=}}}} | ||
=== acpid === | === acpid === | ||
| Line 35: | Line 28: | ||
{{Cmd|# rc-update add acpid}} | {{Cmd|# rc-update add acpid}} | ||
= | == Start your desktop == | ||
= Start your desktop = | |||
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}} | {{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}} | ||
{{Cmd|$ mkdir /home/<newuser>/.config}} | {{Cmd|$ mkdir /home/<newuser>/.config}} | ||
| Line 48: | Line 37: | ||
{{Cmd|$ startx}} | {{Cmd|$ startx}} | ||
= Troubleshooting = | == Troubleshooting == | ||
D-Bus problems: | D-Bus problems: | ||
| Line 57: | Line 46: | ||
Install dbus from apk (you must be logged in as root for the step shown below) | Install dbus from apk (you must be logged in as root for the step shown below) | ||
{{Cmd|# apk add dbus}} | {{Cmd|# apk add {{pkg|dbus|arch=}}}} | ||
Log in or su to the root account, then launch the following command (Note: sudo does not work for this step): | Log in or su to the root account, then launch the following command (Note: sudo does not work for this step): | ||
| Line 64: | Line 53: | ||
Now if startx is launched, it should load the desktop correctly | Now if startx is launched, it should load the desktop correctly | ||
= See also = | == See also == | ||
* [[ | * [[Xorg]] | ||
* [ | * [https://awesomewm.org/doc/api/documentation/07-my-first-awesome.md.html Official Documentation] | ||
[[Category:Desktop]] | [[Category:Desktop]] | ||
[[Category:Window | [[Category:Window Managers]] | ||
Latest revision as of 10:46, 17 March 2025
Awesome is a highly configurable, next generation framework window manager for X. It is primarily targeted at power users, developers and any people dealing with every day computing tasks and who want to have fine-grained control on their graphical environment.
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 awesome, xterm and terminus font.
# apk add awesome xterm font-terminus
Video and Input packages
You might want to install a package suitable for your video chipset and input devices.
For example:
# apk add xf86-input-synaptics
Run apk search xf86-video* to see available xf86-video packages.
Run apk search xf86-input* to see available xf86-input packages.
VMWare Users
# apk add xf86-video-vmware
and/or
# apk add xf86-input-vmmouse
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
Start your desktop
$ echo 'awesome' >> /home/<newuser>/.xinitrc
$ mkdir /home/<newuser>/.config
$ cp -r /etc/xdg/awesome /home/<newuser>/.config
$ vi /home/<newuser>/.config/awesome/rc.lua
Start awesome.
$ startx
Troubleshooting
D-Bus problems:
D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open "/var/lib/dbus/machine-id": No such file or directory
If startx fails and returns an error about D-Bus failed to read machine uuid, as shown above, proceed as follows:
Install dbus from apk (you must be logged in as root for the step shown below)
# apk add dbus
Log in or su to the root account, then launch the following command (Note: sudo does not work for this step):
# dbus-uuidgen > /var/lib/dbus/machine-id
Now if startx is launched, it should load the desktop correctly