asimawdah · Nov 13, 2026 · Nov 13, 2026 · Nov 13, 2026 · Nov 13, 2026 · Nov 13, 2026
diff --git a/ar/guide/download.md b/ar/guide/download.md
@@ -68,7 +68,7 @@ title: التنزيل والتثبيت
 
 ## امتداد المتصفح
 
-امتداد MV3 لمتصفحات Chrome وEdge وFirefox. [ثبّت امتداد OpenKey من متجر Chrome](https://chromewebstore.google.com/detail/cmebbcnocamcolnedgafbkeelejldoga?utm_source=item-share-cp). لمتصفحات Edge وFirefox أو للتثبيت اليدوي، ابنِ الامتداد وحمّل مجلد `dist/`:
+امتداد MV3 لمتصفحات Chrome وEdge وFirefox. [ثبّت امتداد OpenKey من متجر Chrome](https://chromewebstore.google.com/detail/openkey/cmebbcnocamcolnedgafbkeelejldoga). لمتصفحات Edge وFirefox أو للتثبيت اليدوي، ابنِ الامتداد وحمّل مجلد `dist/`:
 
 ```bash
 cd openkey_extension

diff --git a/ar/guide/extension.md b/ar/guide/extension.md
@@ -27,7 +27,14 @@
 
 ## التثبيت
 
-ثبّت الامتداد على Chrome من [متجر Chrome](https://chromewebstore.google.com/detail/cmebbcnocamcolnedgafbkeelejldoga?utm_source=item-share-cp). لمتصفحات Edge وBrave وVivaldi وLibreWolf وFirefox، أو للتثبيت اليدوي، ابنِ وحمّل الامتداد محلياً:
+ثبّت الامتداد من [متجر Chrome](https://chromewebstore.google.com/detail/openkey/cmebbcnocamcolnedgafbkeelejldoga). بعد فتح صفحة الإضافة في متصفح Chrome على الكمبيوتر:
+
+1. اضغط **Add to Chrome (إضافة إلى Chrome)**.
+2. راجع الأذونات المطلوبة ثم اضغط **Add extension (إضافة الامتداد)**.
+3. افتح قائمة **Extensions** (أيقونة القطعة) وثبّت OpenKey في شريط الأدوات اختيارياً عبر **Pin**.
+4. اضغط أيقونة OpenKey في شريط الأدوات لفتح الامتداد.
+
+لمتصفحات Edge وBrave وVivaldi وLibreWolf وFirefox، أو للتثبيت اليدوي، ابنِ وحمّل الامتداد محلياً:
 
 ```bash
 cd openkey_extension

diff --git a/ar/guide/packages.md b/ar/guide/packages.md
@@ -1,6 +1,6 @@
 # الحزم
 
-ثبّت التطبيق الرسمي من [التنزيل](./download) (باينري / متاجر). استضف وابنِ الحزم **المفتوحة** أدناه. الاستخدام اليومي: [استخدام التطبيق](./app). إعداد المتصفح: [امتداد المتصفح](./extension).
+تطبيق OpenKey الرسمي **مفتوح المصدر** ومرخّص برخصة **MIT**؛ الشيفرة المصدرية لتطبيق Flutter ومواصفات البروتوكول متاحة للجميع في [مستودع OpenSelfHosting/OpenKey](https://github.com/OpenSelfHosting/OpenKey)، مع [تعليمات البناء من المصدر](https://github.com/OpenSelfHosting/OpenKey#build-from-source). يمكنك تثبيت النسخة الجاهزة من [صفحة التنزيل](./download). استضف وابنِ الحزم **المفتوحة المصدر** أدناه. الاستخدام اليومي: [استخدام التطبيق](./app). إعداد المتصفح: [امتداد المتصفح](./extension).
 
 مواصفات البروتوكول في [OpenSelfHosting/OpenKey](https://github.com/OpenSelfHosting/OpenKey) (`spec/`). قد تنشر المستودعات تحت [OpenSelfHosting](https://github.com/OpenSelfHosting) الحزم بشكل منفصل.
 

diff --git a/es/guide/extension.md b/es/guide/extension.md
@@ -27,7 +27,14 @@ Los navegadores pueden pedirte confirmar o reasignar el comando en los atajos de
 
 ## Instalar
 
-Instala la extensión de Chrome desde [Chrome Web Store](https://chromewebstore.google.com/detail/cmebbcnocamcolnedgafbkeelejldoga?utm_source=item-share-cp). Para Edge, Brave, Vivaldi, LibreWolf, Firefox o la instalación manual, compila y carga localmente:
+Instala la extensión desde [Chrome Web Store](https://chromewebstore.google.com/detail/openkey/cmebbcnocamcolnedgafbkeelejldoga). Después de abrir la ficha en Chrome para escritorio:
+
+1. Selecciona **Añadir a Chrome**.
+2. Revisa los permisos solicitados y selecciona **Añadir extensión**.
+3. Abre el menú **Extensiones** de Chrome (icono de pieza de puzle) y, si quieres, fija OpenKey en la barra de herramientas.
+4. Selecciona el icono de OpenKey en la barra para abrir la extensión.
+
+Para Edge, Brave, Vivaldi, LibreWolf, Firefox o una instalación manual, compila y carga la extensión localmente:
 
 ```bash
 cd openkey_extension

diff --git a/fr/guide/extension.md b/fr/guide/extension.md
@@ -27,7 +27,14 @@ Les navigateurs peuvent exiger de confirmer ou de remapper la commande sous les
 
 ## Installation
 
-Installez l’extension Chrome depuis le [Chrome Web Store](https://chromewebstore.google.com/detail/cmebbcnocamcolnedgafbkeelejldoga?utm_source=item-share-cp). Pour Edge, Brave, Vivaldi, LibreWolf, Firefox ou une installation manuelle, compilez et chargez l’extension localement :
+Installez l’extension depuis le [Chrome Web Store](https://chromewebstore.google.com/detail/openkey/cmebbcnocamcolnedgafbkeelejldoga). Après avoir ouvert la fiche dans Chrome sur ordinateur :
+
+1. Sélectionnez **Ajouter à Chrome**.
+2. Vérifiez les autorisations demandées, puis sélectionnez **Ajouter l’extension**.
+3. Ouvrez le menu **Extensions** de Chrome (icône en forme de pièce de puzzle) et épinglez éventuellement OpenKey à la barre d’outils.
+4. Sélectionnez l’icône OpenKey dans la barre d’outils pour ouvrir l’extension.
+
+Pour Edge, Brave, Vivaldi, LibreWolf, Firefox ou une installation manuelle, compilez et chargez l’extension localement :
 
 ```bash
 cd openkey_extension

diff --git a/guide/download.md b/guide/download.md
@@ -68,7 +68,7 @@ Official desktop installers are attached to [GitHub Releases](https://github.com
 
 ## Browser extension
 
-MV3 extension for Chrome, Edge, and Firefox. [Install OpenKey from the Chrome Web Store](https://chromewebstore.google.com/detail/cmebbcnocamcolnedgafbkeelejldoga?utm_source=item-share-cp). For Edge, Firefox, or manual installation, build the extension and load the `dist/` folder:
+MV3 extension for Chrome, Edge, and Firefox. [Install OpenKey from the Chrome Web Store](https://chromewebstore.google.com/detail/openkey/cmebbcnocamcolnedgafbkeelejldoga). For Edge, Firefox, or manual installation, build the extension and load the `dist/` folder:
 
 ```bash
 cd openkey_extension

diff --git a/guide/extension.md b/guide/extension.md
@@ -29,7 +29,14 @@ Browsers may require you to confirm or remap the command under extension keyboar
 
 ## Install
 
-Install the Chrome extension from the [Chrome Web Store](https://chromewebstore.google.com/detail/cmebbcnocamcolnedgafbkeelejldoga?utm_source=item-share-cp). For Edge, Brave, Vivaldi, LibreWolf, Firefox, or manual installation, build and load locally:
+Install the Chrome extension from the [Chrome Web Store](https://chromewebstore.google.com/detail/openkey/cmebbcnocamcolnedgafbkeelejldoga). After opening the listing in Chrome:
+
+1. Select **Add to Chrome**.
+2. Review the requested permissions and select **Add extension**.
+3. Open Chrome's **Extensions** menu (puzzle-piece icon) and optionally pin OpenKey to the toolbar.
+4. Select the OpenKey toolbar icon to open the extension.
+
+For Edge, Brave, Vivaldi, LibreWolf, Firefox, or manual installation, build and load locally:
 
 ```bash
 cd openkey_extension

diff --git a/zh/guide/extension.md b/zh/guide/extension.md
@@ -27,7 +27,14 @@
 
 ## 安装
 
-从 [Chrome 网上应用店](https://chromewebstore.google.com/detail/cmebbcnocamcolnedgafbkeelejldoga?utm_source=item-share-cp)安装 Chrome 扩展。对于 Edge、Brave、Vivaldi、LibreWolf、Firefox 或手动安装，请在本地构建并加载扩展：
+从 [Chrome 网上应用店](https://chromewebstore.google.com/detail/openkey/cmebbcnocamcolnedgafbkeelejldoga)安装 Chrome 扩展。在电脑上的 Chrome 中打开页面后：
+
+1. 点击 **添加至 Chrome（Add to Chrome）**。
+2. 查看所需权限，然后点击 **添加扩展程序（Add extension）**。
+3. 打开 Chrome 的 **扩展程序**菜单（拼图图标），可选择将 OpenKey 固定到工具栏。
+4. 点击工具栏中的 OpenKey 图标即可打开扩展。
+
+对于 Edge、Brave、Vivaldi、LibreWolf、Firefox 或手动安装，请在本地构建并加载扩展：
 
 ```bash
 cd openkey_extension