diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c525b11
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+## gnome-shell-extension-weather
+
+gnome-shell-extension-weather is a simple extension for displaying weather notifications in Gnome Shell.
+
+Currently, the weather report including forecast for today and tomorrow is fetched from [Yahoo](http://weather.yahoo.com/).
+
+### Screenshot
+
+![Screenshot](screenshot.png)
+
+### Installation
+
+1. Change `YAHOO_ID` to your location in extension.js (cf. [WOEID](http://developer.yahoo.com/geo/geoplanet/guide/concepts.html))
+2. Put directory `weather@venemo.com/` in `~/.local/share/gnome-shell/extensions/`
+3. Restart Gnome Shell (`[Alt]+[F2]`, `r`)
+4. Enjoy, contribute, ...
+
+### Licence
+
+Copyright (C) 2011
+Timur Kristóf <venemo@msn.com>,
+Elad Alfassa <elad@fedoraproject.org>,
+Simon Legner <Simon.Legner@gmail.com>
+
+This file is part of gnome-shell-extension-weather.
+
+gnome-shell-extension-weather is free software: you can redistribute it and/or modify it under the terms of the **GNU General Public License as published by the Free Software Foundation, either version 3** of the License, or (at your option) any later version.
+
+gnome-shell-extension-weather is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with gnome-shell-extension-weather.  If not, see <http://www.gnu.org/licenses/>.
+
diff --git a/screenshot.png b/screenshot.png
new file mode 100644
index 0000000..fb5ffcc
Binary files /dev/null and b/screenshot.png differ