# VoiceType — голосовой набор текста

VoiceType — программа для голосового ввода текста на компьютере. Зажимаете клавишу, говорите в микрофон — текст появляется в любом приложении: браузере, Telegram, Word, 1С и т.д.

---

## Что понадобится

- Компьютер с **Windows 10** или **Windows 11** (64-бит)
- **Микрофон** (встроенный в ноутбук или внешний)
- **Интернет** (для отправки аудио на сервер распознавания)

---

## Установка

### Шаг 1. Скачайте программу

Скачайте файл **VoiceType.UI.exe** по ссылке:

**https://distr.mitok.ru/voicetype/VoiceType.UI.exe**

> Файл весит ~160 МБ. Это нормально — в него встроены все необходимые компоненты, устанавливать ничего дополнительно не нужно.

### Шаг 2. Сохраните в удобное место

Создайте папку и положите туда скачанный файл. Например:

```
C:\Programs\VoiceType\VoiceType.UI.exe
```

Устанавливать программу не нужно — она запускается прямо из exe-файла.

### Шаг 3. Запустите

Дважды кликните по **VoiceType.UI.exe**.

При первом запуске Windows может показать предупреждение «Windows защитил ваш компьютер». Нажмите **«Подробнее»** → **«Выполнить в любом случае»**.

После запуска в области уведомлений (трей, рядом с часами) появится иконка VoiceType — серый кружок с микрофоном.

> Если иконка не видна, нажмите стрелку **▲** в трее, чтобы показать скрытые значки.

### Шаг 4. Введите API Key

1. Дважды кликните по иконке VoiceType в трее — откроется окно настроек
2. В поле **API Key** вставьте ключ:
   ```
   sk-stt-CMCawDvSOSBowL6CUjSKxiHoN29vnafc
   ```
3. Нажмите **«Проверить сервер»** — должно появиться сообщение об успешном подключении
4. Нажмите **«Сохранить»**

---

## Как пользоваться

1. Откройте любое приложение и кликните в текстовое поле (например, строку поиска в браузере, поле ввода в Telegram, ячейку в Excel)
2. **Зажмите клавишу F9** — иконка станет красной (идёт запись)
3. **Говорите** в микрофон чётко и размеренно
4. **Отпустите F9** — иконка станет синей (идёт распознавание)
5. Через 1–2 секунды распознанный текст появится в текстовом поле

### Цвета иконки в трее

| Цвет | Что происходит |
|------|---------------|
| Серый | Готов к работе |
| Красный | Идёт запись с микрофона |
| Синий | Аудио отправлено, ожидание результата |
| Зелёный | Текст успешно вставлен |
| Оранжевый | Произошла ошибка |

---

## Настройки

Чтобы открыть настройки: **дважды кликните** по иконке VoiceType в трее, или кликните **правой кнопкой** → **«Настройки»**.

### Основные параметры

| Параметр | Значение по умолчанию | Описание |
|----------|----------------------|----------|
| **Endpoint URL** | `https://stt.mitok.ru` | Адрес сервера распознавания. Не меняйте без указания администратора |
| **API Key** | `sk-stt-CMCawDvSOSBowL6CUjSKxiHoN29vnafc` | Ключ доступа к серверу распознавания. Скопируйте и вставьте |
| **Горячая клавиша** | F9 | Клавиша для записи (push-to-talk) |
| **Микрофон** | #0 (по умолчанию) | Выберите нужный микрофон из списка |
| **Язык** | ru | Язык распознавания |

### Как сменить горячую клавишу

1. Откройте настройки (двойной клик по иконке в трее)
2. Нажмите кнопку с текущей клавишей (например, «F9»)
3. Нажмите новую клавишу на клавиатуре
4. Нажмите **«Сохранить»**

Рекомендуемые клавиши: **F9**, **F10**, **F8**, **Insert**, **ScrollLock**.

### Проверка подключения к серверу

В настройках нажмите кнопку **«Проверить сервер»**. Если всё в порядке, появится сообщение об успешном подключении.

---

## Ярлык на рабочем столе

Чтобы быстро запускать программу:

1. Кликните правой кнопкой по рабочему столу → **Создать** → **Ярлык**
2. В поле «Расположение» укажите полный путь к exe, например:
   ```
   C:\Programs\VoiceType\VoiceType.UI.exe
   ```
3. Нажмите **«Далее»**, введите имя **VoiceType** → **«Готово»**

---

## Автозапуск с Windows

Если хотите, чтобы VoiceType запускался автоматически при включении компьютера:

1. Откройте настройки (двойной клик по иконке в трее)
2. Поставьте галочку **«Автозапуск с Windows»**
3. Нажмите **«Сохранить»**

---

## Где работает

Текст вставляется в любое приложение, в котором можно нажать Ctrl+V:

- Браузеры (Chrome, Firefox, Edge) — поисковая строка, формы, Google Docs
- Telegram Desktop
- Word, Excel, PowerPoint
- Notepad, Notepad++
- VS Code
- Формы 1С, CRM и ERP-систем
- Любые мессенджеры

> **Ограничение:** программа не может вставлять текст в приложения, запущенные от имени администратора.

---

## Решение проблем

| Проблема | Что делать |
|----------|-----------|
| Иконка не появилась в трее | Нажмите стрелку **▲** рядом с часами. Если иконки нет — попробуйте запустить exe ещё раз |
| «STT-сервер недоступен» | Проверьте интернет. Откройте в браузере `https://stt.mitok.ru/health` — должен появиться текст со словом «ok» |
| F9 не реагирует | Убедитесь, что VoiceType запущен (иконка в трее). Если другая программа использует F9 — смените горячую клавишу в настройках |
| «Микрофоны не найдены» | Подключите микрофон. Проверьте, что он работает в настройках Windows: **Параметры** → **Система** → **Звук** → **Ввод** |
| Текст не вставляется | Убедитесь, что нужное текстовое поле в фокусе (курсор мигает). Попробуйте в настройках сменить режим вставки на **«ClipboardPaste»** |
| Текст вставляется не туда | Перед тем как отпустить F9, убедитесь, что курсор стоит в нужном поле |
| Windows заблокировал запуск | Нажмите «Подробнее» → «Выполнить в любом случае» |

### Логи для диагностики

Если проблема повторяется, отправьте файл лога администратору:

```
%APPDATA%\VoiceType\logs\
```

Чтобы открыть эту папку: нажмите **Win+R**, вставьте путь выше и нажмите Enter.

---

## Поддержка

По вопросам работы VoiceType обращайтесь к вашему менеджеру или пишите на support@mitok.ru.