diff --git a/.config/weechat/README.md b/.config/weechat/README.md
new file mode 100644
index 0000000..ce0d090
--- /dev/null
+++ b/.config/weechat/README.md
@@ -0,0 +1,23 @@
+
+default IRC settings
+/irc.server_default.nicks "lifthrasil"
+/filter add joinquit * irc_join,irc_part,irc_quit *         #disable notifications about joining or leaving users
+
+default weechat settings
+/set weechat.look.mouse on                                  #enable mouse
+
+irchighway settings
+/server add irchighway irc.highway.net
+/set irc.server.irchighway.autoconnect on
+/set irc.server.irchighway.autojoin "#ebooks"
+
+freenode settings
+/server add freenode chat.freenode.net
+/set irc.server.freenode.autoconnect on
+/set irc.server.freenode.autojoin "#gentoo,#gentoo-chat"
+
+oftc settings
+/server add oftc irc.oftc.net
+/set irc.server.oftc.autoconnect on
+/set irc.server.oftc.autojoin "#debian"
+