Everything to get a working desktop with my config. Lots of Emacs stuff though, and lots of org-mode tangling. https://config.phundrak.com
Go to file
Phuntsok Drak-pa 814ed46f68 moved ~/etc to ~/.etc 2019-10-21 11:01:39 +02:00
.config test 2019-10-21 10:09:53 +02:00
.emacs.d/private added org-mode snippets for emacs 2019-10-08 17:30:25 +02:00
.etc/ly don’t use xinit anymore, replaced with ly display manager 2019-10-20 19:54:16 +02:00
.local better wacom setup utility 2019-10-21 01:25:57 +02:00
.yadm moved ~/etc to ~/.etc 2019-10-21 11:01:39 +02:00
dev reorganized files 2019-09-26 20:49:23 +02:00
img Updated screenshots, from x220 2019-09-21 17:26:40 +02:00
tmux@01c91ba523 fixed some submodules madness 2019-09-21 16:00:03 +02:00
.Xresources moved xresources file 2019-07-21 17:35:44 +02:00
.gitattributes initial commit for new repo 2019-07-21 03:27:31 +02:00
.gitignore_global initial commit for new repo 2019-07-21 03:27:31 +02:00
.gitmodules added dired-phundrak layer for Spacemacs 2019-09-29 18:16:18 +02:00
.nanorc initial commit for new repo 2019-07-21 03:27:31 +02:00
.rustfmt.toml initial commit for new repo 2019-07-21 03:27:31 +02:00
.signature Updated email signature 2019-10-07 12:36:37 +02:00
.spacemacs for some reason, Emacs didn’t like replacing `org` with `html` 2019-10-21 10:47:01 +02:00
.tmux.conf reorganized files 2019-09-26 20:49:23 +02:00
.tmux.conf.local added tmux configuration 2019-08-23 13:46:11 +02:00
CODE_OF_CONDUCT.md initial commit for new repo 2019-07-21 03:27:31 +02:00
LICENSE.md initial commit for new repo 2019-07-21 03:27:31 +02:00
README.org moved ~/etc to ~/.etc 2019-10-21 11:01:39 +02:00

README.org

Phundraks dotfiles

Presentation

https://cdn.rawgit.com/syl20bnr/spacemacs/442d025779da2f62fc86c2082703697714db6514/assets/spacemacs-badge.svg

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.

As you can see, I personally use fish as my shell of choice, and Emacs using Spacemacs (still with Emacs keybinding) as my main text editor.

I also use Resloveds fork of i3-gaps with two polybar bars and Tryone144s fork of Compton. The colors scheme for rofi, Emacs and polybar are chosen from the wallpapers using pywal.

Features

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

Screenshots

/phundrak/dotfiles/media/commit/814ed46f683ef9e9d374def09358dce4a4354e0a/img/neofetch.png
Desktop with Neofetch in the terminal
/phundrak/dotfiles/media/commit/814ed46f683ef9e9d374def09358dce4a4354e0a/img/emacs.png
Desktop with Emacs opened
/phundrak/dotfiles/media/commit/814ed46f683ef9e9d374def09358dce4a4354e0a/img/rofi.png
Desktop with Rofi

Dependencies

Of course, some dependencies are needed for my dotfiles to work well. Here is a non-exhaustive list of software needed by these configuration files:

And some other stuff scattered around in my dotfiles.

BTW, I use Arch.

Installation

Here will be presented what I do to get my system up and running on a fresh Arch Linux install. These installation instructions were written in order to get an Arch Linux distribution up and running with the same configuration as my main computers and my travelling laptops configuration.

Install Arch Linux

I usually install Arch from the vanilla ISO, however I began using archfi to install easily the distro (Ive done it so many times, I know how it works now). Usually, my distros will be installed on at least two partitions, one dedicated to /home, the other to the root partition /.

If the computer supports EFI bootloaders, the EFI partition will be mounted on /boot. I generally use rEFInd as my boot manager, but if you are more comfortable with another one, just install what you want. Be aware that if you format your /boot partition, you will delete all boot managers that already exist; so, if you are dual-booting, DO NOT FORMAT IT. Yes, I made the mistake of wiping the Windows boot manager.

