dotfiles

• What is this, Chosto ?
• Contents
• Requirements
• Usage
  • Bare repository trick
  • Divergence betwteen laptop and desktop
  • Configuration outside XDG_CONFIG_HOME, e.g. /etc
  • Git Hook
  • Screenshots

What is this, Chosto ?

I used a lot Debian/Ubuntu with Gnome. So a full Desktop Manager with a stacking Windows Manager. A friend of mine showed me i3, a great and customizable tiling Windows Manager (i.e. no windows stack, just divide the scren and take all empty space).

With some customization and additionnal component (in this repo), I managed to get a functional and pleasant yet lightweight environment (for me, no brag).

So basically, what I like about this setup is that there is no "useless" menu bar anywhere and no border. Just windows with gaps between them when multiple windows are on the same screen, and keybord shortcuts for productivity.

I added to the classic Arch/i3 :

• A notification daemon (urgency-aware), Dunst, controlled by shortcuts (but possibly with mouse).
• A fancy lock screen, with optionnal suspend-to-RAM, either triggered by hotkey or when there is no activity for X minutes.
• A Display Manager (LightDM), for login and X starting.
• A great File Explorer (SpaceFM), with hotkey / command-line / screen-split / protocol handlers / events support.
• ZSH with Oh My ZSH and excellent community plugins (Git aliases, Docker autocomplete, FASD bindings, cat and man coloration...)
• Some mappings to control ALSA volume from dedicated keyboards buttons, to play/plause players compatible with MPRIS D-Bus Interface spec ; some changes to key speed (X settings) ; Smooth and dark theme for GTK and for Sublime-Text...

Contents

Setup for :

• i3, a great tiling windows manager
  • In fact i3-gaps, to add margins between windows
  • And i3-lock-color, an improved lock screen
• LightDM with custom GTKTheme and background
• Sublime Text 3
• Polybar, a great replacement for i3-bar with easy custom plugins
• Terminator
• ZSH with Oh My ZSH!
• Dunst, a great and lightweight notification daemon
• Rofi, a full-customizable app launcher/windows switcher
• Sound setup (total beginner there btw) :
  • JACK, a sound server, without PA support ;
  • PianoTeq, a virtual synth ;
  • Cadence and Claudia, JACK and LADISH front-ends ;
  • Non-Mixer, a mixer.
  • Ardour, a DAW.
• Random things (GTK3+ theme, Redshift, taskwarrior...)
• A custom script to take screenshots and save them or upload them
• Screenshots (area or windows), with saving or uploading to a Lychee server (custom script here)

Here is a screenshot of the rendition i3/polybar with this setup (and yeah, I use nano, sorry to disappoint)

Requirements

Configuration makes use of these things, just to record but not exhaustive :

• oh-my-zsh
• fasd
• Pygments (with pygmentize command)
• Powerline Fonts
• sudo pip install --upgrade google-api-python-client
• SpaceFM
• PlayerCTL
• GTK Arc Theme
• Fonts : Noto Sans, Noto Emoji, DejaVu Sans, MaterialIcons, Symbola
• xdotool, xsel
• gnupg
• maim, for screenshot + pip install pyperclip
• Python 3.7
• opensmtpd

#todo automatic installation of dependencies

Usage

Please note : on my system XDG_CONFIG_HOME is empty and default to $HOME/.config.

Bare repository trick

• Clone in bare repository : git clone --bare https://github.com/Chostakovitch/dotfiles.git $HOME/.cfg. A bare repository does not have a working tree (basically it is just .git content). So we avoid conflicts with another git repository.
• Create a working tree outside .cfg : git --git-dir=$HOME/.cfg/ --work-tree=$HOME checkout.
• Adjust DEFAUT_USER in ~/.zshrc.
• Adjust other environment variables, such as SCREENSHOT_PATH.
• Source ~/.zshrc and use provided config alias to pull.
• config config --local status.showUntrackedFiles no to ignore untracked files in status (better as it is home dir).

Credits to this great article for the trick.

Divergence betwteen laptop and desktop

As desktop machine and laptop don't have configuration conflicts (e.g. laptop uses PulseAudio and desktop uses ALSA/Jack), some files have .desk extension and others .laptop. Configuration files that works on both systems have no extension.

Launch ~/.init_config.sh to create symlinks (e.g. ~/.config/i3/config will be symlinked to ~/.config/i3/config.laptop if I launch ~/.init_config.sh laptop).

Configuration outside XDG_CONFIG_HOME, e.g. /etc

Some configuration files reside in /etc directory, but I want to keep track of them.

Just create a folder in XDG_CONFIG_HOME and a file named dest. In this file, write the destination path. Then, copy the configuration files that you want to track and add them to the repository. You can also use .desk and .laptop extensions for specific configuration.

The ~/.init_config.sh script will copy relevant files (laptop or desktop) in the directory specified by dest file. Now you just modify the files tracked by Git and run ~/.init_config.sh.

Example : see ~/.config/lightdm directory.

Git Hook

You may want to add a file named post-merge and pre-push in ~/.cfg/hooks with contains something like :

#!/bin/sh

exec ~/.init_config.sh <whatever you environment is>

And then chmod +x ~/.cfg/hooks/{post-merge,pre-push}. When you pull, changes are applied automagically.

Note this is a quick and quite dirty solution.

Screenshots

Todo : move it on another repo

A small script inside ~/.config/i3/scripts/ uses maim to take screenshots. Then, a flag can either save locally the image or upload it (now, only on a Lychee server using the API).

The ~/.config/i3/scripts/config.py contains the default configuration.

In either case, the link or path is copied to clipboard and a notification is triggered.