update README

README.md

@@ -1,4 +0,0 @@
-gallery-dl
-==========
-
-download image galleries from several image hosting platforms

README.rst

@@ -0,0 +1,46 @@
+==========
+gallery-dl
+==========
+
+gallery-dl is a image gallery downloader for several image hosting platforms.
+
+Installation
+------------
+
+Via pip:
+
+.. code:: bash
+
+    $ pip install gallery-dl
+
+Or from github:
+
+.. code:: bash
+
+    $ git clone https://github.com/mikf/gallery-dl.git
+    $ cd gallery-dl
+    $ python3 setup.py install
+
+Usage
+-----
+
+.. code:: bash
+
+    $ gallery-dl URL [URL...]
+
+Configuration
+-------------
+
+Configuration files for gallery-dl use a JSON-based file format. For a (more or less) complete example, see gallery-dl.conf_.
+
+gallery-dl searches for configuration files in the following paths:
+
+* /etc/gallery-dl.conf
+* ~/.config/gallery/config.json
+* ~/.config/gallery-dl.conf
+* ~/.gallery-dl.conf
+
+Values in later configuration files will override previous ones.
+
+.. _gallery-dl.conf: https://github.com/mikf/gallery-dl/blob/master/config.json
+