The swap partition is always at least 4GB large, and I should have a total of 12GB of combined RAM and swap. This means on my main computer I have 16GB of RAM and 4GB of swap, but on my thinkpad I have 4GB of RAM and 8GB of swap.

Get the latest live system with fast mirrors

When you boot into the live ISO, execute the following command:

  pacman -Sy reflector
  reflector --country France --country Germany --latest 200 \
            --protocol http --protocol https --sort rate \
            --save /etc/pacman.d/mirrorlist

This will update the packages from your live ISO, and you will get the best mirrors for your installation. Of course, change the countries accordingly to your location.

Install the system

Then you can use a custom script to ease your installation of Arch if you do not wish to do it manually. Personally, Ive done it several times already, I know how the distro works, I just want to be able to install my distro quickly now.

  wget archfi.sf.net/archfi
  # Or from matmoul.github.io/archfi if SourceForge is down
  sh archfi

Then, follow the instructions and install Arch Linux. Take the opportunity to install as many packages as you need, mainly yay which I use as my package manager (it is just a wrapper for pacman) and AUR helper, and pacman-contrib which will help us installing some packages later.

Once your system is installed, reboot and remove your installation media from your computer.

Install basic packages

We will need some basic packages in order to run the bootstrap file. So, lets install fish (our shell running the script) and git.

  sudo pacman -Sy fish git yadm

Execute bootstrap

yadm comes with a very handy feature: its bootstrap script. We can execute it by running the following command:

  yadm bootstrap

Notice these two header files, we can see this is a fish script, hence why we need fish (which is my daily shell anyway).

  #!/usr/bin/fish
  # -*- mode: fish -*-

Lets take a look at what it does.

Get a correct keyboard layout

I use mainly the bépo layout, a French keyboard layout inspired by Dvorak layouts, however I sometimes need to switch back to the standard French AZERTY or the American QWERTY layout, so I make it so the Menu key switches for me my layout between these three. This makes it so my xorg configuration of my keyboard looks like this:

  set keyboardconf \
  'Section "InputClass"
          Identifier "system-keyboard"
          MatchIsKeyboard "on"
          Option "XkbLayout" "fr,fr,us"
          Option "XkbModel" "pc104"
          Option "XkbVariant" "bepo,,"
          Option "XkbOptions" "grp:menu_toggle"
  EndSection'

So, lets set it as our keyboard configuration.

  printf "\n# Set keyboard layout #########################################################\n\n"
  echo $keyboardconf | sudo tee /etc/X11/xorg.conf.d/00-keyboard.conf

Set our locale

I use two main locales, the French and US UTF-8 locales, and I like to keep the Japanese locale activated just in case.

  set mylocales "en_US.UTF-8 UTF-8" "fr_FR.UTF-8 UTF-8" "ja_JP.UTF-8 UTF-8"

Lets enable these.

  printf "\n# Set our locale ##############################################################\n\n"
  for item in $mylocales
      if test (grep -e "#$item" /etc/locale.gen)
          sudo sed -i "/$item/s/^#//g" /etc/locale.gen
      end
  end

This is my configuration I usually use when it comes to my locale.

  set localeconf "LANG=en_US.UTF-8
  LC_COLLATE=C
  LC_NAME=fr_FR.UTF-8
  LC_NUMERIC=fr_FR.UTF-8
  LC_IDENTIFICATION=fr_FR.UTF-8
  LC_TELEPHONE=fr_FR.UTF-8
  LC_MONETARY=fr_FR.UTF-8
  LC_PAPER=fr_FR.UTF-8
  LC_ADDRESS=fr_FR.UTF-8
  LC_TIME=fr_FR.UTF-8
  LC_MEASUREMENT=fr_FR.UTF-8"

Lets set it as our systems locale.

  echo $localeconf | sudo tee /etc/locale.conf

Now we can generate our locale!

  printf "\n# Generate locale #############################################################\n\n"
  sudo locale-gen

