JWM

jwm is a very lightweight window manager. It does a few things very well and leaves the rest to you. If you are tight on memory and CPU - this may work better for you. No dbus, hald, cups, or pulseaudio required but you can add these as needed for other packages.

The downside is some hand configuration is required. Knowing XML syntax helps.

You must complete all the prerequisites in the Prerequisites page before proceeding.

These instructions will install jwm.

Log in as ordinary and run the following commands which install jwm and modify the .xinitrc configuration file to automatically run jwm when X is started.

$ su -
(enter root password)
# pkg install xorg jwm xlockmore xfontsel
# pw groupmod video -m ordinary
# pw groupmod wheel -m ordinary
# pwd_mkdb -p /etc/master.passwd
(drop out of root)
# exit
$ echo 'exec jwm' >> ~/.xinitrc

Make a copy of the default menu file. You can find it under /usr/local/etc.

$ cp /usr/local/etc/system.jwmrc ~/.jwmrc

The example menu shipped with jwm assumes you have firefox, audacity, pidgin, and gimp installed. These menu selections won't do anything if the aforementioned apps aren't installed. Treat them as examples to be edited to suit your own needs.

You may want to instead use the example menu attached to this page.

Be careful when editing. It is XML so all the usual “well formed” XML formatting rules apply.

The menu provided here includes an option to edit the menu file in your favorite edit. After saving your changes, the “Restart” option re-loads the menu file to pick up your changes. Do keep a backup in case you make a mess.

$ startx

To see the menu, click the left mouse button.

< screenshot of menu >

As you customize your machine with more apps, you can hand edit the .jwmrc menu file to add menu selections to quickly run those apps.

The program entry lets you edit the .jwmrc menu file from your X session. This example uses 'vi'. You can instead use 'ee', 'micro', 'ape' or whatever editor you've installed from pkg or ports.

<Program icon="accessories-text-editor.png" label="Edit">xterm -e vi .jwmrc</Program>

Use Restart below to tell JWM to reload the menu.

This menu entry lets you restart JWM from within your X session. You don't need to completely exit X and jump back into X.

<Restart label=“Restart” icon=“view-refresh.png”/>

This menu entry exits JWM and your X session.

<Exit label=“Exit” confirm=“true” icon=“process-stop.png”/>

This program entry takes avantage of use xlockmore to lock your X session while you're away.

<Program icon="lockbutton.png" label="Lock">
    xlock -mode blank
</Program>

This menu group covers Apache Open Office. At this time of writing, 4.1.7 was the current version. After upgrading Office, you will need to edit the paths below to point to the new location under the new version.

You can adapt this to instead use Libre Office.

   <Menu icon="/usr/local/share/icons/Adwaita/16x16/categories/applications-office.png" label="Office" >
   	<Program label="OpenOffice 4.1.7 Math" icon="/usr/local/share/icons/gnome/16x16/apps/openoffice4-math.png" >openoffice-4.1.7 -math</Program>
   	<Program label="OpenOffice 4.1.7 Writer" icon="/usr/local/share/icons/gnome/16x16/apps/openoffice4-writer.png" >openoffice-4.1.7 -writer</Program>
   	<Program label="OpenOffice 4.1.7 Printer Administration" icon="/usr/local/share/icons/gnome/16x16/apps/openoffice4-printeradmin.png" >openoffice-4.1.7-printeradmin</Program>
   	<Program label="OpenOffice 4.1.7" icon="/usr/local/share/icons/gnome/16x16/apps/openoffice4-main.png" >openoffice-4.1.7</Program>
   	<Program label="Lumina PDF Viewer" >lumina-pdf</Program>
       <Program icon="notecase.png" label="Notecase Pro">notecase</Program>
   	<Program label="OpenOffice 4.1.7 Quickstarter"icon="/usr/local/share/icons/gnome/16x16/apps/openoffice4-startcenter.png" >openoffice-4.1.7 -quickstart -nologo -nodefault</Program>
   	<Program label="OpenOffice 4.1.7 Calc" icon="/usr/local/share/icons/gnome/16x16/apps/openoffice4-calc.png" >openoffice-4.1.7 -calc</Program>
   	<Program label="OpenOffice 4.1.7 Draw" icon="/usr/local/share/icons/gnome/16x16/apps/openoffice4-draw.png" >openoffice-4.1.7 -draw</Program>
   	<Program label="OpenOffice 4.1.7 Impress" icon="/usr/local/share/icons/gnome/16x16/apps/openoffice4-impress.png" >openoffice-4.1.7 -impress</Program>
   	<Program label="OpenOffice 4.1.7 Base" icon="/usr/local/share/icons/gnome/16x16/apps/openoffice4-base.png" >openoffice-4.1.7 -base</Program>
</Menu>

Configuration bits to get icons to appear in the menu.

<IconPath>/home/ordinary/.icons</IconPath>

Probably the next thing you will want to do is install a browser. There are so many. Pick the one you know best. You can install these from an xterm window in your X windows session. You don't need to exit your X session.

$ su -
(enter the root password)
# pkg install firefox
# pkg install chromium
# pkg install iridium
# pkg install midori

You may want to look at installing and configuring 'doas' or 'sudo' in place of 'su' for these types of chores.

Oh but wait! Technically you have a working X environment but there's no acceleration. Let's fix that now. Exit your X-session (left mouse click anywhere on the desktop and select “Exit”) and then skip ahead to Acceleration.