• Functionality
  • Live reloader for rxvt-unicode color scheme
• Git repository
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • README.md
  • REPOLOGY.md
  • SECURITY.md
• User interface
  • Rofi main menu and panel (or control) extensions menu
  • Rofi action menu for openbox button and X wallpaper selectors, as well as dunst context-menu
  • Better tint2 horizontal panels for Artistic Mode and the tooltips

• GTK theme and icon updates and fixes
  • Papirus-Custom and Papirus-Dark-Custom patches
    • 16x16
      • apps
        • diodon.svg
      • devices
        • drive-harddisk.svg
        • drive-removable-media-usb.svg
        • phone.svg
      • places
        • folder.svg
        • folder-documents.svg 🡲 folder.svg
        • folder-download.svg 🡲 folder.svg
        • folder-music.svg 🡲 folder.svg
        • folder-network.svg
        • folder-pictures.svg 🡲 folder.svg
        • folder-video.svg 🡲 folder.svg
    • 48x48
      • status
        • battery-ac-adapter.svg
        • battery-caution-charging.svg
        • battery-caution.svg
        • battery-empty-charging.svg
        • battery-empty.svg
        • battery-full-charged.svg
        • battery-full-charging.svg
        • battery-full.svg
        • battery-good-charging.svg
        • battery-good.svg
        • battery-low-charging.svg
        • battery-low.svg
        • battery-missing.svg
        • bluetooth-active.svg
        • bluetooth-disabled.svg
        • bluetooth.svg
        • dialog-error.svg
        • dialog-information.svg
        • dialog-question.svg
        • dialog-warning.svg
        • network-error.svg
        • network-offline.svg
        • network-wired-disconnected.svg
        • network-wireless-encrypted.svg
        • nm-signal-100.svg
        • nm-signal-25.svg
        • nm-signal-50.svg
        • nm-signal-75.svg
        • notification-audio-volume-high.svg
        • notification-audio-volume-low.svg
        • notification-audio-volume-medium.svg
        • notification-audio-volume-muted.svg
        • notification-battery-low.svg
        • notification-device-eject.svg
        • notification-display-brightness-full.svg
        • notification-display-brightness-high.svg
        • notification-display-brightness-low.svg
        • notification-display-brightness-medium.svg
        • notification-display-brightness-off.svg
        • notification-network-ethernet-connected.svg
        • notification-network-wireless-disconnected.svg
        • notification-network-wireless.svg
• Reconfigure program configurations
• Restructure git directory layouts
• Rewrite shell-scripts completely
  • Use POSIX-compliant sh for portability
  • Harden algorithm as possible for safety
  • Use built-in shell features for high-performance
  • Optimize algorithm to reduce overheads
  • Bug fixes across ecosystem environments

• Mostly deprecated configs and BLOBs such as images

Debian SID or Devuan (ceres?) recommended.

Didn't know how to install packages?

💲 sudo apt install atom1 atom2 ... atomN

