DTOS

DTOS is the name that I have chosen for my post-installation script that will deploy my Xmonad config, my Emacs config, as well as associated programs that are needed to create a proper “desktop” experience. DTOS should work on Arch Linux or any Arch-based distribution. The programs that will be installed include Xmonad, Xmobar, Doom Emacs, Fish and other programs needed to recreate DT’s XMonad desktop.

The source code for DTOS can be found in the following GitLab repos:

• dtos - The DTOS installation script
• dtos-core-repo - The DTOS core repository of software. Binaries are built from the PKGBUILDs in dtos-pkgbuild.
• dtos-pkgbuild - The PKGBUILDs used to create the binary packages in dtos-core-repo.
• etc - Contains most of the dtos-* packages, which are config files that get placed in /etc/dtos.

Most of the custom packages for DTOS are really just config files for various programs. For example, the dtos-xmonad package is really just the custom XMonad config files for DTOS. The dtos-bash package is just the default .bashrc file for DTOS. All of the various dtos-* packages install their config files to a special directory: /etc/dtos. They are not placed in $HOME automatically because we don’t want to overwrite any existing configs. So it is up to you to copy any new configs in /etc/dtos over to your $HOME if you want them. The /etc/dtos directory is structured exactly like a user’s $HOME directory. So if you installed dtos-xmonad and dtos-bash, then you would find their config files in the following locations:

/etc/dtos/.xmonad
/etc/dtos/.bashrc

When you run the DTOS installation script, it installs all of the dtos-* packages, which place their config files into /etc/dtos, and then the installation script copies the entire /etc/dtos directory into the user’s HOME directory. The installation will create a backup copy of some critical files and directories (such as .config) in case the user accidentally overwrites some important files.

Simply update your system as you would any Arch-based system:

sudo pacman -Syu

Remember, the dtos-* packages are just config files that are placed into /etc/dtos. So if installing or updating those packages, if you want to use them, you will have to copy the appropriate files from /etc/dtos into your $HOME directory. Be careful not overwrite any of your own custom config files!

To set a wallpaper, launch dm-setbg (part of dmscripts) with the keybinding ’SUPER+p b’. This will launch the image viewer sxiv which will display the wallpapers in /usr/share/backgrounds/dtos-backgrounds. Navigate to the wallpaper you want to set and hit ’m’ to mark it. Then close sxiv and the marked wallpaper will be set.

The following tables of keybindings are just a few of the most useful ones to know to get started. To list all possible keybindings (especially in Doom Emacs) would be an enormous undertaking, and I doubt anyone would find such a massive document useful, so I have tried to keep these keybindings lists to a user-friendly size.