diff --git a/addon/doc/ru/readme.md b/addon/doc/ru/readme.md
new file mode 100644
index 0000000..560922e
--- /dev/null
+++ b/addon/doc/ru/readme.md
@@ -0,0 +1,35 @@
+# Поиск наушников #
+Это дополнение имеет два сценария, оно воспроизводит  звуковой сигнал в левом или в правом наушнике, что может помочь вам найти ваши bluetooth наушники. Звуковой сигнал будет воспроизводиться в течение 5 минут. Если вам нужно остановить сигнал, нажмите любой из назначенных жестов. Если вам нужно больше времени, выполните нужный сценарий дважды.
+
+Copyright (C) 2023 David CM <dhf360@gmail.com>.
+
+Этот пакет распространяется на условиях Стандартной общественной лицензии GNU, версия 2 или более поздняя.
+
+## Загрузить.
+ Последняя версия доступна для загрузки [ по этой ссылке](https://davidacm.github.io/getlatest/gh/davidacm/NVDA-HeadphoneFinder/?index=1)
+
+## Использование
+
+* Чтобы найти левый наушник, нажмите alt + control + nvda + j.
+* Чтобы найти правый наушник, нажмите alt + control + nvda + k.
+* Звуковой сигнал будет воспроизводиться в течение 5 минут. Чтобы остановить воспроизведение сигнала, выполните любой из сценариев,ещё раз нажав на клавишу для левого или правого наушников.
+* Если звук прекратился, а вы ещё не нашли свой наушник, нажмите нужную клавишу дважды.
+
+## Требования
+  Вам необходима NVDA 2018.2 или более поздняя версия.
+
+## Установка
+  Просто установите его как дополнение к NVDA.
+
+## вклад, отчёты и пожертвования
+
+Если вам нравится мой проект или это программное обеспечение полезно для вас в повседневной жизни, и вы хотели бы внести свой вклад, вы можете сделать пожертвование следующими способами:
+
+* [PayPal.](https://paypal.me/davicm)
+* [Ko-fi.](https://ko-fi.com/davidacm)
+* [криптовалюты и другие способы.](https://davidacm.github.io/donations/)
+
+Если вы хотите исправить ошибки, сообщить о проблемах или новых возможностях, вы можете связаться со мной по адресу: <dhf360@gmail.com>.
+
+  Или в github-репозитории этого дополнения
+
diff --git a/addon/locale/ru/LC_MESSAGES/nvda_.po b/addon/locale/ru/LC_MESSAGES/nvda_.po
new file mode 100644
index 0000000..6f54292
--- /dev/null
+++ b/addon/locale/ru/LC_MESSAGES/nvda_.po
@@ -0,0 +1,47 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the 'HeadphoneFinder' package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: 'HeadphoneFinder' '0.1'\n"
+"Report-Msgid-Bugs-To: 'nvda-translations@freelists.org'\n"
+"POT-Creation-Date: 2023-03-14 10:59+0200\n"
+"PO-Revision-Date: 2024-03-14 10:12+0300\n"
+"Last-Translator: Danil Kostenkov <danilkostenkov38@gmail.com>\n"
+"Language-Team: \n"
+"Language: ru_RU\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
+"n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2);\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#. Translators: script category for headphone finder add-on gestures
+#. Add-on summary, usually the user visible name of the addon.
+#. Translators: Summary for this add-on to be shown on installation and add-on information.
+#: addon\globalPlugins\headphoneFinder.py:15 buildVars.py:17
+msgid "Headphone Finder"
+msgstr "Поиск наушников"
+
+#. Translators: plays a tone at the left.
+#: addon\globalPlugins\headphoneFinder.py:31
+msgid "plays a tone at the left speaker."
+msgstr "воспроизводит звуковой  сигнал в левом наушнике."
+
+#. Translators: plays a tone at the right.
+#: addon\globalPlugins\headphoneFinder.py:38
+msgid "plays a tone at the right speaker."
+msgstr "воспроизводит звуковой  сигнал в правом наушнике."
+
+#. Add-on description
+#. Translators: Long description to be shown for this add-on on add-on information from add-ons manager
+#: buildVars.py:20
+msgid ""
+"This add-on has two scripts, to beep to the left or the right, this can help "
+"you to find your bluetooth headphone."
+msgstr ""
+"Это дополнение имеет два сценария, оно воспроизводит звуковой сигнал в левом "
+"или в правом наушнике, что может помочь вам найти ваши bluetooth-наушники."