FreeBSD Desktop - Part 12 - Configuration - Openbox - JOYK Joy of Geek, Geek News, Link all geek

Time to cut the bullshit and actually make some real configuration. In today’s article of the FreeBSD Desktop series I will describe how to configure the Openbox window manager.

You may also check earlier articles of the FreeBSD Desktop series:

Features

Comparing to earlier articles in the series it will be HUGE, sorry for that. I could cut it into smaller parts but that would require editing of the Openbox configuration, its shortcuts and menus over and over again, so for the sake of simplicity its better to put it all at once. As it is as that big there will be mistakes, but I will fix them ASAP.

Here is the list of all features that will be available in this Openbox configuration.

Nice looking Openbox theme.
Openbox Menu (static) with nice looking icons.
Openbox Menu for FreeBSD top(1) / ps(1) commands and config files/logs.
Openbox Menu for FreeBSD default sound output.
Openbox Menu and shortcuts for FreeBSD sound volume increase/decrease.
Openbox Menu for FreeBSD for CPU frequency scaling.
Openbox Menu for FreeBSD network management with network.sh script.
Openbox Menu for screenshots/wallpapers management.
Openbox Menu for Recent files.
Random wallpaper handling.
Random xterm(1) theme at every terminal start with lost of great themes.
Openbox shortcuts and script for Aero Snap like behavior.
Openbox Dmenu shortcuts and integration.
Openbox configured with nice fonts.
Openbox shortcuts for most important tasks.
Warning for low battery on laptop.
I probably forgot about dozen other features – let me know in comments

Here is how the Openbox menus and window borders and window switching would look like.

Here are all the files with needed configuration.

Doas

To make most scripts work Your user ( vuk in the series) needs to be in the wheel , operator and network groups and doas(1) ( sudo(8) equivalent) needs to be installed and configured in the following way.

# <strong>pkg install doas</strong>

# <strong>pw groupmod wheel    -m vuk</strong>
# <strong>pw groupmod operator -m vuk</strong>
# <strong>pw groupmod network  -m vuk</strong>

# <strong>cat /usr/local/etc/doas.conf</strong>
permit nopass :wheel as root

permit nopass :network as root cmd ifconfig
permit nopass :network as root cmd dhclient
permit nopass :network as root cmd umount
permit nopass :network as root cmd wpa_supplicant
permit nopass :network as root cmd ppp
permit nopass :network as root cmd killall args -9 dhclient
permit nopass :network as root cmd killall args -9 wpa_supplicant
permit nopass :network as root cmd killall args -9 ppp
permit nopass :network as root cmd cat args /etc/ppp/ppp.conf
permit nopass :network as root cmd /etc/rc.d/netif args onerestart
permit nopass :network as root cmd tee args /etc/resolv.conf
permit nopass :network as root cmd tee args -a /etc/resolv.conf

Scripts

In this post I attach all scripts I have made and used for about 13 years since I started to use FreeBSD on the desktop. Download them all in the scripts.tar.gz file and unpack them into the ~/scripts to make it look like that.

% <strong>find scripts | sort</strong>
scripts/__openbox_cpufreq.sh
scripts/__openbox_current_wallpaper.sh
scripts/__openbox_delete_wallpaper.sh
scripts/__openbox_dmenu.sh
scripts/__openbox_edit_screenshot.sh
scripts/__openbox_edit_wallpaper_gimp.sh
scripts/__openbox_freebsd_sound.sh
scripts/__openbox_lock_zzz.sh
scripts/__openbox_lock.sh
scripts/__openbox_recent.sh
scripts/__openbox_reload_wallpaper.sh
scripts/__openbox_restart_conky.sh
scripts/__openbox_restart_dzen2.sh
scripts/__openbox_restart_plank.sh
scripts/__openbox_restart_tint2.sh
scripts/__openbox_show_screenshot.sh
scripts/__openbox_stats_ps_KILLALL.sh
scripts/__openbox_stats_top_cpu_KILL.sh
scripts/__openbox_stats_top_cpu_RENICE.sh
scripts/__openbox_stats_top_mem_KILL.sh
scripts/__openbox_stats_top_mem_RENICE.sh
scripts/aero-snap.sh
scripts/fc-cache.sh
scripts/firefox-clean.sh
scripts/network.sh
scripts/random_wallpaper.sh
scripts/shot.sh
scripts/xterm.sh
scripts/desktop-kill-shit.sh
scripts/desktop-battery-warning.sh

