diff --git a/CHANGELOG.md b/CHANGELOG.md
index e69de29..b18b1ca 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,12 @@
+# Changelog
+
+## v1.0.0
+Released 31 May 2015
+
+Highlights:
+* Added: support for playlists.
+* Added: number of random items to show.
+* Improved: metadata for items.
+* Fixed: migrated to [`py-sonic`](https://github.com/crustymonkey/py-sonic) to interact with Subsonic.
+
+The full list of commits can be found [here](https://github.com/rembo10/headphones/compare/ff86dfa49f914a18233dee295df74b73a70200e8...v1.0.0).
\ No newline at end of file
diff --git a/README.md b/README.md
index e69de29..ef5dbc0 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,19 @@
+# Subsonic for Kodi
+Kodi plugin to stream music from Subsonic.
+
+## Features
+* Playlist support
+* Browse by artist, album and genre
+* Random playlists
+
+## Installation
+* Navigate to your `.kodi/addons/` folder
+* Clone this repository: `git clone https://github.com/basilfx/plugin.audio.subsonic.git`
+* (Re)start Kodi.
+
+## License
+See the `LICENSE` file.
+
+Additional copyright notices:
+* The original [SubKodi](https://github.com/DarkAllMan/SubKodi) plugin.
+* [`py-sonic`](https://github.com/crustymonkey/py-sonic) Python module.
\ No newline at end of file