My GNU/Linux dotfiles

🐧 This is a collection of dotfiles for use with BSPWM or any other window manager that requires the use of a dzen panel.
🐧 It is my personal configuration and includes all of the features I find necessary for a full WM experience.
🐧 My .vim folder is here and My GNU/Linux cheat-sheet is here.

Table of Contents

• Screenshots
• Requirements
  • General
  • Panel
  • Other useful programs
• Installation
  • General
    • Suspend Service
    • GTK Themes
    • Font
  • Configuration
    • Panel
    • Keybinds
    • Touchpad Synaptics
    • Background
    • Auto Suspend
    • xinitrc
    • Fontconfig Configuration
• Kernel Configuration
• Document
• Credits

---

Screenshots

Version 5: 2017-08-27

Version 4: 2017-04-22

Version 3: 2016-01-11

Version 2: 2014-12-26

Version 1: 2014-09-07

They say life is a journey, not a destination. Well, so are dotfiles...

Requirements

Here is the list of relevant packages/programs that I use. You don't need to install everything below, just choose what you want and then select which dotfiles to be symlinked in the config file.

General

• bspwm (window manager)
• sxhkd (hotkey daemon)
• rxvt-unicode (terminal emulator)
• dunst (notification daemon)
• feh (background setter)
• neovim (text editor)
• zsh (shell)
• tmux (terminal multiplexer)

Panel

• dzen or dzen2 (panel clickable)
• acpi (battery)
• bc (various math)
• bind-tools (network external ip)
• xtitle (window title)
• wireless_tools (network essid)
• lm_sensors (cpu temp)
• trayer (tray icon display)

Other useful programs

• xclip (clipboard manager)
• ranger (file manager)
• sublime-text (text editor)
• sxiv (image viewer)
• xautolock (for auto suspend script)
• scrot (screenshotter)
• dmenu (dynamic menu)
• htop (task manager)
• mpd (music player)
• ncmpcpp (mpd controller)
• mpv (video player)
• aria2 (download utility)

Installation

General

• Install the packages/programs that you want as mentioned above.
• Clone this repository:

$ git clone --depth=1 https://github.com/bvanhai/dotfiles

# .vim directory:
$ git clone --depth=1 https://github.com/bvanhai/.vim

• The dotfiles can simply be moved to their respective locations followed by a restart of the X server. I use symlinks to keep my file system organized so that all of these files live within the folder dotfiles in my home directory.

# Change directory to where you cloned the dotfiles:
$ cd dotfiles

# Edit 'config' file to specify which dotfiles are to be symlinked

# Install 'ruby' package:

# Then, run:
$ ruby install.rb

• Symlink the .vim directory:

$ ln -s /path/to/downloaded/.vim ~/.vim

After the files are moved/symlinked please read the configuration section below.

Suspend Service

The suspend@.service in ~/dotfiles/linux/etc/systemd/system should be moved to /etc/systemd/system/, and enabled with systemctl enable suspend@user.service as root (replace user with the user you would like to enable the service for). The service relies on .bin/echoDisplay.sh to create /tmp/DISPLAY.env to ensure that sxlock is able to find the required display.

GTK Themes

I use OMG-Dark along with the Azenis Icons icon theme and Pulse-Glass-Sapphire-Small mouse cursor theme.

Font

I use default font is Droid Sans and terminal emulator font is DejaVu Sans Mono.

Configuration

Panel

The panel can be configured from the variable file located at .bin/panel/panel_settings where some settings, such as DUAL_BATT, may need to be changed to match your system configuration. The panel and notifications are based off of a screen resolution of 1600x900. If you do not have a screen of this size panel_settings and all of the _not files will need to be modified to support alternate sizes.

Additional color configuration is available at .bin/panel/panel-colors-dzen.

Keybinds

Keybinds can be modified in the .config/sxhkd/sxhkdrc files.

Touchpad Synaptics

Only for laptop user, to configuration touchpad tap to click: the 50-synaptics.conf in ~/dotfiles/linux/etc/X11/xorg.conf.d should be moved to /etc/X11/xorg.conf.d/, that's all.

Background

Feh uses any file located at /home/Data/Wallpapers, can be modified in the .autostart files.

Auto Suspend

The auto suspend settings can be modified at .bin/autoSuspend.sh.

NOTE: The fullscreen setting only works for BSPWM.

xinitrc

My xinitrc launches a few applications you may not use. Simply remove them from the list and add your own.

Font Configuration

Install the fontconfig-infinality package.

Kernel Configuration

For those who want my kernel .config (and I don’t recommend that since I extremely configured it to work on my end and it probably will result in several kernel panics before you get your kernel booting on your end) you can see it in ~/dotfiles/linux/boot/config-kernel-bvanhai (The file is named config-kernel-bvanhai, just be sure to change it to .config and run these commands beforehand:

$ make oldconfig && make prepare

I’m not responsible for you breaking your system or losing important data.

Document

• My GNU/Linux cheat-sheet - bvanhai
• My Arch Linux install - bvanhai
• My Gentoo Linux install - bvanhai
• Awesome Linux Software - LewisVo
• The Linux Kernel Configuration Guide - DOTSLASHLINUX

Credits

Acknowledgment; I established this dotfiles referring to the following user's repositories. Thus, I would appreciate it if you used my repository for reference. Thanks.

• These dotfiles are heavily based on @tungel's dotfiles
• Inspired by @seenaburns's dotfiles
• Panel based on @benghaem's dotfiles
• Conky based on @dobbie03's conky and @satya164's conky - deviantart

Many thanks to the dotfiles community and the creators of the incredibly useful tools.

License

Licensed under the MIT license.

⬆ back to top