X.Org server and {it's,core} utilities. This is essentials.

xserver-xorg-core x11-xserver-utils psmisc

Contents of 1, 2, 3.

Here for python (3) if not already installed.

Now, the UI kits and functionality. This is required.

URxvt is highly recommended terminal emulator by default. Picom is optional, but recommended.

dunst nitrogen openbox rofi rxvt-unicode tint2 picom libgtk3-perl #obmenu-generator

Contents of 1, 2, 3, 4, 5, 6, 7, 8.

Here to install obmenu-generator.

Audio-server and audio stuff.

I personally use pulseaudio, mpd and ncmpcpp are recommended as they are integrated by default.

pulseaudio mpd mpc ncmpcpp

Contents of 1, 2, 3, 4.

MPRIS-enabled media players are also integrated, such as spotify.

Extended utilities. Required, but just as necessary.

All of the below if not installed, certain functionality will display a message when needed, some will not.

alsa-utils brightnessctl imagemagick scrot w3m-img wireless-tools xclip xsettingsd xss-lock

Contents of 1, 2, 3, 4, 5, 6, 7, 8, 9.

Choose your own polkit authentication-agent. lxpolkit?

Additionals for completion of desktop compositions.

Just like mpd and ncmpcpp, configurations are included as EXTRA_JOYFUL, some are integrated.

thunar thunar-archive-plugin thunar-volman ffmpegthumbnailer tumbler

Contents of 1, 2, 3, 4, 5.

Gsimplecal was used to display calendar pop-ups from the tint2 panel, and pavucontrol to control pulseaudio-sinks.

geany geany-plugins gimp gsimplecal inkscape mpv parcellite pavucontrol viewnior xfce4-power-manager

Contents of 1, 2, 3, 4, 5, 6, 7, 8, 9, 10.

I personally don't use neofetch anymore and use system-information via rofi, it's already scripted.

htop nano #neofetch

Contents of 1, 2, 3.

Here for improved nanorc with syntax-highlighting.

I personally use NetworkManager (and IWD as wireless back-end) with nm-applet, here it is.

Arch Linux and Artix Linux recommended.

Didn't know how to install packages?

💲 sudo pacman -S atom1 atom2 ... atomN

X.Org server and {it's,core} utilities. This is essentials.

xorg-server xorg-xrandr xorg-xrdb psmisc

Contents of 1, 2, 3, 4.

Here for python (3) if not already installed.

Now, the UI kits and functionality. This is required.

URxvt is highly recommended terminal emulator by default. Picom is optional, but recommended.

AUR
rxvt-unicode-truecolor-wide-glyphs
obmenu-generator

dunst nitrogen openbox rofi rxvt-unicode-truecolor-wide-glyphs tint2 picom obmenu-generator perl-gtk3

Contents of 1, 2, 3, 4, 5, 6, 7, 8, 9.

Audio-server and audio stuff.

I personally use pulseaudio, mpd and ncmpcpp are recommended as they are integrated by default.

pulseaudio pulseaudio-alsa mpd mpc ncmpcpp

Contents of 1, 2, 3, 4, 5.

MPRIS-enabled media players are also integrated, such as spotify.

Extended utilities. Required, but just as necessary.

All of the below if not installed, certain functionality will display a message when needed, some will not.

alsa-utils brightnessctl imagemagick scrot w3m wireless_tools xclip xsettingsd xss-lock

Contents of 1, 2, 3, 4, 5, 6, 7, 8, 9.

Choose your own polkit authentication-agent. polkit-gnome?

Additionals for completion of desktop compositions.

Just like mpd and ncmpcpp, configurations are included as EXTRA_JOYFUL, some are integrated.

thunar thunar-archive-plugin thunar-volman ffmpegthumbnailer tumbler

Contents of 1, 2, 3, 4, 5.

Gsimplecal was used to display calendar pop-ups from the tint2 panel, and pavucontrol to control pulseaudio-sinks.

geany geany-plugins gimp gsimplecal inkscape mpv parcellite pavucontrol viewnior xfce4-power-manager

Contents of 1, 2, 3, 4, 5, 6, 7, 8, 9, 10.

I personally don't use neofetch anymore and use system-information via rofi, it's already scripted.

htop nano #neofetch

Contents of 1, 2, 3.

Here for improved nanorc with syntax-highlighting.

I personally use NetworkManager (and IWD as wireless back-end) with nm-applet, here it is.

Gentoo Linux extremely recommended. Expert!

Didn't know how to install packages?

💲 doas emerge -av atom1 atom2 ... atomN

Note that some packages require accepting arch~ keywords. It's highly recommended.

See also USE flags, it's complicated to explain. You may want to see mine.

X.Org server and it's utilities. This is essentials.

x11-base/xorg-server x11-apps/xrandr

Contents of 1, 2.

Now, the UI kits and functionality. This is required.

URxvt is highly recommended terminal emulator by default. Picom is optional, but recommended.

My own Lilium portage overlay contains enhancements.
x11-terms/rxvt-unicode::lilium

For pixel-perfect, subtract 1px in ~/.Xresources and ~/.joyfuld.

x11-misc/dunst x11-misc/nitrogen x11-wm/openbox x11-misc/rofi x11-terms/rxvt-unicode::lilium x11-misc/tint2 \=x11-misc/picom-9999 x11-misc/obmenu-generator dev-perl/Gtk3

Contents of 1, 2, 3, 4, 5, 6, 7, 8, 9.

Audio-server and audio stuff.

I personally use pulseaudio, mpd and ncmpcpp are recommended as they are integrated by default.

media-sound/pulseaudio media-sound/mpd media-sound/mpc media-sound/ncmpcpp

Contents of 1, 2, 3, 4.

MPRIS-enabled media players are also integrated, such as spotify.

Extended utilities. Required, but just as necessary.

All of the below if not installed, certain functionality will display a message when needed, some will not.

I personally don't use GURU portage overlay and build manually instead.
app-misc/brightnessctl::guru

app-misc/brightnessctl::guru media-gfx/imagemagick media-gfx/scrot www-client/w3m net-wireless/wireless-tools x11-misc/xclip x11-misc/xsettingsd x11-misc/xss-lock

Contents of 1, 2, 3, 4, 5, 6, 7, 8.

Choose your own polkit authentication-agent. polkit-gnome?

Additionals for completion of desktop compositions.

Just like mpd and ncmpcpp, configurations are included as EXTRA_JOYFUL, some are integrated.

xfce-base/thunar xfce-extra/thunar-archive-plugin xfce-extra/thunar-volman media-video/ffmpegthumbnailer xfce-extra/tumbler

Contents of 1, 2, 3, 4, 5.

Gsimplecal was used to display calendar pop-ups from the tint2 panel, and pavucontrol to control pulseaudio-sinks.

I personally don't use Miramir's portage overlay and build manually instead.
x11-misc/gsimplecal::miramir

dev-util/geany dev-util/geany-plugins media-gfx/gimp x11-misc/gsimplecal::miramir media-gfx/inkscape media-video/mpv x11-misc/parcellite media-sound/pavucontrol media-gfx/viewnior xfce-extra/xfce4-power-manager

Contents of 1, 2, 3, 4, 5, 6, 7, 8, 9, 10.

I personally don't use neofetch anymore and use system-information via rofi, it's already scripted.

sys-process/htop #app-misc/neofetch

Contents of 1, 2.

Here for improved nanorc with syntax-highlighting.

I personally use NetworkManager (and IWD as wireless back-end) with nm-applet, here it is.

Need contributors to encapsulate dependencies.

The Linux philosophy is ‘Laugh in the face of danger’.
Oops. Wrong One. ‘Do it yourself’.

- Linus Torvalds

The BSD variants haven't been tested at all, probably some of the extensions are GNU's and Linux-specific.

Ensure you have installed zsh with system package manager as per distribution.

💲 sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

💲 sudo chsh -s $(command -v zsh)

💲 git clone --depth 1 https://github.com/zdharma-continuum/fast-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/fast-syntax-highlighting

💲 git clone --depth 1 https://github.com/zsh-users/zsh-autosuggestions.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

💲 git clone --depth 1 https://github.com/zsh-users/zsh-completions.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-completions

Wget all the above fonts (and extract if archived). Then, put them as instructed into the ~/.fonts directory.

💲 mkdir -pv ~/.fonts/{Cantarell,Comfortaa,IcoMoon-Custom,Nerd-Patched,Unifont}

💲 wget --no-hsts -cNP ~/.fonts/Comfortaa/ https://raw.githubusercontent.com/googlefonts/comfortaa/main/fonts/OTF/Comfortaa-{Bold,Regular}.otf

💲 wget --no-hsts -cNP ~/.fonts/IcoMoon-Custom/ https://github.com/owl4ce/dotfiles/releases/download/ng/{Feather,Material}.ttf

💲 wget --no-hsts -cNP ~/.fonts/Nerd-Patched/ https://github.com/owl4ce/dotfiles/releases/download/ng/M+.1mn.Nerd.Font.Complete.ttf

💲 wget --no-hsts -cNP ~/.fonts/Nerd-Patched/ https://github.com/owl4ce/dotfiles/releases/download/ng/{M+.1mn,Iosevka}.Nerd.Font.Complete.Mono.ttf

💲 wget --no-hsts -cNP ~/.fonts/Unifont/ https://unifoundry.com/pub/unifont/unifont-14.0.02/font-builds/unifont-14.0.02.ttf

💲 wget --no-hsts -cN https://download-fallback.gnome.org/sources/cantarell-fonts/0.303/cantarell-fonts-0.303.1.tar.xz

💲 tar -xvf cantarell*.tar.xz --strip-components 2 --wildcards -C ~/.fonts/Cantarell/ \*/\*/Cantarell-VF.otf

Additionally, install the noto (emoji takes precedence) fonts for broad support. Debian. Arch. Gentoo.

Wget all the above icons (and extract if archived). Then, put them into the ~/.icons directory.

💲 mkdir -pv ~/.icons

💲 wget --no-hsts -cN https://github.com/owl4ce/dotfiles/releases/download/ng/{Gladient_JfD,Papirus{,-Dark}-Custom}.tar.xz

💲 tar -xf Gladient_JfD.tar.xz -C ~/.icons/

💲 tar -xf Papirus-Custom.tar.xz -C ~/.icons/

💲 tar -xf Papirus-Dark-Custom.tar.xz -C ~/.icons/

💲 sudo ln -vs ~/.icons/Papirus-Custom /usr/share/icons/

💲 sudo ln -vs ~/.icons/Papirus-Dark-Custom /usr/share/icons/

Why do I need to link icons to /usr?
It's required by dunst program to display the notification icon sent by the program.

DISCLAIMER!!!
I don't own the artworks (because I couldn't find the link to the originals), so if you the owner of the artworks with proof and want me to remove it please let me know.

• 桜セイバー沖田総司
• 桜
• 沖田総司

Wget all the above wallpapers and put them as instructed into the ~/.wallpapers directory.

💲 mkdir -pv ~/.wallpapers/{mechanical,eyecandy}

💲 wget --no-hsts -cNP ~/.wallpapers/mechanical/ https://github.com/owl4ce/dotfiles/releases/download/ng/{batik-1_4K,okita-souji_FHD}.jpg

💲 wget --no-hsts -cNP ~/.wallpapers/eyecandy/ https://github.com/owl4ce/dotfiles/releases/download/ng/{cherry-blossoms,floral-artistic-2}_FHD.jpg

Old wallpapers can be found here.

cURL all the above perl-scripts and put them into the ~/.urxvt/ext directory.

💲 mkdir -pv ~/.urxvt/ext

💲 (cd ~/.urxvt/ext/; curl -LO https://raw.githubusercontent.com/simmel/urxvt-resize-font/master/resize-font)

💲 (cd ~/.urxvt/ext/; curl -LO https://raw.githubusercontent.com/mina86/urxvt-tabbedex/master/tabbedex)

You can clone or download as archive. Then, put all the .files in the dotfiles directory into the user's home directory. Assume you clone it in the ~/Documents directory. I recommend to synchronize with rsync program.

💲 cd ~/Documents/

This repository auto-mirrored to https://gitlab.com/owl4ce/dotfiles.git.

💲 git clone --depth 1 --recurse-submodules https://github.com/owl4ce/dotfiles.git

💲 rsync -avxHAXP --exclude-from=- dotfiles/. ~/ << "EXCLUDE"
.git*
LICENSE
*.md
EXTRA_JOYFUL
EXCLUDE

Ensure the rsync command must be correct as above. The following is for completion of desktop compositions.

💲 rsync -avxHAXP --exclude-from=- dotfiles/EXTRA_JOYFUL/. ~/ << "EXCLUDE"
.git*
neofetch
EXCLUDE

• cp is for duplicating stuff and by default only ensures files have unique full pathnames.
• rsync is for synchronizing stuff and uses size and timestamp of files to decide if they should be replaced.

Options	Description
-a, --archive	archive mode; equals -rlptgoD (no -H,-A,-X)
-v, --verbose	increase verbosity
-x, --one-file-system	don't cross filesystem boundaries
-H, --hard-links	preserve hard links
-A, --acls	preserve ACLs (implies --perms)
-X, --xattrs	preserve extended attributes
-P	show progress during transfer
--exclude-from=-	read exclude patterns from FILE (stdin)

I recommend not deleting the dotfiles directory after cloning to make upgrading easier.

This ensures all existing caches are cleaned and regenerated for all installed fonts.

💲 fc-cache -rv

The final step is to login to the openbox-session, basically login from your display manager such as lightdm, gdm, etc. If you're using ~/.xinitrc without a display manager, simply add the following one-liner command at the end.

Systemd-based Linux distributions

exec openbox-session

Init-freedom Linux distributions

exec dbus-launch --exit-with-x11 openbox-session

Then you can proceed to guides. Explore!

Since I recommend using rsync from the beginning, the easiest way is to list the files (via shell heredocs) that won't be updated to avoid replacing personal files with .files. First, update the local repository with the remote git repository.

Remember where you cloned the repository. We assumed that it was in the ~/Documents directory.

💲 cd ~/Documents/

💲 (cd dotfiles/; git pull --depth 1 --recurse-submodules --rebase)

💲 rsync -avxHAXP --exclude-from=- dotfiles/. ~/ << "EXCLUDE"
.git*
LICENSE
*.md
*.joy
settings.ini
mpd.state
autostart.sh
environment
tray
eyecandy.rasi
mechanical.rasi
shared.rasi
EXTRA_JOYFUL
.gtkrc-2.0
.joyfuld
.Xresources
EXCLUDE

Use the find program to check the pattern. It's called globbing.

💲 find dotfiles/ -iname 'PATTERN'

~/.joyfuld

Manage all your settings there. I hope all the comments there are easy to understand. ^^

/etc/X11/xorg.conf.d/30-touchpad.conf

Section "InputClass"
    Identifier "touchpad"
    Driver "libinput"
    MatchIsTouchpad "on"
    Option "Tapping" "on"
    Option "TappingButtonMap" "lmr"
EndSection

~/.config/openbox/autostart.sh

The unix-shell syntax, POSIX-compliant is highly recommended. Don't change the default, possibly broken.

~/.config/openbox/tray

Single program (and if any, with arguments) for each line. It will be restarted after switching modes.

~/.config/openbox/environment

Use export to set user's environment variables universally. Don't add any other syntax.

~/.scripts/db.apps.joy

Terminal emulator and file manager are used universally, both for keybindings and context menus. The terminal emulator is actually freedom-of-choice, but it's not integrated, it displays a notification message. The music player can be switched without modifying the configuration manually, via music control button on tint2 panel, just hover it. The session locker was used by xss-lock program (which enabled in autostart), triggered by systemd events and DPMS.

Update the mpd database first, via mpc or by pressing U in ncmpcpp.

💲 mpc -p 7777 update

Put an image file that matches BRE (album|cover|folder|artwork|front).*[.](jpe?g|png|gif|bmp) into the directory containing album tracks. The directory is in the ~/Music by default. The recommended image size is 500px at ratio of 1:1 or more. So, assume you have ~/Music/YOUR_ALBUM directory with lots of tracks, you should put the image file to use as album-art (related to tracks) there. This is for URxvt only.

Also, I use ALSA driver in the MPD to get bit-perfect playback. It's disabled by default, you need to switch it.

If you just installed thunar without XFCE, you may get side-pane without XDG directories such as Documents, Downloads, etc. After you created those directories, open thunar and select or block those directories. Then right click and click Send To 🡲 Side Pane. It's basically plain configuration file. The following command generates those directories.

💲 xdg-user-dirs-update

If you want to get 100% thunar looks similar to my screenshot, ensure to copy my thunar configuration (before opening for the first time). Then hide Computer, Desktop, Recent, or whatever you want by right clicking Places on thunar side-pane. By default, my thunar side-pane configuration uses simple 16px icons. Suggested by Papirus Development Team.

LEGEND
super

SHELL
Most shells use the readline(3) library. In addition, provided by shell plugins.

💲 man 3 readline | less +/EDITING\ COMMANDS