diff --git a/README.md b/README.md
index 4c7ec3d..c3f271d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,51 @@
 # Firefox-Word-Replacer-Addon
 
-Goliardic Firefox addon for replacing words on websites with custom text. Completely useless but fun! 🎭
\ No newline at end of file
+A completely useless but fun Firefox addon that replaces names and words on websites. Perfect for when you're tired of reading the same names everywhere and want some variety in your digital life! 🎭
+
+## What's this thing?
+
+Ever been browsing and seeing the same name everywhere? With this addon you can replace any word or name with something more... creative. It's completely silly, has no practical use, but at least you'll have some laughs while browsing.
+
+## Features (if you can call them that)
+
+- Automatically replaces words and names on any web page
+- Simple interface to add your custom replacements
+- Works on all websites (brace yourself for the consequences!)
+- Saves your replacements for future sessions of "creativity"
+
+## Installation
+
+1. Download the source code from this repository
+2. Open Firefox and go to `about:debugging`
+3. Click on "This Firefox" in the sidebar
+4. Click on "Load Temporary Add-on"
+5. Select the `manifest.json` file from the downloaded code
+6. Enjoy the chaos you just unleashed
+
+## How to use it
+
+1. Once installed, click on the addon icon in the toolbar
+2. Add the words you want to replace and what to replace them with
+3. Click "Save Changes"
+4. Browse and enjoy seeing the results of your replacements
+
+**Practical example:** If you're tired of reading about "John", you can replace it with "SuperJohn", "He-Who-Must-Not-Be-Named", or whatever comes to mind.
+
+## Warnings
+
+- This addon is purely for fun. Don't use it for serious stuff!
+- Replacements happen on ALL websites, so you might end up with... interesting results
+- We're not responsible if you get confused and think someone's name is actually "HotPotato2000"
+- Use in moderation (or don't, do whatever you want)
+
+## Technical notes
+
+The addon works by modifying the text content of web pages in real-time. It's pretty simple but effective for its entertainment purpose.
+
+## License
+
+This project is released under GPL v3 license. Feel free to modify it, improve it, or make it even more useless than it already is.
+
+## Disclaimer
+
+This is a project made for fun. It has no pretensions of being useful, professional, or sensible. If you're looking for a serious addon, this probably isn't for you. If you want to add some nonsense to your browsing experience, welcome aboard! 🚀
\ No newline at end of file