diff --git a/README.rst b/README.rst
new file mode 100644
index 00000000..6826da12
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,37 @@
+***********
+slpkg 3.9.9
+***********
+
+Slpkg is a powerful software package manager that installs, updates, and removes packages on
+`Slackware <http://www.slackware.com/>`_ based systems. It automatically computes dependencies and
+figures out what things should occur to install packages. Slpkg makes it easier to maintain groups
+of machines without having to manually update.
+
+Slpkg works in accordance with the standards of the organization `SlackBuilds.org <https://www.slackbuilds.org>`_
+to build packages. Also uses the Slackware Linux instructions for installation,
+upgrading or removing packages.
+
+What makes slpkg distinguish from the other tools; The user-friendliness it's a primary
+target as well as easy to understand and use, also uses colours to highlight packages and
+display warning messages, etc.
+
+Look in the `EXAMPLES.md <https://gitlab.com/dslackw/slpkg/blob/master/EXAMPLES.md>`_ file to explore some examples.
+
+
+Asciicast
+---------
+
+
+.. image:: https://gitlab.com/dslackw/images/raw/master/slpkg/asciicast.png
+    :target: https://asciinema.org/a/3uFNAOX8o16AmKKJDIvdezPBa
+    :width: 250px
+
+
+Copyright
+---------
+
+Copyright 2014-2022 © Dimitris Zlatanidis. 
+
+Slackware® is a Registered Trademark of Patrick Volkerding. 
+
+Linux is a Registered Trademark of Linus Torvalds.