1 files changed, 27 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9d739ba
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# emoji list
+
+A basic list of emojis and their annotations. Useful for building emoji pickers.
+
+## Examples
+
+Here's a minimal emoji picker using dmenu:
+
+```
+dmenu -i -l20 <emoji_list | cut -d' ' -f1 | tr -d '\n' | xclip -selection clipboard
+```
+
+Or the equivalent for wayland:
+
+```
+bemenu -i -l20 <emoji_list | cut -d' ' -f1 | tr -d '\n' | wl-copy
+```
+
+Or using fzf inside tmux:
+
+```
+fzf <emoji_list | cut -d' ' -f1 | tr -d '\n' | tmux load-buffer -w -
+```
+
+## Data source
+
+Data was pulled from Unicode cldr data and then manually cleaned up.