diff --git a/README.md b/README.md
index e69de29..2d2a833 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,30 @@
+# HID BadUSB Azerty Layout.
+
+Prise en charge du Layout Azerty pour les scripts badUSB pour flipperZero. 
+
+## Testé seulement sur [Xtrem-firmware](https://github.com/Flipper-XFW/Xtreme-Firmware)
+
+# INSTALLATION
+
+**_Au préalable faite une copie des fichiers d'origine._**
+
+Copier le fichier `furi_hal_usb_hid.h` dans le répertoire `$ROOT_FIRMWARE/targets/furi_hal_include/`
+
+Copier le fichier `hid_usage_keyboard.h` dans le répertoire `$ROOT_FIRMWARE/lib/libusb_stm32/inc/`
+
+## Compilation du firmware et flashing du flipperZero.
+
+
+Ce déplacer dans le `$ROOT_FIRMWARE`. 
+
+Pour flasher directement (Le flipper doit être branché via USB mais qFlipper stoppé.)
+
+```
+./fbt flash_usb_full
+```
+
+Pour compiler le paquet TGZ
+```
+./fbt updater_package
+```
+Se référer a la [doc officielle](https://docs.flipper.net/basics/firmware-update) pour installer depuis un paquet tgz.
\ No newline at end of file