owl4ce / Dotfiles

Hi there! Thanks for visiting!

This is my personal configuration for my favorite openbox window manager and some applications too.

I hope you understand everything here. 😉

Here are some details about my setup

• Window Manager • Openbox 🎨 4 changable mode!
• Shell • Zsh 🐚 with oh my zsh framework! optional
• Terminal • URxvt, Termite available
• Openbox Menu • OBmenu-generator
• Panel • Tint2 🍧 material icon font!
• Compositor • Picom 🍩 rounded corners!
• Notify Daemon • Dunst 🍃 minimalism!
• Application Launcher • Rofi 🚀 blazing fast!
• File Manager • Thunar 🔖 customized sidebar & icon!
• Music Player • Mpd + Ncmpcpp, Spotify 🎑 riced!
• GUI & CLI IDE/Text Editor • Geany, Neovim

🎁 Changelogs

🌸 Setup

This is step-by-step how to install these .files for automatic setup OpenboxWM custom environment.

Introduction of Linux Rice

Installation (dependencies)

Customize your choice about dependencies below, this is my complete setup as I use single OS, single OpenboxWM with multimedia application that I use.

Detailed environment
Please refer to wiki/Detailed-Environment.

Warning! This configuration is highly dependent to bash, sed, awk, and coreutils.
Assume that you are using sudo or doas. Installation feels like LFS? 😆

$ sudo apt install rsync python psmisc x11-utils imagemagick ffmpeg wireless-tools gtk2-engines-murrine openbox \
alsa-utils brightnessctl nitrogen dunst tint2 gsimplecal rofi qt5-style-plugins lxpolkit xautolock rxvt-unicode \
xclip scrot thunar thunar-archive-plugin thunar-media-tags-plugin thunar-volman ffmpegthumbnailer tumbler \
viewnior mpv mpd mpc ncmpcpp pavucontrol parcellite neofetch w3m w3m-img htop playerctl xsettingsd

$ sudo apt install zsh &&
chsh -s $(command -v zsh) &&
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" &&
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting &&
git clone https://github.com/zsh-users/zsh-autosuggestions.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions &&
git clone https://github.com/zsh-users/zsh-completions.git ${ZSH_CUSTOM:=~/.oh-my-zsh/custom}/plugins/zsh-completions

$ sudo apt install meson libxext-dev libxcb1-dev libxcb-damage0-dev libxcb-xfixes0-dev libxcb-shape0-dev \
libxcb-render-util0-dev libxcb-render0-dev libxcb-randr0-dev libxcb-composite0-dev libxcb-image0-dev \
libxcb-present-dev libxcb-xinerama0-dev libxcb-glx0-dev libpixman-1-dev libdbus-1-dev libconfig-dev \
libgl1-mesa-dev libpcre2-dev libevdev-dev uthash-dev libev-dev libx11-xcb-dev

$ git clone https://github.com/yshui/picom.git &&
cd picom/ && git submodule update --init --recursive &&
meson --buildtype=release . build &&
ninja -C build &&
ninja -C build install

$ sudo su

echo 'deb http://download.opensuse.org/repositories/home:/Head_on_a_Stick:/obmenu-generator/Debian_10/ /' > /etc/apt/sources.list.d/home:Head_on_a_Stick:obmenu-generator.list &&
wget -nv https://download.opensuse.org/repositories/home:Head_on_a_Stick:obmenu-generator/Debian_10/Release.key -O Release.key &&
apt-key add - < Release.key &&
apt update &&
apt install obmenu-generator libgtk2-perl

$ yay -S rsync python psmisc xorg-xprop xorg-xwininfo imagemagick ffmpeg wireless_tools gtk-engine-murrine \
openbox alsa-utils brightnessctl nitrogen dunst tint2 gsimplecal rofi qt5-styleplugins lxsession xautolock \
rxvt-unicode-patched xclip scrot thunar thunar-archive-plugin thunar-media-tags-plugin thunar-volman \
ffmpegthumbnailer tumbler viewnior mpv mpd mpc ncmpcpp pavucontrol parcellite neofetch w3m htop \
picom-git obmenu-generator gtk2-perl playerctl xsettingsd

$ sudo pacman -S zsh &&
chsh -s $(command -v zsh) &&
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" &&
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting &&
git clone https://github.com/zsh-users/zsh-autosuggestions.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions &&
git clone https://github.com/zsh-users/zsh-completions.git ${ZSH_CUSTOM:=~/.oh-my-zsh/custom}/plugins/zsh-completions

