diff --git a/.documentation/addon description/ru/description.txt b/.documentation/addon description/ru/description.txt
new file mode 100644
index 0000000..6612a33
--- /dev/null
+++ b/.documentation/addon description/ru/description.txt
@@ -0,0 +1,26 @@
+Это дополнение позволяет пользователям запретить веб-сайтам использовать API Javascript canvas для считывания цифровых отпечатков. Пользователи могут заблокировать API canvas полностью на некоторых или на всех веб-сайтах (возможно некоторые сайты перестанут корректно работать) или просто заблокировать или подделать его API для считывания цифровых отпечатков. Более подробную информацию о считывание цифровых отпечатков можно найти по адресу http://www.browserleaks.com/canvas.
+
+Эсть разные режимы блокирования:
+
+- блокировать readout(считывание) API: Все сайты, не включенные в белый или черный список, могут использовать API canvas для отображения чего-либо на странице, но API readout(считывания) не может возвращать значения на сайт. Это может сломать сайты, такие как Google Maps.
+- подделывать readout(считывание) API: Настройка по умолчанию, и моя любимая! Все сайты, не включенные в белый или черный список, могут использовать API canvas для отображения чего-либо на странице, но API считывания вынужден возвращать новое случайное значение при каждом вызове.
+- подделывать для input(ввод): При отображении текста рисованные пиксели слегка изменяются. Это делает обнаружение дополнения более сложным, но менее безопасным. На WebGL-холсте поведение идентично подделывать "readout(считывания) API"..
+- попросить разрешения для readout(считывание) API: Все сайты, не включенные в белый или черный список, могут использовать API canvas для отображения чего-либо на странице, но при каждом вызове сайта у пользователя будет запрашиваться разрешение на использование API считывания(readout).
+- блокировать все: Игнорировать все списки и блокировать API canvas на всех сайтах.
+- разрешить только белый список: API canvas могут использовать только сайты из белого списка.
+- попросить разрешения: Если сайт не указан в белом или черном списке, пользователю будет предложено разрешить ему использовать API canvas при каждом вызове.
+- блокировать только черный список: Блокирует API canvas только для сайтов из черного списка.
+- разрешить все: Игнорировать все списки и разрешить canvas API на всех сайтах.
+
+
+Защищенные API от "снятия цифровых отпечатков":
+
+ - canvas 2d
+ - webGL
+ - audio
+ - history
+ - window (disabled by default)
+ - DOMRect
+
+
+Сообщите о проблемах и пожеланиях на странице https://github.com/kkapsner/CanvasBlocker/issues.
\ No newline at end of file
diff --git a/_locales/ru/messages.json b/_locales/ru/messages.json
new file mode 100644
index 0000000..c8474b2
--- /dev/null
+++ b/_locales/ru/messages.json
@@ -0,0 +1,1217 @@
+{
+ "addon_title": {
+ "message": "CanvasBlocker",
+ "description": ""
+ },
+ "addon_description": {
+ "message": "Изменяет некоторые API JS для предотвращения снятия цифровых отпечатков.",
+ "description": ""
+ },
+
+ "browserAction_title_default": {
+ "message": "CanvasBlocker",
+ "description": ""
+ },
+ "browserAction_title_notified": {
+ "message": " \n\nзащита успешна для:",
+ "description": ""
+ },
+ "browserAction_title_whitelisted": {
+ "message": " (API, белый список для {url})",
+ "description": ""
+ },
+ "browserAction_title_protectedAPIs": {
+ "message": "\n \u00B7 {api}",
+ "description": ""
+ },
+
+ "more": {
+ "message": "еще",
+ "description": ""
+ },
+ "less": {
+ "message": "меньше",
+ "description": ""
+ },
+ "pleaseWait": {
+ "message": "Подождите...",
+ "description": ""
+ },
+ "search": {
+ "message": "Поиск",
+ "description": ""
+ },
+
+ "input": {
+ "message": "input (ввод)",
+ "description": ""
+ },
+
+ "readout": {
+ "message": "readout (считывание)",
+ "description": ""
+ },
+
+ "options": {
+ "message": "Настройки",
+ "description": ""
+ },
+ "optionsIntroduction": {
+ "message": "На этой странице вы можете настроить параметры CanvasBlocker.",
+ "description": ""
+ },
+ "installNotice": {
+ "message": "CanvasBlocker установлен. Если вы хотите иметь доступ к этой странице в будущем, добавьте ее в закладки.",
+ "description": ""
+ },
+ "updateNotice": {
+ "message": "CanvasBlocker обновлен. Если вы хотите иметь доступ к этой странице в будущем и еще не добавили ее в закладки, добавьте ее в закладки.",
+ "description": ""
+ },
+ "dontShowOptionsOnUpdate":{
+ "message": "Не показывать снова после обновления.",
+ "description": ""
+ },
+ "openInTab": {
+ "message": "Открыть в отдельной вкладке",
+ "description": ""
+ },
+
+ "section_asking": {
+ "message": "Asking (спрашивать)",
+ "description": ""
+ },
+ "section_faking": {
+ "message": "Фейковые данные",
+ "description": ""
+ },
+ "section_notifications": {
+ "message": "Уведомления",
+ "description": ""
+ },
+ "section_lists": {
+ "message": "Списки",
+ "description": ""
+ },
+ "section_misc": {
+ "message": "Прочие",
+ "description": ""
+ },
+ "section_settings": {
+ "message": "Настройки",
+ "description": ""
+ },
+ "section_canvas-api":{
+ "message": "Canvas API",
+ "description": ""
+ },
+ "section_audio-api":{
+ "message": "Audio API",
+ "description": ""
+ },
+ "section_history-api":{
+ "message": "History API",
+ "description": ""
+ },
+ "section_window-api":{
+ "message": "Window API",
+ "description": ""
+ },
+ "section_DOMRect-api":{
+ "message": "DOMRect API",
+ "description": ""
+ },
+
+ "displayAdvancedSettings_title": {
+ "message": "Экспертный режим",
+ "description": ""
+ },
+ "displayAdvancedSettings_description": {
+ "message": "Отображение дополнительных параметров.",
+ "description": ""
+ },
+
+ "displayDescriptions_title": {
+ "message": "Отображать описания",
+ "description": ""
+ },
+ "displayDescriptions_description": {
+ "message": "Отображает описания настроек.",
+ "description": ""
+ },
+
+ "hideSetting": {
+ "message": "Нажмите здесь, чтобы скрыть эту настройку.",
+ "description": ""
+ },
+
+ "displayHiddenSettings_title": {
+ "message": "Отобразить скрытые настройки",
+ "description": ""
+ },
+ "displayHiddenSettings_description": {
+ "message": "Активируйте, чтобы отобразить скрытые настройки.",
+ "description": ""
+ },
+
+ "askForInvisiblePermission": {
+ "message": "Вы хотите разрешить невидимый