diff --git a/README.md b/README.md
index bb7df42..f833dd3 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,46 @@
 # TailsX-Firefox-Extension
-Adds TailsX as the default search engine in Firefox browser. 
+**TailsX** is a privacy-respecting, ad-free, self-hosted Google metasearch engine with strong security that offers full API support and utilizes Qwant for images, Brave Search for videos, and DuckDuckGo for auto-complete.
+
+[**Original TailsX repository on GitHub**](https://github.com/Extravi/tailsx).
+
+# How does it work?
+Extension use `manifest.json` settings which change your main search engine.
+
+Example:
+
+(**Default settings**)
+```json
+{
+  "chrome_settings_overrides": {
+    "search_provider": {
+      "search_url": "https://example.com/search?q={searchTerms}",
+      "suggest_url": "https://example.com/suggestions?q={searchTerms}",
+    }
+  }
+}
+```
+
+(**With addon**)
+```json
+{
+  "chrome_settings_overrides": {
+    "search_provider": {
+      "search_url": "https://search.nya.pub/search?q={searchTerms}",
+      "suggest_url": "https://search.nya.pub/suggestions?q={searchTerms}",
+    }
+  }
+}
+```
+
+It means that your browser starts to use second link when you make search request.
+
+# Tricks
+If you want use **TailsX** as support to main search engine do this:
+- fork this repository and change the search URL according to your domain
+- add this addon into your browser
+- agree when browser shows you "Add this extension?"
+- disagree when browser shows "Do you want change your main search engine?"
+- use keywords like `@tailsx, @tx` if you want use **TailsX** when you make request
+
+# Distribute your extension
+https://extensionworkshop.com/documentation/publish/
diff --git a/_locales/de/messages.json b/_locales/de/messages.json
new file mode 100644
index 0000000..7de231e
--- /dev/null
+++ b/_locales/de/messages.json
@@ -0,0 +1,5 @@
+{
+    "extensionDescription": {
+        "message": "TailsX als Standardsuchmaschine in Ihrem Browser hinzufügen. Sichern Sie Ihre Suchanfragen mit sofortigem Zugriff auf die TailsX-Metasuchmaschine."
+    }
+}
diff --git a/_locales/en/messages.json b/_locales/en/messages.json
new file mode 100644
index 0000000..6898637
--- /dev/null
+++ b/_locales/en/messages.json
@@ -0,0 +1,5 @@
+{
+    "extensionDescription": {
+        "message": "Adds TailsX as the default search engine in your browser. Secure your queries with instant access to TailsX metasearch engine."
+    }
+}
diff --git a/_locales/ru/messages.json b/_locales/ru/messages.json
new file mode 100644
index 0000000..a06e9f5
--- /dev/null
+++ b/_locales/ru/messages.json
@@ -0,0 +1,5 @@
+{
+    "extensionDescription": {
+        "message": "Устанавливает TailsX в качестве поисковой системы по умолчанию. Защитите свои запросы с мгновенным доступом к метапоисковой системе TailsX."
+    }
+}
diff --git a/_locales/uk/messages.json b/_locales/uk/messages.json
new file mode 100644
index 0000000..7b15f73
--- /dev/null
+++ b/_locales/uk/messages.json
@@ -0,0 +1,5 @@
+{
+    "extensionDescription": {
+        "message": "Встановлює TailsX у якості пошукової системи за замовчанням. Захистіть свої запити за допомогою миттєвого доступу до двигуна TailsX."
+    }
+}
diff --git a/icons/search128.webp b/icons/search128.webp
new file mode 100644
index 0000000..5d0b987
Binary files /dev/null and b/icons/search128.webp differ
diff --git a/icons/search256.webp b/icons/search256.webp
new file mode 100644
index 0000000..cece615
Binary files /dev/null and b/icons/search256.webp differ
diff --git a/icons/search48.webp b/icons/search48.webp
new file mode 100644
index 0000000..09eef66
Binary files /dev/null and b/icons/search48.webp differ
diff --git a/manifest.json b/manifest.json
new file mode 100644
index 0000000..83cb60e
--- /dev/null
+++ b/manifest.json
@@ -0,0 +1,29 @@
+{
+  "manifest_version": 2,
+  "name": "TailsX — Privacy Meta Search Engine",
+  "version": "1.0",
+  "author": "voron",
+  "default_locale": "en",
+  "description": "__MSG_extensionDescription__",
+  "icons": {
+    "48": "icons/search48.webp"
+  },
+  "browser_action": {
+    "default_title": "TailsX"
+  },
+  "browser_specific_settings": {
+    "gecko": {
+      "strict_min_version": "64.0"
+    }
+  },
+  "chrome_settings_overrides": {
+    "search_provider": {
+      "name": "TailsX",
+      "keyword": "@tailsx, @tx",
+      "search_url": "https://search.nya.pub/search?q={searchTerms}",
+      "favicon_url": "icons/search128.webp",
+      "suggest_url": "https://search.nya.pub/suggestions?q={searchTerms}",
+      "is_default": true
+    }
+  }
+}