Make sure they remain executable.

% <strong>chmod +x ~/scripts/*</strong>

To make them work properly add ~/scripts into the ${PATH} variable at the beginning of the ~/.xinitrc file.

# PATH TO SCRIPTS
  export PATH=${PATH}:~/scripts

All of my scripts have this ‘mysterious’ line at the end. Its for statistics to check which scripts are run when (or it at all to which ones to delete).

<strong>echo '1' >> ~/scripts/stats/$( basename ${0} )</strong>

Thus it is needed to create the ‘stats’ directory.

% <strong>mkdir -p ~/scripts/stats</strong>

I have implemented that about two months ago and here are the results.

% <strong>wc -l ~/scripts/stats/* | sort -n</strong>
       1 /home/vermaden/scripts/stats/__openbox_show_screenshot.sh
       2 /home/vermaden/scripts/stats/__openbox_cpufreq.sh
       2 /home/vermaden/scripts/stats/__openbox_current_wallpaper.sh
       2 /home/vermaden/scripts/stats/__openbox_fullscreen.sh
       4 /home/vermaden/scripts/stats/__openbox_restart_dzen2.sh
       4 /home/vermaden/scripts/stats/dzen2-fifo.sh
       5 /home/vermaden/scripts/stats/__openbox_dmenu.sh
       5 /home/vermaden/scripts/stats/__openbox_restart_conky.sh
       5 /home/vermaden/scripts/stats/__openbox_restart_tint2.sh
       6 /home/vermaden/scripts/stats/__openbox_delete_wallpaper.sh
       7 /home/vermaden/scripts/stats/__openbox_freebsd_sound.sh
       8 /home/vermaden/scripts/stats/aero-snap.sh
      12 /home/vermaden/scripts/stats/__openbox_edit_screenshot.sh
      16 /home/vermaden/scripts/stats/__openbox_lock_zzz.sh
      16 /home/vermaden/scripts/stats/__openbox_lock.sh
      22 /home/vermaden/scripts/stats/shot.sh
      24 /home/vermaden/scripts/stats/network.sh
     214 /home/vermaden/scripts/stats/xterm.sh
     960 /home/vermaden/scripts/stats/random_wallpaper.sh
    2767 /home/vermaden/scripts/stats/desktop-battery-warning.sh
   13834 /home/vermaden/scripts/stats/desktop-kill-shit.sh
   17916 total

Of course I limited the output only to scripts that are available in this article, but be patient, more to come later

Dependencies

To make these scripts work and generally to make all this setup work we will need these dependencies.

arandr
gfontview
qtconfig
qt5ct
qtconfig-qt4
sakura
leafpad
geany
caja
thunar
libreoffice
galculator
pidgin
firefox
chrome
deadbeef
transmission-gtk
gnumeric
abiword
audacity
filezilla
midori
gimp
lupe
recorder
xvidcap
zenity
xterm
xrdb
scrot
feh
wmctrl
xdotool
viewnior
tint2
plank
dzen2
conky
mate-screensaver
xlockmore
gimp
dmenu
powerdxx
htop
galculator

To install them all with pkg(8) just type this line below.

# <strong>pkg install \
    geany caja thunar libreoffice galculator pidgin firefox chrome midori \
    abiword deadbeef transmission-gtk gnumeric  audacity filezilla zenity \
    gimp lupe recorder xvidcap  xterm xrdb scrot feh wmctrl xdotool tint2 \
    viewnior plank dzen2 conky mate-screensaver xlockmore powerdxx arandr \
    qt5ct gfontview galculator qtconfig qtconfig-qt4 sakura leafpad dmenu \
    htop </strong>

I also assume that wallpapers will be kept under ~/gfx/wallpapers dir and screenshots made under ~/gfx/screenshots directory, so lets create them now.

% <strong>mkdir -p ~/gfx/wallpapers</strong>
% <strong>mkdir -p ~/gfx/screenshots</strong>

Crontab

Some of these scripts needs to be put into crontab(1) to work, here are their entries.

% <strong>crontab -l</strong>
# DESKTOP
  *     *     * * * ~/scripts/desktop-kill-shit.sh                                       1> /dev/null 2> /dev/null
  */5   *     * * * ~/scripts/desktop-battery-warning.sh
  */20  *     * * * ~/scripts/random_wallpaper.sh ~/gfx/wallpapers                       1> /dev/null 2> /dev/null
  12,0  *     * * * /usr/bin/find ~/.cache -mtime +10 -delete                            1> /dev/null 2> /dev/null
  0     */3   * * * /usr/bin/find ~/.local/share/Trash/files -mtime +1 -delete  1> /dev/null 2> /dev/null

