diff --git a/README.md b/README.md
index 07aa7f9..a956fdc 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,41 @@
-# plugin.video.movistarplus
\ No newline at end of file
+# Movistarplus for Kodi
+
+_This addon is not officially commissioned/supported by Movistar. All product names, logos, and trademarks mentioned in this project are property of their respective owners._
+
+## Description
+Watch live channels, recordings and video on demand content from Movistarplus Spain in Kodi. Requires a subscription.
+This addon is compatible with Kodi 18, 19 and 20.
+
+## Installation
+Download `script.module.ttml2ssa-x.x.x.zip` and `plugin.video.movistarplus-x.x.x.zip` from the [Releases page](https://github.com/Paco8/plugin.video.movistarplus/releases) and install them in Kodi in that order.
+
+You may also need to install (or activate) the addon inputstream.adaptive.
+
+---
+
+## Descripción
+Con este addon puedes ver los canales en directo, grabaciones, últimos 7 días y TV a la carta de Movistarplus España en Kodi. Es necesario estar abonado.
+El addon es compatible con Kodi 18, 19 y 20.
+
+* Sin publicidad antes de ver los contenidos.
+* Se pueden ver los canales de deportes en Android TV y similares.
+
+## Instalación
+Descarga `script.module.ttml2ssa-x.x.x.zip` y `plugin.video.movistarplus-x.x.x.zip` de [la página Releases](https://github.com/Paco8/plugin.video.movistarplus/releases) e instálalos en Kodi en ese orden.
+
+También es posible que tengas que instalar (o activar) el addon inputstream.adaptive.
+
+## Inicio de sesión
+Lamentablemente en estos momentos no es posible iniciar sesión introduciendo nombre de usuario y clave. Hay que utilizar un programa externo que extraerá un token de la web de movistarplus.
+
+## Configuración
+
+- **`Solo mostrar el contenido incluido en la suscripción`**: si está activada esta opcion el contenido fuera de tu abono no aparecerá en los listados. Si está desactivada sí aparecerá pero marcado en gris, y aunque te dejará intentar reproducirlo seguramente dará un error.
+
+- **`Mostrar el programa en emisión en los canales de TV`**: la lista de canales mostrará además el programa que se está emitiendo en esos momentos en cada canal.
+
+- **`Modificar manifiesto`**: arregla el nombre de los idiomas de audio y subtítulos, y modifica los subtítulos (TV a la carta) para que puedan mostrarse correctamente en Kodi.
+
+- **`Usar proxy para la licencia`**: necesario para que se puedan reproducir los contenidos en determinados dispositivos.
+- **`Intentar solucionar el error 4027`**: activa un truco para solucionar el error 4027 que se produce en determinadas ocasiones al intentar reproducir vídeos.
+- **Experimental: `Tipo de DRM`**: déjalo en `Widevine`. `Playready` de momento no funciona.
diff --git a/addon.xml b/addon.xml
index 3d217f0..d19d310 100644
--- a/addon.xml
+++ b/addon.xml
@@ -1,7 +1,7 @@
@@ -29,8 +29,9 @@
icon.png
-
-
+ resources/screen1.jpg
+ resources/screen2.jpg
+ resources/screen3.jpg
diff --git a/resources/screen1.jpg b/resources/screen1.jpg
new file mode 100644
index 0000000..7ce8fd9
Binary files /dev/null and b/resources/screen1.jpg differ
diff --git a/resources/screen2.jpg b/resources/screen2.jpg
new file mode 100644
index 0000000..22c8e2e
Binary files /dev/null and b/resources/screen2.jpg differ
diff --git a/resources/screen3.jpg b/resources/screen3.jpg
new file mode 100644
index 0000000..2514c87
Binary files /dev/null and b/resources/screen3.jpg differ
diff --git a/resources/settings.xml b/resources/settings.xml
index 087f1d9..5ac4067 100644
--- a/resources/settings.xml
+++ b/resources/settings.xml
@@ -12,7 +12,7 @@
-
+