From 658571f5521f1b72a3782f294a94a8e4b8075a42 Mon Sep 17 00:00:00 2001
From: Marc Brillault <marc@brillault.fr>
Date: Mon, 16 Jul 2018 07:44:05 +0200
Subject: [PATCH] readme.md

---
 README.md | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 54 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c4a204f..13e7500 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,54 @@
-# embed
\ No newline at end of file
+# Embryo/Embed
+
+This is a library intended to easily embed data from different kind of sources.
+
+## Installation
+
+- via composer : `composer require embryo/embed`
+
+## Usage
+
+
+```php
+<?php
+
+require_once __DIR__.'/vendor/autoload.php';
+
+$url = 'https://www.youtube.com/watch?v=2_HXUhShhmY';
+
+$embed = new \Embryo\Embed\Embed($url);
+echo $embed->getEmbeddedCode();
+```
+
+Will display :
+```html
+<iframe
+    width="400"
+    height="225"
+    src="https://www.youtube.com/embed/2_HXUhShhmY"
+    frameborder="0"
+    allow="autoplay; encrypted-media"
+    allowfullscreen>
+</iframe>
+```
+
+## Configuration
+
+Some of the default values can be overrided by editing the correct env value.
+
+We strongly suggest using [phpdotenv](https://github.com/vlucas/phpdotenv) to do so.
+
+Available values are:
+- `EMBED_WIDTH` (Used on videos, default value is 400)
+- `EMBED_RATIO` (Used on videos, default value is 16/9)
+
+## Available sources
+
+- Video services
+    - DailyMotion
+    - Vimeo
+    - Youtube
+    
+## Suggesting another source
+
+All suggestions are welcome, just create an issue here : https://github.com/MarcBrillault/embed/issues