Optional: betterdiscord, geany + geany plugins, gimp, lxappearance, nano + nano syntax highlighting, neovim, obconf, slim, spotify, termite, xfce4-power-manager.

Installation (dotfiles)

Are all directories required? 🤔
Please refer to wiki/Detailed-Environment.

$ git clone https://github.com/owl4ce/dotfiles.git && cd dotfiles/

$ rsync -avxHAXP --exclude '.git*' .* ~/

$ cd ~/.icons && tar -Jxvf Papirus-Custom.tar.xz && tar -Jxvf Papirus-Dark-Custom.tar.xz &&
sudo ln -s ~/.icons/Papirus-Custom /usr/share/icons/Papirus-Custom &&
sudo ln -s ~/.icons/Papirus-Dark-Custom /usr/share/icons/Papirus-Dark-Custom

$ fc-cache -rv

$ sudo chmod u+s $(command -v {poweroff,reboot,brightnessctl})

The step you are waiting for

The final step is login into openbox-session, basically login from display manager you use such as lightdm, gdm, etc.

I recommend to configuring what you want first, before logging into openbox-session.

If you are using ~/.xinitrc, simply add

Systemd Linux Distribution

exec openbox-session

Non-Systemd Linux Distribution

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

Suggested replacement commands

• ls ➜ exa

~/.zshrc

...

131 alias ls="exa -lgh --icons --group-directories-first"
132 alias la="exa -lgha --icons --group-directories-first"

...

• cat ➜ bat

Suggestion for tiling users

I recommend compiling it from source. Then put zentile binary your PATH, for example in ~/.local/bin/

$ # To run in the background (detached)
$ zentile &! 

$ # To kill (or pkill)
$ killall zentile

Update

Since I recommend using rsync from start, the easiest way is to list the files that will not be updated to avoid changing personal files with files in this repository. First, update local repository with git repository.

Remember where you cloned this repository.

$ cd dotfiles/ && git pull

Then list the files excluded by rsync. For example,
~/.rsxf

1 .git*
2 .lyrics
3 mpd.state
4 current-track
5 .zshrc
6 .nanorc
7 nvim
8 mpv
9 thunar.xml

...

and whatever the file is. Next, of course is rsync.

$ rsync -avxHAXP --exclude-from ~/.rsxf .* ~/

User's configuration

• SLiM Themes optional

  See

  In fact, I use SLiM just for lockscreen.

  

  Just click on the image above!

• Chromium-based Web Browser suggested

  See

  Settings: chrome://settings/

  • Themes: Use GTK+
  • Use system title bar and borders

  
  

  

• Spotify - Spicetify Theme suggested

  See

  
  

  

  

  Just click on the image above!

  Or maybe you want a direct link without downloading the complete repository

  Another useful tips: spotify-tray

• Capitaine Cursors Theme suggested

  See

  
  

  

  

  Just click on the image above!

• User's Preferences required
  ~/.owl4ce_var
  Manage all your settings there. I hope all comments there are easy to understand. ^^

• User's Tray Icons
  ~/.config/openbox/tray
  An example is turning on nm-applet, because by default I don't use it and use networkmanager_dmenu instead.

  How about battery indicator?
  Because on the tint2 panel I turned off battery status. Alternatively, install xfce4-power-manager and enable system tray icon in xfce4-power-manager-settings.

  Remove hashtags for all your needs, then re-login openbox-session.

  Warning! Putting a tray here means that when switching Visual Mode, the program will be restarted.

  1 #
  2 # This tray will restart after switching modes
  3 # Please add "&" after command
  4 #
  5 # ---
  6
  7 parcellite &
  8 #nm-applet &
  9 #xfce4-power-manager &
  

• Available Default Apps
  ~/.scripts/default-apps/list

  • Terminal: urxvt termite
  • Lockscreen: anything
  • Music Player: mpd spotify
  • File Manager: anything

  1 terminal="urxvt"
  2 lockscreen="slimlock"
  3 musicpl="mpd"
  4 filemanager="thunar"
  

• Neovim
  ~/.config/nvim/
  You know what to do with Vim-plug.

• MPD Music Directory
  ~/.mpd/mpd.conf

  ...
  
  6 music_directory     "~/Music"
  
  ...
  

