From 28a17b17f997c4b9388518758cbdfb1085e0d513 Mon Sep 17 00:00:00 2001
From: Igor Chubin <igor@chub.in>
Date: Sat, 22 Jun 2019 10:45:14 +0200
Subject: [PATCH] added recommendations about emoji support in terminal (#312)

---
 README.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/README.md b/README.md
index 379115e..bdf0127 100644
--- a/README.md
+++ b/README.md
@@ -174,6 +174,44 @@ set -g status-right "$WEATHER ..."
 ```
 ![wttr.in in tmux status bar](https://wttr.in/files/example-tmux-status-line.png)
 
+To see emojis in terminal, you need:
+
+1. Terminal support for emojis (was added to Cairo 1.15.8);
+2. Font with emojis support.
+
+For the Emoji font, we recommend *Noto Color Emoji*, and a good alternative option would be the *Emoji One* font;
+both of them support all necessary emoji glyphs.
+
+Font configuration:
+
+```
+$ cat ~/.config/fontconfig/fonts.conf
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
+<fontconfig>
+  <alias>
+    <family>serif</family>
+    <prefer>
+      <family>Noto Color Emoji</family>
+    </prefer>
+  </alias>
+  <alias>
+    <family>sans-serif</family>
+    <prefer>
+      <family>Noto Color Emoji</family>
+    </prefer>
+  </alias>
+  <alias>
+    <family>monospace</family>
+    <prefer>
+      <family>Noto Color Emoji</family>
+    </prefer>
+  </alias>
+</fontconfig>
+```
+
+(to apply the configuration, run `fc-cache -f -v`)
+
 ## Moon phases
 
 wttr.in can also be used to check the phase of the Moon. This example shows how to see the current Moon phase: