diff --git a/gui/i3blocks/README.md b/gui/i3blocks/README.md
new file mode 100644
index 0000000..87cf674
--- /dev/null
+++ b/gui/i3blocks/README.md
@@ -0,0 +1,11 @@
+# i3blocks - i3 status bar configuration
+
+## Installation
+1. Install `i3blocks` [AUR](https://aur.archlinux.org/packages/i3blocks/)
+2. Clone this repo to `~/.config/i3blocks`
+
+## Dependencies
+* [i3blocks-contrib](https://github.com/vivien/i3blocks-contrib) (included in AUR package)
+
+## Todo
+* contrib scripts in config directory
diff --git a/gui/i3blocks/config b/gui/i3blocks/config
new file mode 100644
index 0000000..ef2e6ab
--- /dev/null
+++ b/gui/i3blocks/config
@@ -0,0 +1,158 @@
+# i3blocks config file
+#
+# Please see man i3blocks for a complete reference!
+# The man page is also hosted at http://vivien.github.io/i3blocks
+#
+# List of valid properties:
+#
+# align
+# color
+# command
+# full_text
+# instance
+# interval
+# label
+# min_width
+# name
+# separator
+# separator_block_width
+# short_text
+# signal
+# urgent
+
+# Global properties
+#
+# The top properties below are applied to every block, but can be overridden.
+# Each block command defaults to the script name to avoid boilerplate.
+command=/usr/lib/i3blocks/$BLOCK_NAME
+# separator_block_width=15
+markup=pango
+align=center
+
+# [focused window]
+# command=xtitle -s -x
+# interval=persist
+
+# Generic media player support
+#
+# This displays "ARTIST - SONG" if a music is playing.
+# Supported players are: spotify, vlc, audacious, xmms2, mplayer, and others.
+[mediaplayer]
+instance=mpd
+interval=5
+signal=10
+
+# Volume indicator
+#
+# The first parameter sets the step (and units to display)
+# The second parameter overrides the mixer selection
+# See the script for details.
+[volume]
+label=
+instance=Master
+#instance=PCM
+interval=once
+signal=10
+
+# Memory usage
+#
+# The type defaults to "mem" if the instance is not specified.
+[memory]
+label=MEM
+separator=false
+interval=30
+
+# Disk usage
+#
+# The directory defaults to $HOME if the instance is not specified.
+# The script may be called with a optional argument to set the alert
+# (defaults to 10 for 10%).
+[disk]
+label=
+#instance=/mnt/data
+interval=30
+
+# Network interface monitoring
+#
+# If the instance is not specified, use the interface used for default route.
+# The address can be forced to IPv4 or IPv6 with -4 or -6 switches.
+[iface]
+#instance=wlan0
+color=#00FF00
+interval=10
+separator=false
+
+[wifi]
+#instance=wlp3s0
+interval=10
+separator=false
+
+[bandwidth]
+#instance=enp0s25
+interval=persist
+
+# CPU usage
+#
+# The script may be called with -w and -c switches to specify thresholds,
+# see the script for details.
+[cpu_usage]
+label=☢
+interval=10
+min_width=☢ 100.00%
+interval=10
+#separator=false
+
+#[load_average]
+#interval=10
+
+# Battery indicator
+#
+# The battery instance defaults to 0.
+[battery]
+label=BAT
+#label=⚡
+#instance=1
+interval=30
+
+# OpenVPN support
+#
+# Support multiple VPN, with colors.
+[openvpn]
+interval=20
+
+# Date Time
+#
+[time]
+command=date '+%a %d %b %H:%M'
+#command=date '+%Y-%m-%d %H:%M'
+interval=5
+
+#[music]
+#label=♪
+#command=mpc current
+#interval=20
+
+# Temperature
+#
+# Support multiple chips, though lm-sensors.
+# The script may be called with -w and -c switches to specify thresholds,
+# see the script for details.
+#[temperature]
+#label=TEMP
+#interval=10
+
+# Key indicators
+#
+# Add the following bindings to i3 config file:
+#
+# bindsym --release Caps_Lock exec pkill -SIGRTMIN+11 i3blocks
+# bindsym --release Num_Lock  exec pkill -SIGRTMIN+11 i3blocks
+#[keyindicator]
+#instance=CAPS
+#interval=once
+#signal=11
+
+#[keyindicator]
+#instance=NUM
+#interval=once
+#signal=11
diff --git a/meta/configs/i3.yaml b/meta/configs/i3.yaml
new file mode 100644
index 0000000..04cb865
--- /dev/null
+++ b/meta/configs/i3.yaml
@@ -0,0 +1,3 @@
+- link:
+    ~/.config/i3: gui/i3
+#  vim: set filetype=yaml ts=4 sw=4 tw=0 et :
diff --git a/meta/configs/i3blocks.yaml b/meta/configs/i3blocks.yaml
new file mode 100644
index 0000000..8d341a9
--- /dev/null
+++ b/meta/configs/i3blocks.yaml
@@ -0,0 +1,3 @@
+- link:
+    ~/.config/i3blocks: gui/i3blocks
+#  vim: set filetype=yaml ts=4 sw=4 tw=0 et :