Fonts

I use Ubuntu Mono font for the Openbox menus and Fira Sans font for the Openbox window bar titles, thus you will download them in the fonts.tar.gz file and extract them like that into the ~/.fonts directory, if if does not exists, create it.

% <strong>find .fonts</strong>
.fonts/fira-sans-bold-italic.otf
.fonts/fira-sans-bold.otf
.fonts/fira-sans-italic.otf
.fonts/fira-sans-regular.otf
.fonts/ubuntu-mono-bold-italic.ttf
.fonts/ubuntu-mono-bold.ttf
.fonts/ubuntu-mono-italic.ttf
.fonts/ubuntu-mono-regular.ttf

To make sure that Openbox will ‘see’ them you can verify it using the fc-match(1) command like below.

% <strong>fc-match 'Fira Sans'</strong>
fira-sans-regular.otf: "Fira Sans" "Regular"

% <strong>fc-match 'Ubuntu Mono'</strong>
ubuntu-mono-regular.ttf: "Ubuntu Mono" "Regular"

Openbox

Openbox consists mostly of two files.

~/.config/openbox/menu.xml
~/.config/openbox/rc.xml

There are also these two, but its pointless to use them as we set our environment and start our apps/daemons in the ~/.xinitrc file (with ~/.xsession symlink to it), but anyway.

~/.config/openbox/autostart
~/.config/openbox/environment

The icons for the Openbox menu are kept under ~/.config/openbox/icons directory.

Download whole Openbox configuration in the openbox.tar.gz file and unpack it into the ~/.config/openbox to make it look like that.

% <strong>find .config/openbox -maxdepth 1</strong>
.config/openbox
.config/openbox/rc.xml
.config/openbox/menu.xml
.config/openbox/icons
.config/openbox/environment
.config/openbox/autostart

Openbox Theme

The theme we will use at start is the Openbox Flat made by myself, I do not remember if I put it online on the https://www.box-look.org/ site but that does not matter. Grab it in the openbox-flat-theme.tar.gz file and unpack it like that into the ~/.themes directory, create it if it does not exists.

% <strong>find .themes/openbox_flat</strong>
.themes/openbox_flat
.themes/openbox_flat/openbox-3
.themes/openbox_flat/openbox-3/iconify.xbm
.themes/openbox_flat/openbox-3/XPM
.themes/openbox_flat/openbox-3/XPM/over.xpm
.themes/openbox_flat/openbox-3/XPM/close.xpm
.themes/openbox_flat/openbox-3/XPM/max.xpm
.themes/openbox_flat/openbox-3/XPM/stick.0.xpm
.themes/openbox_flat/openbox-3/XPM/min.xpm
.themes/openbox_flat/openbox-3/XPM/shade.xpm
.themes/openbox_flat/openbox-3/XPM/stick.1.xpm
.themes/openbox_flat/openbox-3/max.xbm
.themes/openbox_flat/openbox-3/close.xbm
.themes/openbox_flat/openbox-3/bullet.xbm
.themes/openbox_flat/openbox-3/shade.xbm
.themes/openbox_flat/openbox-3/themerc
.themes/openbox_flat/openbox-3/desk.xbm
.themes/openbox_flat/openbox-3/desk_toggled.xbm

Openbox FreeBSD Submenus

The ‘ system ‘ Openbox submenu is for FreeBSD top(1) / ps(1) commands and config files/logs.