Create some folders

Lets create some folders we might need for mounting our drives, Android devices and CDs.

  printf "\n# Create directories for mounting #############################################\n\n"
  sudo mkdir -p /mnt/{USB,CD,Android}
  sudo chown $USER:(id -g $USER) /mnt/{USB,CD,Android}

Set users shell to fish

First of all, the bootstrap shell will set the users shell to fish.

  printf "\n# Set fish as the default shell ###############################################\n\n"
  chsh -s /usr/bin/fish

Install yay if it isnt already installed

Now well need to be sure yay, our AUR helper, is installed on our system. If it is, we dont need to to anything. However, if it isnt, well install it manually.

  if ! test which yay
      printf "\n# Installing yay ##############################################################\n\n"
      cd
      mkdir -p fromGIT
      cd fromGIT
      git clone https://aur.archlinux.org/yay.git
      cd yay
      makepkg -si --noconfirm
  else
      printf "\n# yay already installed #######################################################\n\n"
  end

Setting up Emacs: Installing Spacemacs

Now, the first thing we want to do with Emacs is install its Spacemacs distribution. Well clone its develop branch into ~/.emacs.d. We need to do this prior to our dotfiles cloning because of some submodules that are cloned within our ~/.emacs.d directory, and git wont let us clone Spacemacs in an already existing and non-empty directory. To make sure it isnt one, lets delete any potentially existing ~/.emacs.d directory:

  printf "\n# Installing Spacemacs ########################################################\n\n"
  rm -rf ~/.emacs.d

Now we can clone Spacemacs:

  git clone --single-branch --branch develop https://github.com/syl20bnr/spacemacs ~/.emacs.d

And we can restore what might have been deleted in our ~/.emacs.d/private directory:

  yadm checkout -- ~/.emacs.d/private/

Set up dotfiles

Update our dotfiles remotes

This line in the bootstrap script will test if the current user is using my username. If yes, its probably me.

  if ! test (echo "phundrak" | sed -e "s/^.*$USER//I")

If it is me installing and using these dotfiles, I want the remotes of my dotfiles to be set to ssh remotes using my ssh keys.

  printf "\n# Update yadms remotes #######################################################\n\n"
  yadm remote set-url origin git@labs.phundrak.fr:phundrak/dotfiles.git
  yadm remote add github git@github.com:phundrak/dotfiles.git

I will also want to decrypt my encrypted files, such as said ssh keys.

  printf "\n# Decrypt encrypted dotfiles ##################################################\n\n"
  yadm decrypt

Finally, lets close this if statement.

  end
Get envtpl

Before we set our dotfiles up, lets make sure envtpl is correctly installed. This package will be needed for generating our alt dotfiles.

  printf '\n# Install envtpl ##############################################################\n\n'
  yay -Syu python-envtpl-git
Update our submodules

Now we can download the various dependencies of our dotfiles. To do so, lets run the following command:

  printf "\n# Getting yadm susbmodules ####################################################\n\n"
  yadm submodule update --init --recursive
Generate our alt files

Now this should be the last manipulation on our dotfiles: lets create our alternate files:

  printf "\n# Generating alt files ########################################################\n\n"
  yadm alt
Symlink some system config files

We have some files in etc/ that are to be symlinked to /etc.

  for f in (find ~/.etc -type f)
      set dest (echo $f | sed -n 's/^.*etc\(.*\)$/\/etc\1/p')
      sudo ln -s $f $dest
  end

We may also want to symlink our nanorc to the /root directory for when we use nano as sudo.

  read --prompt "echo 'Symlink .nanorc to roots .nanorc? (Y/n): ' " -l nanoroot
  if test $nanoroot = 'y' || test $nanoroot = "Y" || test $nanoroot = ''
      printf "\n# Symlinking .nanorc to roots .nanorc ########################################\n\n"
      sudo ln -s $HOME/.nanorc /root/.nanorc
  end

Install basic packages

