dotfiles/org/config/index.org

Phundrak’s dotfiles

• Presentation
• Features
  • Tiling Window Managers
    • StumpWM
    • AwesomeWM (Deprecated)
    • i3 configuration (Deprecated)
      • Polybar config (Deprecated)
  • Theme and graphical tweaks
    • GTK Settings
      • GTK2
        • General configuration
        • Filechooser
      • GTK3
    • Picom (Compton)
    • Xresources
  • Text and source code editing
    • Emacs configuration
    • Nano (deprecated)
    • Rustfmt
  • Custom scripts in PATH
  • Terminal configuration
    • Fish configuration with useful abbreviations
    • Tmux configuration
  • And some minor configuration files
    • Email signature
    • Global gitignore
    • Paru
• Installation
• Licence

Presentation

This is my collection of dotfiles for my daily GNU/Linux environment, tweaked to my liking. If you wish to get the same setup as mine, follow the instructions below.

For starters, here is the link to all the pages on my website that you might find interesting. I’ll describe them in more details below.

As you can see, I personally use fish as my shell of choice, and Emacs 29.0 as my main text editor.

When it comes to my graphical UI, I do not have any desktop environment. Instead, I have a tiling window managers, StumpWM. I used to use i3-gaps, an i3 fork by Airblader, with which I used Polybar as well as pywal to define my system’s color scheme, and then I used Awesome. But now, as said above, I prefer to use StumpWM. It has a built-in status bar (called a mode-line, like in Emacs) which I use, and I settled on the dark Nord theme for pretty much everything I use.

Finally, you can find my configuration for my ErgodoxEZ keyboard here. It is optimized for usage with the Bépo layout set as a software layout. It has also a layer set to emulate a Qwerty layout when using the Bépo software layout due to some games that do not offer to remap keys (I’m looking at you, Among Us).

Features

• Emacs configuration perfectly tailored for my own use
• Beautiful and comfy AwesomeWM and StumpWM configuration
• And enough information below to get basically the same distro install as I have on my main computer and my travel laptop.

Most of the org files you will find in this repos are the actual source code of much of my config files. For instance, the bootstrap found in bootstrap.org exports almost all of its code snippets to .config/yadm/bootstrap thanks to M-x org-babel-tangle from within Emacs. Below I will also present and comment some of my short config files which do not deserve to have a full org file dedicated to them.

Tiling Window Managers

StumpWM

StumpWM is the tiling window manager I use at the moment. It is written and configured in Common Lisp, which I enjoy a lot since it has a syntax quite close to Elisp, the Lisp dialect used in Emacs. I’m currently still in the process of figuring out my config, so please consider it as a kind of work in progress. You can find the configuration here.

AwesomeWM (Deprecated)

AwesomeWM is the TWM I used for quite some time after switching from i3. This is an automatic tiling window manager written and configured mostly in Lua, with its core written in C (this is originally a dwm fork). My configuration for it is documented in detail in its corresponding document, which you can find here.

i3 configuration (Deprecated)

The i3 configuration is detailed in its corresponding README which you can find here. Be aware I do not use i3 anymore, and I will not update it until I may someday use it again. This was deprecated on August 22nd, 2020.

Polybar config (Deprecated)

My annotated polybar config can be found here, if you wish to use it. Be aware I do not use polybar anymore, and I will not update it until I may someday use it again. This was deprecated on August 22nd, 2020.

Theme and graphical tweaks

GTK Settings

GTK2

General configuration

This file is tangled at $HOME/.gtkrc-2.0. This is an equivalent for the GTK3 configuration file you will see below, and it shares most of its settings. First, let’s select the Nordic theme for GTK2. Let’s also set the icon theme.

# -*- mode: unix-config -*-
gtk-theme-name="Nordic"
gtk-icon-theme-name="Flat-Remix-Dark"

gtk-xft-antialias=1
gtk-xft-hinting=1
gtk-xft-hintstyle="hintslight"

This changes the shortcuts in menu, let’s also make the menus snappier.

gtk-can-change-accels=1
gtk-menu-bar-popup-delay=0
gtk-menu-popdown-delay=0
gtk-menu-popup-delay=0

Filechooser

[Filechooser Settings]

The first option alows me to open the file chooser in the current working directory:

StartupMode=cwd

Next, setting the location mode to path-bar will show the path as buttons that can be clicked rather than the full path.

LocationMode=path-bar

With this configuration, by default we won’t see hidden files.

ShowHidden=true

And we'll also see the size of the visible files.

ShowSizeColumn=true

Now, let’s choose the geometry of our file picker. These two first lines set where the file picker appears:

GeometryX=566
GeometryY=202

And these two describe the size of the window:

GeometryWidth=800
GeometryHeight=400

With these two lines, we set how our files are sorted: by name, and in the ascending order.

SortColumn=name
SortOrder=ascending

Our default view mode is a list of files:

ViewMode=list-view

And finally, setting our icon view scale to -1 sets the icon view to the max size.

IconViewScale=-1

GTK3

The following file helps me choosing the aspect of various GTK+ 3 software, including their theme and icons. First, let’s declare the header:

[Settings]

Now, let’s hint to GTK that I prefer dark themes. This can have an influence also on some websites that can detect this preference and therefore set their own theme to dark by themselves.