The ‘ sound ‘ Openbox submenu is for FreeBSD default sound output selection.

The ‘ recent ‘ Openbox submenu is for Recent files.

Check ‘ screenshot: ‘ and ‘ wallpaper: ‘ in the ‘ x11 ‘ Openbox submenu for screenshots/wallpapers management.

Check ‘ cpu: ‘ in the ‘ utilities ‘ Openbox submenu for FreeBSD for CPU frequency scaling.

Check ‘ NETWORK: ‘ in the ‘ daemons ‘ Openbox submenu for FreeBSD network management with network.sh script.

Shortcuts

Lets start with the most basic ones. [SUPER] is the so called Windows key.

Shortcuts – Virtual Desktops

[ALT] + [F1] – switch to 1st virtual desktop.
[ALT] + [F2] – switch to 2nd virtual desktop.
[ALT] + [F3] – switch to 3rd virtual desktop.
[ALT] + [F4] – switch to 4th virtual desktop.
[SHIFT] + [ALT] + [F1] – move current window to 1st virtual desktop.
[SHIFT] + [ALT] + [F2] – move current window to 2nd virtual desktop.
[SHIFT] + [ALT] + [F3] – move current window to 3rd virtual desktop.
[SHIFT] + [ALT] + [F4] – move current window to 4th virtual desktop.

Shortcuts – Menus

[SUPER] + [SPACE] – show Openbox root menu.
[SUPER] + [ALT] + [SPACE] – show Openbox window list menu.
[ALT] + [SPACE] – show current window options menu (client menu).

Shortcuts – Window Management

[ALT] + [TAB] – cycle windows focus forward.
[SHIFT] + [ALT] + [TAB] – cycle windows focus backward.
[CTRL] + [ALT] + [Q] – close current window.
[CTRL] + [ALT] + [F] – put current window info fullscreen.
[ALT] + [Up] – shade current window.
[ALT] + [Down] – minimize current window.
[ALT] + [ESC] – send current window below all other windows.

Shortcuts – Advanced Aero Snap

[SUPER] + [Up] – move window to half of the screen from top.
[SUPER] + [Down] – move window to half of the screen from bottom.
[SUPER] + [Left] – move window to half of the screen from left.
[SUPER] + [Right] – move window to half of the screen from right.
[SUPER] + [CTRL] + [Up] – move window to top-left part of the screen.
[SUPER] + [CTRL] + [Down] – move window to bottom-left part of the screen.
[SUPER] + [ALT] + [Up] – move window to top-right part of the screen.
[SUPER] + [ALT] + [Down] – move window to bottom-right part of the screen.
[SUPER] + [ESC] – move window to center – but without fullscreen.

Shortcuts – Various

[CTRL] + [SHIFT] + [ESC] – launch xterm(1) with htop(1) started with doas(1) for root provilages.
[SUPER] + [E] – start Explorer Caja primary file manager.
[SUPER] + [E] – start Thunar secondary file manager.
[SUPER] + [D] – show desktop – minimize all windows.
[SUPER] + [R] – launch dmenu(1) starter.
[SUPER] + [L] – lock the screen.
[ALT] + [SHIFT] + [SUPER] + [L] – lock the screen and go to sleep.
[CTRL] + [PrintScreen] – make screenshot of the whole screen.
[SHIFT] + [CTRL] + [PrintScreen] – make screenshot of current window (click without moving the mouse) or selection (select part of the screen).

Shortcuts – Volume

These two work from keyboard.

[SUPER] + [ALT] + [PageUp] – increase volume.
[SUPER] + [ALT] + [PageDown] – decrease volume.

These below with mouse.

For those who do not have mouse with buttons on the wheel like the Lenovo ThinkPad Precision Wireless Mouse (0B47163) for example, use [ALT] key with mouse scroll up/scroll down on the desktop to increase/decrease volume.

If you do have such mouse, then left on the wheel to decrease and right on the wheel to increase volume.

Random Wallpaper

The random wallpaper handling is done with the ~/scripts/random_wallpaper.sh script. Be sure to put some images into the ~/gfx/wallpapers directory to make it work and to configure crontab(1) properly as shown earlier.

