diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..048704a8558924e5fc4ce040ee0caea14caa6582
--- /dev/null
+++ b/README.md
@@ -0,0 +1,58 @@
+# PlayBot
+
+
+## Description
+
+PlayBot est un bot IRC permettant de manipuler des liens audio :
++ enregistrement des liens dans une base de données ;
++ récupération et publication sur le chan des informations (titre, posteur) ;
++ normalisation du lien ;
++ sauvegarde de liens en favoris ;
++ rappel du lien en query.
+
+
+## Installation
+
+
+### Dépendances
+
+PlayBot est codé en Perl. Il dépend des modules suivant :
++ DBI ;
++ DBD::mysql ;
++ JSON ;
++ LWP::UserAgent ;
++ HTML::Parser ;
++ HTML::Entities ;
++ POE ;
++ POE::Component::IRC ;
++ Tie::File.
+
+
+### Configuration
+
+Pour l'instant, seule la configuration de la base de donnée est externalisée. Vous devez créer un fichier *playbot.json* dans le même dossier que le fichier *PlayBot.pl* contenant les attributs suivant (les noms devraient être assez explicites) :
++ bdd ;
++ host ;
++ user ;
++ passwd.
+
+Le reste de la configuration s'effectue encore directement dans le fichier *PlayBot.pl*. Les variables suivantes sont modifiables :
++ $serveur ;
++ $port ;
++ $nick ;
++ $ircname ;
++ $username ;
++ @channels ;
++ $admin ;
++ $baseurl.
+
+Les noms des variables sont plutôt explicites. *$admin* contient le nick du l'utilisateur qui aura le droit d'administrer le bot (attention, aucune vérification autre que le nick n'est pour l'instant faîte, il est recommandé de l'enregistrer). *$baseurl* contient l'url racine du site permettant de consulter le contenu de la base de données.
+
+
+## Utilisation
+
+Dès qu'un lien est posté, le bot récupère le nom du contenu et de la personne l'ayant posté, et l'insère dans la base de données (grâce à l'unicité du lien et à sa normalisation, un même contenu ne peut être enregistré deux fois). Il poste ensuite sur le channel les informations récupérées avec l'id du contenu.
+
+Les différentes commandes utilisables sont les suivantes sur le channel où se trouve le PlayBot :
++ !fav [id] : enregistre en favoris le contenu possédant l'identifiant *id*. Si l'identifiant n'est pas préciser, le dernier contenu posté (et non inséré) est utilisé.
++ !later [id [in [Xs|Xm|Xs]]] : demande au PlayBot de rappeler en query un contenu. La durée par défaut est de 6h. Si l'identifant n'est pas précisé, le dernier contenu posté est utilisé.