diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b11f283
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+# filter-recent
+
+![](https://img.shields.io/badge/written%20in-PHP-blue)
+
+A utility to filter recent items from GNOME applications.
+
+GNOME applications keep a list of recently accessed URIs (documents, RDP sessions, ...) in the `~/.local/share/recently-used.xbel` file. Individual applications (e.g. `evince`) don't offer a level of control over this file, and if you are using GNOME applications on a non-GNOME desktop (e.g. Xfce) then other methods of removing entries are not necessarily easily available.
+
+The `filter-recent` utility allows you to remove multiple entry ranges from this file, either on-demand, or automatically as part of e.g. `.bashrc` or `.profile`.
+
+## Usage
+
+
+```
+Usage:
+  filter-recent [OPTIONS]
+  
+Options:
+  --xbel PATH           Custom path to the 'recently-used.xbel' file
+  -i                    Replace file on disk
+  --no-write            Do not replace file on disk (default)
+  --stdout              Display output to stdout (use with --no-write)
+  --contains SUBSTRING  Remove entries where the file path contains SUBSTRING
+  --excise START END    Remove entries visited between START and END.
+  --help                Display this message
+  -v, --verbose         Verbose
+
+Date formats:
+  This version of 'filter-recent' uses PHP strtotime for parsing date bounds.
+  Detailed information about the available date format support is available at
+   the URL http://php.net/manual/en/function.strtotime.php .
+
+```
+
+
+## Changelog
+
+2017-05-01 1.0
+- Initial public release
+- [⬇️ filter-recent-1.0.tar.xz](dist-archive/filter-recent-1.0.tar.xz) *(1.48 KiB)*
+
diff --git a/dist-archive/filter-recent-1.0.tar.xz b/dist-archive/filter-recent-1.0.tar.xz
new file mode 100644
index 0000000..8908e70
Binary files /dev/null and b/dist-archive/filter-recent-1.0.tar.xz differ