Random xterm(1) Theme

To have random xterm(1) theme on every startup you need three things, the ~/.Xdefaults default config file which is used by xterm(1) , the ~/scripts/xterm.sh script and the ~/.config/Xdefaults directory with xterm(1) themes. I gathered all these themes all over the Internet, only the VERMADEN and VERMADEN-OLD themes are created by me.

To make xterm(1) icon look better you will also need icons.tar.gz file download and extract with the end result looking as follows.

% <strong>find .icons</strong>
.icons/vermaden/xterm.xpm

Download and extract the xterm.tar.gz file to make its contents look like that.

% <strong>find .Xdefaults .config/Xdefaults </strong>
.config/Xdefaults
.config/Xdefaults/Xdefaults.theme.3024NIGHT
.config/Xdefaults/Xdefaults.theme.ALIENBLOOD
.config/Xdefaults/Xdefaults.theme.ARTHUR
.config/Xdefaults/Xdefaults.theme.EARTHSONG
.config/Xdefaults/Xdefaults.theme.ELEMENTAL
.config/Xdefaults/Xdefaults.theme.ELEMENTARY
.config/Xdefaults/Xdefaults.theme.ELIC
.config/Xdefaults/Xdefaults.theme.FLATUI
.config/Xdefaults/Xdefaults.theme.FREYA
.config/Xdefaults/Xdefaults.theme.FRONTEND-DELIGHT
.config/Xdefaults/Xdefaults.theme.GITHUB
.config/Xdefaults/Xdefaults.theme.GREY
.config/Xdefaults/Xdefaults.theme.GRUVBOX-DARK
.config/Xdefaults/Xdefaults.theme.GRUVBOX-LIGHT
.config/Xdefaults/Xdefaults.theme.GRUVBOX-TILIX
.config/Xdefaults/Xdefaults.theme.HARPER
.config/Xdefaults/Xdefaults.theme.HEMISU-LIGHT
.config/Xdefaults/Xdefaults.theme.HIGHWAY
.config/Xdefaults/Xdefaults.theme.IC-GREEN-PPL
.config/Xdefaults/Xdefaults.theme.MOLOKAI
.config/Xdefaults/Xdefaults.theme.MONOKAI-SODA
.config/Xdefaults/Xdefaults.theme.N0TCH2K
.config/Xdefaults/Xdefaults.theme.NEOPOLITAN
.config/Xdefaults/Xdefaults.theme.PALI
.config/Xdefaults/Xdefaults.theme.PAPERCOLOUR
.config/Xdefaults/Xdefaults.theme.SOLARIZED
.config/Xdefaults/Xdefaults.theme.SOLARIZED-LIGHT
.config/Xdefaults/Xdefaults.theme.SPACEDUST
.config/Xdefaults/Xdefaults.theme.TOMORROW
.config/Xdefaults/Xdefaults.theme.TWILIGHT
.config/Xdefaults/Xdefaults.theme.VERMADEN
.config/Xdefaults/Xdefaults.theme.VERMADEN-OLD

Thats a lot of information for one article, feel free to ask me for anything related or about things that I might forgot to put here.

EOF.

FreeBSD Desktop - Part 12 - Configuration - Openbox

Features

Doas

Scripts

Dependencies

Crontab

Fonts

Openbox

Openbox Theme

Openbox FreeBSD Submenus

Shortcuts

Shortcuts – Virtual Desktops

Shortcuts – Menus

Shortcuts – Window Management

Shortcuts – Advanced Aero Snap

Shortcuts – Various

Shortcuts – Volume

Random Wallpaper

Random xterm(1) Theme

Recommend

算法太多挑花眼？此文教你如何选择正确的机器学习算法

DeepMind提出关系RNN：记忆模块RMC解决关系推理难题

用 Font Awesome 给 Markdown 文档加上生动的表情符号

nrss reader 0.3.9本地代码执行漏洞

不要再问我this的指向问题了

波场超级代表选举已经开始然而规则依然含糊不清

How fast is my model?

Interacting with AWS from R

[译文] 初学者应该了解的数据结构：Array、HashMap 与 List

亏损减半美团点评靠组合拳冲刺IPO

About Joyk