• Ncmpcpp Music Directory
  Auto connect with MPD.

  How to use ncmpcpp albumart? (URxvt)
  It's easy, put album|cover|folder|artwork|front.jp?g|png|gif|bmp into folder with song album. Recommended image size is 500px ( 1:1 ) or more. See keybinds

• Audio Server optional
  ~/.config/openbox/autostart

  This is optional for Linux distributions that don't use systemd as their init, actually pulseaudio can be triggered from increasing-decreasing audio volume.

  • Pulseaudio

    ...
    
    9  # there was once a pulseaudio here
    10 pulseaudio --start --log-target=syslog &> /dev/null &
    
    ...
    

    Or if you use pipewire as pulseaudio.

  • Pipewire as Pulseaudio

    More details at ArchWiki / Gentoo Wiki.
    Make sure pulseaudio is uninstalled or disable autospawn.
    /etc/pulse/client.conf

    ...
    
    25  autospawn = no
    
    ...
    

    ...
    
    9  # there was once a pulseaudio here
    10 pipewire &> /dev/null &
    
    ...
    

• Neofetch Image
  ~/.config/neofetch/config.conf

  ...
  
  641 # Image Source
  642 #
  643 # Which image or ascii file to display.
  644 #
  645 # Default:  'auto'
  646 # Values:   'auto', 'ascii', 'wallpaper', '/path/to/img', '/path/to/ascii', '/path/to/dir/'
  647 #           'command output (neofetch --ascii "$(fortune | cowsay -W 30)")'
  648 # Flag:     --source
  649 #
  650 # NOTE: 'auto' will pick the best image source for whatever image backend is used.
  651 #       In ascii mode, distro ascii art will be used and in an image mode, your
  652 #       wallpaper will be used.
  653 #image_source="auto"
  654 #image_source="${HOME}/.config/neofetch/images/arch.png"
  655 #image_source="${HOME}/.config/neofetch/images/arch_dark.png"
  656 #image_source="${HOME}/.config/neofetch/images/artix.png"
  657 #image_source="${HOME}/.config/neofetch/images/bedrock.png"
  658 #image_source="${HOME}/.config/neofetch/images/gentoo.png"
  659 #image_source="${HOME}/.config/neofetch/images/gentoo_dark.png"
  660 #image_source="${HOME}/.config/neofetch/images/lofi.png"
  661 image_source="${HOME}/.config/neofetch/images/sakura.png"
  662 #image_source="${HOME}/.config/neofetch/images/ubuntu.png"
  663 #image_source="${HOME}/.config/neofetch/images/ubuntu_dark.png"
  664 #image_source="${HOME}/.config/neofetch/images/void.png"
  665 #image_source="${HOME}/.config/neofetch/images/void_dark.png"
  
  ...
  

  See Images

  Arch	Gentoo	Ubuntu	Void

  Arch Dark	Gentoo Dark	Ubuntu Dark	Void Dark

  Artix	LoFi	Bedrock

  Sakura

📝 Notes

Color Scheme

🎊 Credits / Thanks

• Inspiration and resources

  • Elena
  • Adhi Pambudi
  • Fikri Omar
  • Nanda Oktavera
  • Rizqi Nur Assyaufi
  • Muktazam Hasbi Ashidiqi
  • Galih Wisnuaji
  • Ghani Rafif
  • Aditya Shakya
  • ?

• Knowledge and other resources

  • Wiki @ Openbox
  • Pango Markup @ Gnome
  • Custom Environment @ ArchWiki
  • Pure Bash Bible
  • Stark's Color Scripts
  • Notify Send (bash)
  • NetworkManager Dmenu
  • URxvt Manual
  • URxvt Resize Font
  • URxvt Tabbed Extended
  • Showing Album Cover in Ncmpcpp
  • Complete List of GitHub Markdown Emoji Markup
  • Many GNU/Linux and Unix forums.

• Contributors

  • Ekaunt - Better promptmenu

  • HopeBaron - Termite config

  • Justin Faber - Rofi matched lines indicator

    
    

    Made with contributors-img.

• Softwares

  • Geany - The Flyweight IDE
  • GIMP - GNU Image Manipulation Program
  • Gpick - Advanced Color Picker
  • Themix - GUI Theme Designer
  • Tint2conf, etc.

• Our local linux community Linuxer Desktop Art and @dotfiles_id, also r/unixporn.

• © All artist who make icons, illustrations, and wallpapers.

  The original source that I found:

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