diff --git a/README.md b/README.md
index 02de074..9b553e1 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,50 @@
 # dotfiles
-collection of configuration files
+A collection of configuration files meant to be used with GNU stow.
+
+## Usage
+
+### List of packages to install
+* alacritty
+* audacious
+* bash-completion
+* bitwarden
+* dunst
+* eza
+* feh
+* firefox
+* git
+* pavucontrol
+* picom
+* polybar
+* ripgrep
+* rofi
+* starship
+* stow
+* unzip
+* visual-studio-code-bin
+
+### Getting the repository
+Navigate to your home directory `~/`.
+Download the repository to that directory or do it the recommended way and clone it there with git:
+```
+    git clone https://github.com/zegonix/dotfiles.git
+```
+or
+```
+    git clone git@github.com:zegonix/dotfiles.git
+```
+
+**Note:** The location of the local copy is important for stow. You can put it somewhere else, but you will have to configure stow to inform it of non default source and target locations, the target is relative to the source by default.
+
+### Link configurations with GNU stow
+Make sure to have `stow` installed.
+Navigate into your local copy of the repository, usually `~/dotfiles`.
+Create links to the configurations with:
+```
+    stow <package>
+```
+for example
+```
+    stow alacritty
+```
+It is important to execute this and similar commands in the root directory of the repository `~/dotfiles` unless you specify source and target locations manually.
\ No newline at end of file
diff --git a/audacious/.config/audacious/QtUi.conf b/audacious/.config/audacious/QtUi.conf
new file mode 100644
index 0000000..48c06b0
--- /dev/null
+++ b/audacious/.config/audacious/QtUi.conf
@@ -0,0 +1,3 @@
+[General]
+geometry=@ByteArray(\x1\xd9\xd0\xcb\0\x3\0\0\0\0\x3\xc5\0\0\0.\0\0\x5\x9a\0\0\x4-\0\0\x3\xc8\0\0\0\x31\0\0\x5\x97\0\0\x4*\0\0\0\0\0\0\0\0\a\x80\0\0\x3\xc8\0\0\0\x31\0\0\x5\x97\0\0\x4*)
+windowState=@ByteArray(\0\0\0\xff\0\0\0\0\xfd\0\0\0\0\0\0\x1\xd0\0\0\x3\xae\0\0\0\x4\0\0\0\x4\0\0\0\b\0\0\0\b\xfc\0\0\0\x1\0\0\0\x2\0\0\0\x1\0\0\0\x16\0M\0\x61\0i\0n\0T\0o\0o\0l\0\x42\0\x61\0r\x1\0\0\0\0\xff\xff\xff\xff\0\0\0\0\0\0\0\0)
diff --git a/i3/.config/i3/config b/i3/.config/i3/config
index 3935590..2701539 100644
--- a/i3/.config/i3/config
+++ b/i3/.config/i3/config
@@ -15,7 +15,7 @@ set $mod Mod4
 
 # Font for window titles. Will also be used by the bar unless a different font
 # is used in the bar {} block below.
-font pango:VictorMono SemiBold 12
+font pango:VictorMonoNerdFont SemiBold 12
 
 
 ###################################
@@ -29,7 +29,7 @@ exec --no-startup-id feh --bg-scale ~/dotfiles/images/city_skyline.png
 
 # clean up and start polybar
 exec_always --no-startup-id killall polybar
-exec_always --no-startup-id bash /home/scbj/.config/polybar/launch_polybar.sh
+exec_always --no-startup-id bash ~/.config/polybar/launch_polybar.sh
 
 # Start XDG autostart .desktop files using dex. See also
 # https://wiki.archlinux.org/index.php/XDG_Autostart
@@ -174,27 +174,29 @@ bindsym $mod+Shift+e exec "i3-nagbar -t warning -m 'You pressed the exit shortcu
 #########################
 
 focus_follows_mouse no
-
+mouse_warping none
 
 ############################
 # configuring presentation #
 ############################
 
 # window border style
-default_border pixel 0
+default_border pixel 2
 
 # gaps between windows and screen border
-gaps inner 10 px
+gaps inner 16 px
 
 # defining colors
-set $bord_focus #D5F188
+set $bord_focus #8070A0
+set $indc_focus #9080C0
 set $back_focus #FFFFFF
 set $text_focus #000000
+set $bord_inact #181830
 
 # class                 border      backgr.     text        indicator   child_border
-client.focused          $bord_focus $back_focus $text_focus $bord_focus $bord_focus
+client.focused          $bord_focus $back_focus $text_focus $indc_focus $bord_focus
 client.focused_inactive #333333     #5f676a     #ffffff     #484e50     #5f676a
-client.unfocused        #333333     #222222     #888888     #292d2e     #222222
+client.unfocused        $bord_inact $bord_inact $text_focus $bord_inact $bord_inact
 client.urgent           #2f343a     #900000     #ffffff     #900000     #900000
 client.placeholder      #000000     #0c0c0c     #ffffff     #000000     #0c0c0c
 
diff --git a/picom/.config/picom.conf b/picom/.config/picom.conf
index 8ce05a3..8c2783a 100644
--- a/picom/.config/picom.conf
+++ b/picom/.config/picom.conf
@@ -1,5 +1,25 @@
 
+# shadows
+shadow = false;
+shadow-radius = 10;
+shadow-opacity = 0.4;
+shadow-color = "#000000"
+
+# fading
+fading = true;
+fade-in-step  = 0.05;
+fade-out-step = 0.05;
+fade-delta    = 8;
+
+# opacity
 inactive-dim = 0.2
 
+# corners
+corner-radius = 2;
+rounded-corners-exclude = [
+  "window_type = 'dock'"
+];
+
+# general
 xrender-sync = true;
 xrender-sync-fence = true;
\ No newline at end of file
diff --git a/polybar/.config/polybar/config.ini b/polybar/.config/polybar/config.ini
index 6857b41..7efa249 100644
--- a/polybar/.config/polybar/config.ini
+++ b/polybar/.config/polybar/config.ini
@@ -30,6 +30,8 @@ width = 100%
 height = 28pt
 radius = 0
 
+monitor = ${env:MONITOR:}
+
 ; dpi = 96
 
 background = ${colors.background}