gtk-application-prefer-dark-theme = true

Next, the icon theme is the Flat Remix Dark icon theme:

gtk-icon-theme-name = Flat-Remix-Dark

Now, the general theme for GTK3 is Nordic.

gtk-theme-name = Nordic

gtk-can-change-accels=1
gtk-menu-bar-popup-delay=0
gtk-menu-popdown-delay=0
gtk-menu-popup-delay=0

gtk-xft-antialias=1
gtk-xft-hinting=1
gtk-xft-hintstyle=hintslight
# gtk-xft-rgba=rgb

Since window decorations are handled by my WMs, I will leave this variable empty.

gtk-decoration-layout=

Picom (Compton)

Picom is a standalone compositor for Xorg, and the successor to Compton, itself successor to xcompmgr-dana, itself a fork of xcompmgr. You can find my Picom configuration here.

Xresources

The main body in my Xresources declaration is the declaration of my color theme. It is based on the Nord theme, from their Git repository.

#define nord0 #2E3440
#define nord1 #3B4252
#define nord2 #434C5E
#define nord3 #4C566A
#define nord4 #D8DEE9
#define nord5 #E5E9F0
#define nord6 #ECEFF4
#define nord7 #8FBCBB
#define nord8 #88C0D0
#define nord9 #81A1C1
#define nord10 #5E81AC
#define nord11 #BF616A
#define nord12 #D08770
#define nord13 #EBCB8B
#define nord14 #A3BE8C
#define nord15 #B48EAD

,*.foreground:   nord4
,*.background:   nord0
,*.cursorColor:  nord4
,*fading: 35
,*fadeColor: nord3

,*.color0: nord1
,*.color1: nord11
,*.color2: nord14
,*.color3: nord13
,*.color4: nord9
,*.color5: nord15
,*.color6: nord8
,*.color7: nord5
,*.color8: nord3
,*.color9: nord11
,*.color10: nord14
,*.color11: nord13
,*.color12: nord9
,*.color13: nord15
,*.color14: nord7
,*.color15: nord6

Text and source code editing

Emacs configuration

Emacs is my main text editor, which I use for almost everything. Because, you know…

Emacs is a great operating system, it just lacks a good text editor.

My current configuration is a vanilla config, meaning I do not rely on another configuration or framework such as Spacemacs or DoomEmacs to configure Emacs. You can find its configuration here.

I used to use a Spacemacs-based configuration, however I deprecated it on October 20th 2021. You can find it here.

Nano (deprecated)

Although it is a very simple piece of software, nano does offer some customization. Mine can be found in my nano.org file. Be aware I do not use nano anymore, and I will not update it until I may someday use it again. This was deprecated on August 28th, 2020.

Rustfmt

You can find my Rustfmt configuration here.

Custom scripts in PATH

I have written some scripts that help me daily accomplish some simple tasks, like mounting and unmounting a drive or Android device, an emoji picker, a utility to set up my Wacom tablet, and so on. You can find them stored in my bin.org file along with their detailed explanation in the README placed in the same folder —which is actually their source code once the org-mode file gets tangled.

Terminal configuration

Fish configuration with useful abbreviations

You can also find in my Fish shell configuration in my fish.org file, which contains my usual abbreviations.

Tmux configuration

You can find my tmux configuration in tmux.org. It depends on the submodule .tmux by Gregory Pakosz.

And some minor configuration files

Email signature

This file gets inserted automatically at the end of my emails.

Lucien “Phundrak” Cartier-Tilet
https://phundrak.com (Français)
https://phundrak.com/en (English)
Sent from GNU/Emacs

Global gitignore

Sometimes, there are some lines that always reappear in gitignores. So, instead of always adding them, let git now that some elements are to be ignored by default, hence the ~/.gitignore_global file. First, we don’t want nano’s backup files.

~*

And object files and output binaries generated by gcc and the likes aren’t welcome either.

,*.out
,*.o

Paru

paru is an AUR helper for Arch Linux which aims to be a replacement for yay. A couple of the options you will see below aim at restoring the behavior of yay in paru. I also activated the sudo loop so I don’t have to enter my password if one package takes too much time to compile and/or compress. I know it can be a security issue if someone ever get access to my computer while paru is running, but if it ever happens it will be already concerning enough they managed to. I also make use of my custom script dired so I can use Emacs’ Dired as the file manager for paru.

[options]
BottomUp
Devel
DevelSuffixes = -git -cvs -svn -bzr -darcs -always
NewsOnUpgrade
PgpFetch
Provides
RemoveMake
SudoLoop
UpgradeMenu

[bin]
FileManager = dired

Installation

For an installation walkthrough of my Arch Linux installation, check out my bootstrap file where I walk you through the first manual steps and through the bootstrap you can execute to automatically take care of a lot of elements.

Licence

All of my dotfiles (and my dotfiles only) are available under the GNU GPLv3 Licence. Please consult /phundrak/dotfiles/src/commit/9144c172398ac82f85dfa48a146e0849ac11b689/org/config/LICENCE.md for more information. In short: you are free to access, edit and redistribute all of my dotfiles under the same licence and as allowed by the licence, and if you fuck up something, it’s your own responsibility.