Lets set in a custom varible what packages well be needing.

  set PACKAGES \
  asar ascii aspell-en aspell-fr assimp awesome-terminal-fonts base-devel bat \
  biber bleachbit bluez-firmware bluez-utils bookworm boost bzip2 chromium clisp \
  clight compton cppcheck cppreference cppreference-devhelp cpupower cronie \
  cryptsetup device-mapper diffutils discord-canary discount ditaa dmenu \
  dmenu-lpass docker docker-compose doxygen dunst dwarffortress emacs \
  exfat-utils ffmpegthumbnailer findutils firefox flake8 font-mathematica \
  fontforge freeglut fzf gcc-libs gdb gimp glibc gnome-disk-utility \
  gnome-epub-thumbnailer gnu-free-fonts gnuplot go-tools graphviz htop i3-gaps \
  i3lock-blur i3status igdm-bin inetutils j4-dmenu-desktop jfsutils jmtpfs \
  lastpass-cli less linux-headers lldb logrotate lvm2 ly-git meson minted mpc \
  mpd mpd-rich-presence-discord-git mpv mupdf-tools nano ncdu ncmpcpp \
  nemo-fileroller nemo-preview neofetch netctl networkmanager \
  networkmanager-openvpn nm-connection-editor nnn nomacs noto-fonts-emoji npm \
  ntfs-3g numlockx openssh p7zip pacman-contrib pandoc-bin pavucontrol pciutils \
  pcurses pdfpc polybar pulseaudio-bluetooth python-envtpl-git python-pip \
  python-pywal qemu r raw-thumbnailer reflector rofi rofi-wifi-menu-git rsync \
  rtv rustup s-nail samba scrot sent shadow siji-git simplescreenrecorder \
  speedcrunch sshfs st-luke-git swi-prolog texlive-bibtexextra texlive-bin \
  texlive-core texlive-fontsextra texlive-formatsextra texlive-games \
  texlive-humanities texlive-langchinese texlive-langcyrillic texlive-langextra \
  texlive-langgreek texlive-langjapanese texlive-langkorean texlive-latexextra \
  texlive-localmanager-git texlive-music texlive-pictures texlive-pstricks \
  texlive-publishers texlive-science tmux tree ttf-arphic-uming ttf-baekmuk \
  ttf-bitstream-vera ttf-dejavu ttf-google-fonts-opinionated-git ttf-joypixels \
  ttf-liberation ttf-material-design-icons-git ttf-ms-fonts ttf-symbola \
  ttf-tibetan-machine ttf-twemoji-color ttf-unifont unicode unicode-emoji unrar \
  usbutils valgrind vim w3m wget x11-ssh-askpass xclip xdg-user-dirs-gtk \
  xorg-drivers xorg-apps xfsprogs xorg-server xorg-xinit xss-lock yapf

These are the minimum I would have in my own installation. You can edit it however you want. Lets install those.

  printf "\n# Installing needed packages ##################################################\n\n"
  yay -S --needed $PACKAGES

Installing Tryones Compton fork

For some reason, I found installing directly this fork does not work, and I need to install it after I installed the regular compton packages. compton-tryone-git will replace compton which will be removed.

  printf "\n# Installing tryones compton fork ############################################\n\n"
  yay -S compton-tryone-git

Enable some of our services

We have installed some packages which require some services to run. Lets enable them.

Docker

First, lets activate Docker.

  printf "\n# Enabling and starting Docker ################################################\n\n"
  sudo systemctl enable --now docker

Now, if we wish it, we can be added to the docker group so we wont have to type sudo each time we call Docker or Docker Compose.

  read --prompt "echo 'Do you wish to be added to the `docker` group? (Y/n): ' " -l adddockergroup
  if test $adddockergroup = 'y' || test $adddockergroup = "Y" || test $adddockergroup = ''
      sudo usermod -aG docker $USER
  end
Emacs

Emacs will run as a user service, which means it wont be launched until we log in.

  printf "\n# Enabling Emacs as user service ##############################################\n\n"
  systemctl --user enable --now emacs
SSH server

