To change the default application associated with a filetype you must use the xdg-mime command and point to the desired desktop file (if it doesn't exist, you must create one).

= Example =
In the following example we want to make mupdf the default command to open pdf files.
First you need to create a desktop file, because mupdf doesn't provide one.
{{cat|~/.local/share/applications/mupdf.desktop
<nowiki>

[Desktop Entry]
Type=Application
Terminal=false
Exec=/usr/bin/mupdf-gl
Name=mupdf
</nowiki>
}}

Then you must use xdg to associate the desktop file with the pdf extension.
{{Cmd|$ xdg-mime default mupdf.desktop application/pdf}}
That's all.

[[Category:Desktop]]
[[Category:Installation]]

Talk:AwesomeWM

2018-12-07T21:51:34Z

Astrawso:

* Shouldn't we assume that if a user is installing awesome then they've already performed the setup-alpine script? Is this redundant?
* Installing aterm (and the other packages) isn't necessarily a required component of a working awesome config, should this be removed as a personal preference, or perhaps put under a different heading?

--[[User:Astrawso|Astrawso]] ([[User talk:Astrawso|talk]]) 21:36, 7 December 2018 (UTC)

AwesomeWM

2018-12-07T21:46:49Z

Astrawso: /* Enable Community Repository */

= Initial setup =
Start by booting up Alpine (see [[Installation|these]] instructions on how to do that) 
When Alpine is up and running, do the initial setup.
{{Cmd|# setup-alpine}}

= Enable Community Repository =
In order to install the awesome package (see "Install packages" below), you need to enable the community repository for your version. Uncomment {{codeline|http://<url>/alpine/<version>/community}} in {{path|/etc/apk/repositories}}. For example:
{{cat|/etc/apk/repositories|<nowiki># /etc/apk/repositories

#/media/sdb/apks
http://mirror.csclub.uwaterloo.ca/alpine/v3.8/main
http://mirror.csclub.uwaterloo.ca/alpine/v3.8/community
#http://mirror.csclub.uwaterloo.ca/alpine/v3.8/testing
</nowiki>
}}

= Install packages =
Install awesome, feh, aterm as basic desktop system. 
This might take a few minutes depending on your network speed.
{{Cmd|# apk add awesome feh aterm}}
If aterm is not recognized by apk (Alpinelinux 3.2.x or above) instead of it you can install lxterminal. 
On the same version of Alpinelinux (3.2.x or above) you have to install the package lua otherwise awesome will not start
{{Cmd|# apk add lua}}
Add other apps on need, eg. firefox, gnumeric, xchat, gimp, pidgin, geany, vim, etc. 
For Alpinelinux 2.6.x add additional pkgs
{{Cmd|# apk add cairo-gobject pango}}

== Optional packages ==
=== Video and Input packages ===
You might also want to install a package suitable for your video chipset and input devices. 
For example, if you have an Sis video chipset install 'xf86-video-sis', for Intel video chipset install 'xf86-video-intel'. 
{{Cmd|# apk add xf86-video-sis}}
and / or
{{Cmd|# 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. 

=== acpid ===
If you installed your Alpine Linux as a VirtualBox or VMWare guest you might find it handy to be able send ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However you can still configure xorg-server by hand by launching:
{{Cmd|# setup-xorg-base}}

= Create user accounts =
Create a normal user account.
{{Cmd|# adduser <user>}}

Optionally, give that user sudo permissions in /etc/sudoers. When doing so, it is important to use the command: {{Cmd|# visudo}} This ensures that only one user is changing the file at any given time. Visudo has two modes: Command mode and Insert mode. To edit the file, use the arrows to navigate to the appropriate line and enter Insert mode by pressing the 'i' key. To save and exit, enter Command mode by pressing the 'Esc' key, then ':w' + 'enter' to save, and finally ':q' + 'enter' to quit.

Logout from root and login into new created account.

= Start your desktop =
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}}
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/awesome /home/<newuser>/.config}}
{{Cmd|$ vi /home/<newuser>/.config/awesome/rc.lua}}
Replace instances of xterm with aterm or (if 3.2.x or above use lxterminal instead)

Start awesome.
{{Cmd|$ startx}}

= Troubleshooting =

D-Bus problems:

{{Cmd|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 follow:

Install dbus from apk (you must be logged in as root, as for the step below)
{{Cmd|# apk add dbus}}

Login or su to root account then launch the follow command (Note: sudo is not working for this step):
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}

Now if startx is launched it should load correctly the desktop

= Screenshot =
[[{{ns:image}}:awesome-01.png|awesome-01.png]]
[[Category:Desktop]]