a simple, fun (?) and pre-configured OpenBSD.
isotop is a script to configure OpenBSD into a great
desktop. As much as possible, tools included in base installation are used.
Therefore, some choice have been made to focus on simplicity and efficiency.
In front of your eyes. The default window manager in isotop is
cwm(5) Its simplicity help to focus and be efficient.
Before installing another window manager or desktop environment,
give cwm a try. We tried to make is nice to use (see
How to use my desktop?
A link to pkg_mgr is in cwm menu.
Managemen https://www.openbsd.org/faq/faq15.html Package Management
You user must belong to wheel group to use cwm menu shortcuts.
Because we care about you eyes, sct(1) is started when you
open a session. Use dsch to change screen temperature color. You can also
disable this feature by removing sct line in
You can install dunst a nd add in
It is light, don't need huge dependencies. It is hackable, and even usable with
the mouse if you don't like keyboard. You cas of course install any other
music player you might prefer.
If you start cmus with cwm root menu, it is started in tmux(1)
, so it can be detached or opened in multiple terminals. To detach, press
"ctrl-b" then "d".
At first, isotop was a iso file containing all packages and configuration for
intallation. Now it’s just a script to configure a vanilla OpenBSD.
- unwind(8) is configured as default domain name
- A script called unwind-block is used to adblock some domains. It updates
the "bad domains" list weekly and is called with
~ /etc/rc.local See
What does unwind-block
- Customized message in /etc/boot.conf
- hotplugd(8) is configured to automount your USB strick
in /vol A link is available in your $HOME
- Enabled services : hotplugd, cups, xenodm, unwind.
- Disable ulpt for USB printers. This happens in rc.shutdown to enjoy KARL
at reboot. See
- ntpd configuration does'nt use google as a constraints
- Xenodm appearance is configured and configurable with a script called
- Additional packages are installed See
- doas is configured to avoid entering password for some commands. See
- cwm(5) is the default window manager. It is
pre-configured and shipped with various script to ease window management
for non-keyboard users.
- iridium is the default browser. Are disabled every option related to
google and tracking. It is unveiled by default : this means the browser
can’t read files on your computer except in ~/Downloads. It keeps
your ssh keys and passwords in configuration files safes. Firefox is also
making calls to google and can’t be unveiled for now (see
- Alt-L is mapped as Esc for vi users :)
- Translations are included : english and french for now.
- A few scripts and tools are included in
/usr/local/share/isotop/bin and available in your
PATH . See
What scripts are
- $HOME/.aliases and
$HOME/.functions are filled with some (useful ?)
- $HOME/.kshrc contains some autocompletion for OpenBSD.
- A random wallpaper is set a each session.
- The file browser is pcmanfm. It is configured to have custom actions
accessible with a right click (edit image, upload a file...).
Like an isotope it is a variant of OpenBSD with a few more things
inside, but still OpenBSD.
Of course. Firefox and chromium, amongst others, are available in ports.
However, we choosed iridium because it is unveiled, meaning it can’t
access your personal files that might contains password or ssh keys and it is
more privacy friendly than chromium.
Gnome, kde, lxde, xfce and more are availables for OpenBSD via
In order to save your bandwidth and filter ads without any browser addon, a
script called unwind-block is executed at boot (see
Every 7 days, the script download a list of bad domains and record
them in /var/unwind.block Thus, unwind can choose
not to resolve them. If you try to access one of these domains (why?),
you’ll get a message “website unavailable”
At first, the desktop is empty.
- Modify image (turn, resize...)
- Optimize image
- Upload image
- Set as wallpaper
- Play in cmus
- Print with default printer (image, text, pdf...)
Right-click on the background to see the application menu and
select, by example, xterm.
You can also press Alt-p to show
type “xterm” then press return.
Last, you can move the pointer to the bottom-left corner to pop
You can drag the window by pressing Alt and left-clicking on the window to move
To resize the window, press Alt and right-click.
You probably don't need to move and resize windows but to see
maximized instead, or hide it. All of this can be done with keystrokes
thanks to cwm(1) but you might not remember them all the
time. Right-click on the desktop or on a window border to see shortcuts
- Show desktop
- Show group assing menu
Then, click on the target window.
Keyboard and mouse bindings are cwm(1) defaults.
Some other are added :
- Alt-F4 : close window
- Alt-Shift-h/j/k/l : move window to the left/bottom/top/right of the
- Alt-s : start
- Alt-x : start
- Alt-t and Alt-Shift-t : tile windows
- Alt-p : shown dmenu to start application
- Alt-f : show window menu
- Alt-g : assing a new group to focused window
See cwmrc(5) to customize according your
You can popup menus by clicking on the desktop or on the border of a window
(quite big by default).
The window menu looks like this :
- Right click : Application menu. you can start an application or deal with
- Middle click : group menu : show active group to toggle visibility of
- Left click : window menu, to select a window.
- Scroll on the background to change volume.
- Alt + Right click : resize window
- Alt + Left click : drag window
(4) ! window name
(4)  other window name
(2) & another window name
(1) &[foo] again a window name
Between parenthesis, the group assigned to the window.
! means the window is focused.
& means the window is hidden.
[foo]: the window get the label foo with Ctrl-alt-n
There are no workspaces. They are just a way to increase the size of the screen,
and if you need a bigger screen, the window manager is probably wrong
somewhere. Instead, cwm uses groups . You can choose to show
one ore more grouped windows depending on your needs.
You can automatically assign a group to a window in
$HOME/.cwmrc or you can use the
dgroupwin to assing a group to a window.
At any time, a middle click on the desktop will shoiw the group
menu to toggle the visibility of active groups.
Tools included use dmenu.
It is a menu printed at the top of your screen. Write what you
need, on only part of it, then press return to select.
Esc: exit dmenu.
ctrl-y: paste selection