Maybe we want to activate an SSH server on our machine. If so, we can enable it. Lets ask the question.

  read --prompt "echo 'Do you want to activate the ssh server? (Y/n): ' " -l sshdserver
  if test $sshdserver = 'y' || test $sshdserver = "Y" || test $sshdserver = ''
      printf "\n# Enabling ssh server #########################################################\n\n"
      sudo systemctl enable --now sshd
  end
Ly

Ly is a display manager based on ncurses which I find nice enough for me to use (I generally dont like using display managers). Lets enable it, and lets disable tty2 while were at it (Ly uses it to run X).

  sudo systemctl enable --now ly
  sudo systemctl disable getty@tty2

Set up our fish shell

Install fisher

We will be using fisher as our extensions manager for Fish. Lets install it.

  printf "\n# Installing fisher ###########################################################\n\n"
  curl https://git.io/fisher --create-dirs -sLo ~/.config/fish/functions/fisher.fish
Install our extensions

I generally use the following extensions in my Fish shell.

  set FISHEXTENSIONS \
  edc/bass franciscolourenco/done jethrokuan/fzf jethrokuan/z \
  jorgebucaran/fish-getopts laughedelic/pisces matchai/spacefish \
  tuvistavie/fish-ssh-agent

Lets install these:

  fisher add $FISHEXTENSIONS

Install packages from git

Now, lets install some packages from git directly.

i3-gaps rounded

I know we already installed i3-gaps from the AUR, why reinstall it? Well, that is certainly bad practices, but this allowed me to already have the needed dependencies for building i3 installed. Now, lets clone it, build it, and install it. Doing this is probably very bad practices though, be warned.

  printf "\n# Install i3-gaps-rounded #####################################################\n\n"
  cd ~/fromGIT
  git clone https://github.com/resloved/i3.git i3-gaps-rounded
  cd i3-gaps-rounded
  rm -rf build
  autoreconf --force --install
  mkdir build && cd build
  ../configure --prefix=/usr --sysconfdir=/etc --disable-sanitizers
  make -j
  sudo make install
Polybar Battery

Now lets install polybar-battery. This is a binary that Ill use in my i3 config to indicate my battery level. It also sends a notification on low battery and on charging completed.

  printf "\n# Install polybar-battery #####################################################\n\n"
  cd ~/fromGIT
  git clone https://github.com/drdeimos/polybar_another_battery.git
  cd polybar_another_battery
  go get -u github.com/distatus/battery/cmd/battery
  make build

Now, we have our binary, lets symlink it in our local binary directory, ~/.local/bin.

  ln -s polybar-ab ~/.local/bin/polybar-ab
Reveal.JS

I sometimes use Reveal.JS to make presentations, and I set its location in my dotspacemacs file to be in ~/fromGIT, so lets clone it there.

  printf "\n# Install Reveal.JS ###########################################################\n\n"
  cd ~/fromGIT
  git clone https://github.com/hakimel/reveal.js.git

Install Rust

Install the toolchains

When using rust, I bounce between two toolchains, the stable toolchain and the nightly toolchain. To install them, I will use rustup which has already been installed.

  printf "\n# Install the rust toolchains, nightly is the default one #####################\n\n"
  rustup default nightly

This will both download the nightly toolchain and set it as the default one. Yup, I like to live dangerously. Now to install the stable toolchain, lets run this:

  rustup toolchain install stable
Install some utilities

Well need some utilities when developing Rust from Emacs, namely rustfmt and racer. Lets install them with cargo.

  printf "\n# Add rust utilities ##########################################################\n\n"
  cargo install rustfmt racer

Clean the pacman and yay cache

Finally, we are almost done! Lets clean the cache of pacman and yay.

  printf "\n# Clean the pacman and yay cache ##############################################\n\n"
  yay -Sc --noconfirm

You should now run a system pretty close to the one I have on my main computer and my thinkpad.

Licence

All of my dotfiles (and my dotfiles only) are available under the GNU GPLv3 Licence. Please consult /phundrak/dotfiles/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, its your own responsibility.