Документация

Всё, что нужно знать, чтобы записывать созвоны и получать из них текст. Если чего-то не хватает, напиши в issues.

Установка

Нужно: Mac на Apple Silicon (M1 и новее), macOS 15 Sequoia или новее, 2-5 ГБ свободного места. Для саммари и поиска проектов дополнительно Claude Code, Codex CLI или Cursor CLI, это необязательно.

1. Скачай Sozvon.dmg, открой и перетащи Sozvon в «Программы». Или через Homebrew: brew install --cask able1991/sozvon/sozvon.
2. Запусти. Мастер спросит, как тебя подписывать в расшифровке, на каких языках звонки, какую модель распознавания поставить и кто будет делать саммари.
3. Мастер сам поставит движок: Python, модель и разбивку по голосам. Это 5-10 минут и 1-4 ГБ в зависимости от модели. Регистрации и токены не нужны.
4. Разреши доступ, когда macOS спросит: «Микрофон» (твой голос), «Запись экрана» и «Запись системного аудио» (голоса собеседников, включая FaceTime). Кнопки для каждого разрешения есть в мастере и в Настройках → Основные → Разрешения. Видео не записывается, только звук. Потом мастер делает пробную запись на три секунды и проверяет, что запись правда работает и слышен ли звук компьютера. Пока мастер не пройден, остальное меню Sozvon недоступно. Доступ к «Напоминаниям» Sozvon спросит, только когда первый раз нажмёшь «В Напоминания».

Если разрешение случайно отклонено, включи его в «Системных настройках», раздел «Конфиденциальность и безопасность», и перезапусти Sozvon.

Обновления приходят сами. Раз в день Sozvon проверяет новую версию, скачивает её в фоне и ставит, когда ничего не происходит: нет записи, расшифровки, звонка и открытых окон. Перезапуск занимает пару секунд, потом приходит уведомление со ссылкой на список изменений. Каждое обновление проверяется по подписи разработчика и ключу Sozvon, звонки и настройки остаются на месте. В Настройках → О программе можно выключить «Обновлять автоматически»: тогда в меню появится «Доступна версия…», и ставить будешь сам. Версии до 0.1.2 обновлять не умели: их один раз обнови вручную, скачав DMG.

Запись звонка

Начать запись можно двумя способами:

• Плавающая панель. Висит поверх всех окон, даже над Zoom на весь экран. Нажми на неё, чтобы начать запись. Панель можно перетаскивать: простое перетаскивание запись не запускает.
• Значок в строке меню. Пункт «Записать», во время записи «Остановить».

«Идёт звонок в Zoom. Записать?»

Когда Zoom, Telegram, браузер (Google Meet и другие звонки в браузере), TrueConf, FaceTime, Slack, Teams или другое приложение для звонков держит микрофон дольше 5 секунд, панель спрашивает «Идёт звонок в Zoom. Записать?». «Записать» начинает запись, как обычная кнопка. «Не сейчас» убирает вопрос, пока это приложение не отпустит микрофон, то есть до конца звонка. Если плавающая панель выключена, тот же вопрос с теми же кнопками приходит уведомлением.

По умолчанию Sozvon сам ничего не записывает: запись начинается, только когда ты нажмёшь «Записать». Отдельных разрешений не нужно: Sozvon видит только, какое приложение сейчас пользуется микрофоном, но не сам звук, и ничего никуда не отправляет. Диктовка, Siri и незнакомые приложения вопрос не вызывают, во время записи его тоже нет.

Записывать сам. В Настройках → Основные → «Когда начинается звонок» можно выбрать «Спрашивать» (по умолчанию), «Записывать сам» или «Ничего не делать». При «Записывать сам» панель показывает «Звонок в Zoom · запись через 10 с» с кнопками «Записать сейчас» и «Не записывать», и, если ничего не нажать, запись начинается сама. Согласие собеседников на запись на тебе.

Останавливать после звонка. Если включить эту галочку, запись останавливается сама, когда ни одно приложение для звонков не держит микрофон 30 секунд: панель показывает «Стоп через 30 с» и кнопку «Продолжить»: с ней запись идёт, пока не остановишь сам. Короткие паузы, когда Zoom или Telegram переподключается, запись не обрывают, и пока собеседника слышно, отсчёт не идёт. Запись встречи в комнате, без приложения для звонков, сама не останавливается. Отсчёты до автостарта и автостопа видно всегда, даже если плавающая панель выключена.

Размышления. Нажми капсулу и думай вслух. В конце в окне выбери «Размышления»: Sozvon сам предложит этот вариант, если не было звонка и собеседников не слышно. Вместо саммари звонка получишь главную мысль, анализ, что сделать и открытые вопросы. Размышления лежат в том же списке, что и звонки, с отметкой и своим фильтром, их можно привязать к проекту, а агенты находят их через MCP.

Записи с телефона. В Настройках → Основные → «Записи с телефона» выбери папку, например в iCloud Drive. На iPhone: Диктофон, «Поделиться», «Сохранить в Файлы», эта папка. Новая запись сама импортируется и расшифруется как размышления, а файл перейдёт в подпапку Imported; то, что прочитать не удалось, окажется в Failed. Эта папка только забирает готовые файлы.

Запись одним нажатием на iPhone. Добавь команду Think Out Loud и запусти её один раз: она создаст в iCloud Drive папку Sozvon. Выбери эту папку в настройках выше. Дальше команда сразу начинает запись, а по кнопке «Стоп» сохраняет файл в эту папку. Поставь её на экран «Домой» или на кнопку действия. Запись через команду может прерваться, если заблокировать телефон: для длинных записей используй Диктофон.

Напоминание о записи. «Напоминать сказать о записи» в Настройках покажет на капсуле на несколько секунд, что собеседников стоит предупредить.

Кто был на звонке. Если у тебя сохранены голоса других людей, во время записи Sozvon с низким приоритетом сравнивает речь собеседников с ними, прямо на Маке. Окно «О чём был звонок?» открывается с проектом и участниками из Календаря и по голосам. Если всё сходится, окно само продолжит через 10 секунд: измени что-нибудь или нажми «Подождать», чтобы остановить. Выключить: Настройки → Основные → «Сразу расшифровывать, если всё понятно».

Во время записи

Во время записи панель показывает таймер и живую волну двух голосов: твоего микрофона и звука компьютера. Если микрофон молчит слишком долго, панель предупредит «Тебя не слышно»: проверь, что выбран нужный микрофон и он не выключен в самом звонке. Sozvon также предупредит, если громкость входа в системе ниже 50% (её часто убавляют звонки в браузере) или твой голос три минуты почти не слышен.

Без наушников. Через динамики микрофон слышит и собеседников. Перед распознаванием Sozvon убирает это эхо из твоей дорожки прямо на Mac: фильтр сверяется с дорожкой собеседников и следит, как сдвигается задержка, а небольшая нейросеть (11 МБ, скачивается один раз, примерно 2 минуты на час звонка) убирает остаток, только пока говорят собеседники. Пока собеседники молчат, твой голос и голоса людей рядом не меняются совсем. Пока они говорят, голоса рядом остаются, но голос намного тише динамиков может стать тише. Очень тихую дорожку микрофона Sozvon делает громче. Очищенный голос сохраняется рядом, в mic.clean.m4a, и плеер играет его, так что ты слышишь себя без эха. Исходный mic.m4a не меняется и нужен для повторной расшифровки. С наушниками всё равно лучше всего.

Sozvon не подключается к звонку и не добавляет ботов. Он пишет то, что слышит твой Mac, поэтому работает с любым приложением: Zoom, Google Meet, FaceTime, Telegram, TrueConf, браузер. Предупреждать собеседников о записи твоя ответственность, в разных странах свои правила.

Если выйти из Sozvon во время записи, он сначала аккуратно допишет файлы. Если выйти во время расшифровки, спросит, прервать ли её.

После звонка

После «Стоп» появляется окно «О чём был звонок?». Все поля необязательные, но они заметно улучшают результат:

Кнопка «Расшифровать» ставит звонок в очередь. Движок расшифровывает по одному звонку за раз, остальные ждут с отметкой «В очереди» и не начинаются во время записи или звонка; очередь переживает перезапуск, а звонок можно убрать из неё в окне «Звонки». «Позже» закрывает окно и запоминает то, что ты уже ввёл. «Не расшифровывать» просто сохраняет запись, расшифровку можно запустить потом из окна «Звонки».

«Позже»

Если сразу начинается следующий звонок, нажми «Позже» или просто закрой окно. Звонок получает отметку «Ждёт описания» в окне «Звонки», а в меню Sozvon появляется пункт «Ждут описания: N»: он открывает то же окно для самого старого такого звонка. В окне «Звонки» то же делает «Расшифровать…».

Если Sozvon 10 минут ничего не записывает, придёт напоминание с кнопкой «Описать», не чаще раза в час для одного звонка. Во время записи напоминаний нет, и пункт меню скрыт. Звонок ждёт, пока ты его не расшифруешь или не нажмёшь «Не расшифровывать».

Что происходит дальше: дорожки выравниваются по времени, из микрофона убирается эхо собеседников, речь распознаётся с подсказкой из проекта, голоса собеседников разводятся, знакомые голоса подписываются сами, остальных помощник подписывает по смыслу разговора и пишет саммари. Час звонка на Whisper Turbo обрабатывается за несколько минут. Когда всё готово, приходит уведомление.

Окно «Звонки»

Открывается из меню. Слева звонки по дням, справа саммари и расшифровка выбранного.

• Поиск ищет по дате, теме, проекту, участникам и по тексту саммари и расшифровок.
• Из меню звонка: открыть папку в Finder, расшифровать заново (например, с другой моделью или исправленными участниками), переместить в корзину.
• Звонок, который сейчас записывается, отмечен «Идёт запись», его нельзя удалить или расшифровать.
• Над саммари карточка с его заметками. «Поделиться» на панели инструментов копирует звонок, открывает расшифровку и отправляет задачи в Напоминания, а «Ещё» расшифровывает заново, показывает папку в Finder, журнал и удаляет звонок.
• «Последняя расшифровка» в меню и уведомление «Расшифровка готова» открывают звонок здесь.
• Звонок, скачанный со своего сервера, приходит со звуком, если его туда отправили: плеер работает. Без звука его можно читать и искать, но не слушать и не расшифровать заново.

Слушать звонок

Внизу окна плеер, на обеих вкладках: «Слушать» и «Пауза», назад и вперёд на 15 секунд, ползунок и скорость 1×, 1,5× или 2×. Нажми на любую реплику, и запись заиграет с этого места. Текущая реплика подсвечивается, а окно само прокручивается за ней. Обе дорожки, твой микрофон и собеседники, звучат вместе и совпадают с таймкодами. Как только звонок расшифрован, плеер играет его копию с выровненной громкостью: громкие места заметно тише, тихая речь поднимается не больше чем на 6 дБ, а паузы остаются примерно такими же тихими. Очень тихую дорожку Sozvon сначала делает громче, поэтому она может стать больше чем на 6 дБ громче записи. Каждая сторона звучит в полной полосе, кроме микрофона на звонке, где убрано эхо: там очищенный звук 16 кГц. Копия записывается примерно 2 минуты на час звонка, уже после расшифровки и саммари. Она занимает около 33 МБ на час звонка, расшифровка и образцы голосов её не используют.

Пока у звонка есть звук, щелчок по реплике включает её, а не выделяет текст. Чтобы скопировать реплику, выбери «Копировать» в её контекстном меню, там же «Слушать отсюда».

Исправить расшифровку

В контекстном меню реплики:

• «Переименовать говорящего…» открывает окно «Кто это говорит?». Под полем подсказки имён: другие говорящие, участники звонка и люди проекта. С галочкой «Во всей расшифровке» новое имя получают все реплики этого человека, список участников в шапке и участники звонка; без неё к этому человеку уходит только реплика, по которой ты щёлкнул. Если такое имя уже говорит в звонке, Sozvon предложит «Поменять местами» (помощник перепутал двух людей) или «Объединить» (это один человек). Когда ты точно называешь собеседника, Sozvon запоминает его голос для проекта.
• «Исправить слово…»: выдели в реплике неверно услышанное слово или фразу и напиши, как правильно. Заменяется только целое слово и только в той реплике, по которой ты щёлкнул. Потом Sozvon спросит «Запоминать для проекта «Acme»?» (или «Запоминать для всех звонков?», если у звонка нет проекта). «Запоминать» добавляет автозамену, и в новых расшифровках это слово сразу будет написано правильно.

Правки меняют transcript.md и transcript.txt. Саммари само не переписывается: над ним появляется полоса «Расшифровку правили после саммари» с кнопкой «Обновить саммари», тот же пункт есть в меню «Ещё». Переписывается только саммари, заново ничего не расшифровывается. Пока звонок записывается или расшифровывается, править его нельзя. Если есть свой сервер, исправленный звонок уходит туда заново.

Если помощник не смог написать саммари, уведомление говорит «Готово, но саммари не получилось» с причиной и кнопкой «Обновить саммари», а у звонка в списке появляется отметка «Без саммари».

Импортировать запись

Старую запись можно расшифровать так же, как новую: перетащи файл в список звонков или нажми «Импортировать запись…» в панели инструментов. Подходят m4a, mp3, wav, aac, flac, а также видео mp4 и mov (берётся только звук). webm, ogg, opus, oga и mkv Sozvon не принимает, их сначала нужно сконвертировать в m4a, mp3 или wav.

Sozvon создаёт новую папку звонка с датой записи из метаданных файла (если её нет, с датой самого файла), сохраняет звук как system.m4a и открывает «О чём был звонок?», как после записи. Твоего микрофона отдельной дорожкой здесь нет, поэтому все голоса, включая твой, разводятся по голосам и подписываются по смыслу. Если выбрать несколько файлов, они импортируются по очереди, окно откроется для последнего, а остальные ждут в списке с кнопкой «Расшифровать…».

В Напоминания

Пункт «В Напоминания» в меню «Поделиться» на панели инструментов звонка есть, когда в саммари есть задачи или у звонка есть заметки. В окне уже отмечены твои незакрытые задачи (по имени из настроек или «я», «вы»). Чужие задачи и заметки можно отметить самому, чужая задача попадёт в Напоминания с именем: «Анна: отправить договор».

Срок ставится, только если день назван ясно: «завтра», «в пятницу», «10 ноября» считаются от даты звонка. Если сказано расплывчато, срока не будет: лучше без даты, чем с неверной. «Список»: «По умолчанию» или «Sozvon» (такой список Sozvon создаст сам). В каждом напоминании тема и дата звонка и ссылка на его саммари.

Доступ к «Напоминаниям» macOS спросит при первом добавлении. Задачи попадают в приложение «Напоминания» на этом Mac, Sozvon ничего никуда не отправляет. Если Напоминания на этом Mac синхронизируются через iCloud, дальше их синхронизирует Apple.

Отметить важное

Во время записи на панели есть звёздочка. Нажми её, пункт «Отметить важное» в меню или ⌃⌥I в любом приложении, даже в Zoom на весь экран, и Sozvon запомнит этот момент. Счётчик рядом со звёздочкой показывает, сколько моментов отмечено. Клавиши работают только пока идёт запись.

В расшифровке отмеченная реплика получает звёздочку и жёлтую подсветку, а в саммари появляется раздел «Важные моменты»: время и что там сказали или решили.

Если пропал звук

Панель сразу пишет «Тебя не слышно» или «Их не слышно», если звук пропал. Если микрофон выдаёт только цифровую тишину (отвалились наушники, сменилось устройство) или от собеседников две минуты нет звука, Sozvon сам заново подхватывает этот источник, не прерывая вторую дорожку. Если и через полминуты тихо, придёт уведомление с кнопкой «Настройки звука». Обычная тишина в комнате тревогу не поднимает.

Тема и участники из Календаря

После «Стоп» окно «О чём был звонок?» заполняется по встрече в Календаре, которая шла в момент записи: тема из названия встречи, участники из приглашённых, проект, если название или люди совпадают с одним из проектов. Встреча со ссылкой на Zoom, Meet или Teams важнее обеда в то же время. Заполняются только пустые поля: что ты ввёл во время записи, не меняется.

Доступ к Календарю macOS спросит при первом таком окне. Календарь читается только на этом Mac. Выключить: «Настройки», «Основные», «Название и участники из Календаря».

Автоудаление аудио

«Настройки», «Основные», «Автоудаление аудио»: никогда (по умолчанию), через неделю, 15, 30 или 60 дней. У расшифрованных звонков старше этого срока удаляется только звук, расшифровка, саммари и заметки остаются. У таких звонков пропадают плеер и «Расшифровать заново». Со своего сервера звук этих звонков тоже удаляется. Если после смены настройки звук удалится сразу, Sozvon сначала покажет, у скольких звонков и сколько места освободится.

Заметки

К звонку можно оставить заметку: решение, договорённость, уточнение на потом. Свою добавляешь кнопкой «Добавить» в карточке «Заметки» в окне «Звонки», а удаляешь кнопкой «⋯» рядом с заметкой. Claude Code, Codex и Cursor оставляют заметки инструментом add_note, а Claude и ChatGPT на телефоне делают то же через свой сервер.

• У каждой заметки видно дату и кто её добавил: ты, Claude, Codex, Cursor или ChatGPT.
• Заметку нельзя изменить, но можно удалить: кнопка «⋯» рядом с ней, пункт «Удалить заметку». Ассистент тоже может удалить заметку, если попросишь (delete_note).
• Заметки находят поиск в окне «Звонки», search_calls и get_call.
• Заметки лежат в call.json звонка и синхронизируются со своим сервером в обе стороны. Удалённая заметка не вернётся с другого Mac.
• До 4000 символов в заметке и до 200 заметок на звонок.

Проекты

Проект хранит то, что помогает распознаванию в звонках с одним клиентом:

• Люди. Имена участников, подсказываются в окне после звонка и помогают подписать говорящих.
• Термины. Названия продуктов, компаний и жаргон. Whisper получает их как подсказку и пишет правильно.
• Автозамены. Что модель упорно слышит неправильно и как это исправить: «экма» на «Acme».

Проекты редактируются в окне «Проекты» из меню. Люди с размеченных звонков добавляются в проект сами.

Найти проекты автоматически

Кнопка «Найти проекты» просит Claude Code, Codex или Cursor просмотреть твои сессии и заметки и предложить проекты с людьми и терминами. Ты выбираешь, что сохранить. Помощник получает названия папок проектов, заметки памяти и ответы открытых сессий, это уходит в Anthropic, OpenAI или Cursor и выбранной там модели. Claude технически ограничен папкой ~/.claude. У Codex песочница запрещает запись, но не чтение: ограничение папкой ~/.codex только в инструкции. Cursor работает в режиме только для чтения (--mode ask) и смотрит прошлые чаты в ~/.cursor/projects; ограничение этой папкой тоже только в инструкции.

Голоса

Sozvon может узнавать людей по голосу, а не только угадывать имена по смыслу разговора. Так два Александра в одном проекте больше не путаются.

• Твой голос. «Настройки», «Основные», «Мой голос» под именем: «Записать…», прочитай вслух простой текст на экране, 20 секунд. Текст на языке звонков, а не интерфейса; если языков несколько, сверху выбор. Потом в меню «Образец»: «Добавить образец…» дополняет отпечаток ещё одной записью, например на втором языке звонков, а «Перезаписать…» записывает заново.
• Подтвердить голоса. Если после расшифровки все подписаны верно, над саммари и расшифровкой есть строка «Подписи верные? Запомни голоса» с кнопкой «Запомнить голоса». Для одного человека: правый клик по его реплике, «Запомнить голос». У участников с сохранённым голосом в шапке звонка стоит зелёная галочка.
• Голоса собеседников. Когда ты называешь собеседника в звонке («Переименовать говорящего…» или «Поменять местами»), Sozvon сохраняет отпечаток его голоса для проекта. В следующих звонках этого проекта такие голоса подписываются сами, а помощник называет только остальных.
• Рядом с тобой. Если твой голос сохранён, а у твоего микрофона кто-то ещё говорит хотя бы 15 секунд, его реплики подписываются его сохранённым именем или отдельным «Собеседником», а не твоим именем. Без сохранённого голоса весь микрофон подписан тобой.
• Кто сохранён. В окне «Проекты» видно, у кого из людей проекта есть голос, там же его можно удалить. «Настройки», «Основные», «Голоса», «Показать…» открывает список всех сохранённых голосов: чей, в каком проекте, сколько речи и когда сохранён. Любой можно удалить, там же «Удалить все…».

Отпечатки голосов относятся к биометрическим данным. Они хранятся на этом Mac и, если включено «Отправлять отпечатки голосов», на твоём сервере в твоём аккаунте Cloudflare, больше нигде. Claude и ChatGPT их не видят. Удаление голоса удаляет его везде: на этом Mac, на сервере и на других Mac.

Модели распознавания

Модель меняется в «Настройки», вкладка «Распознавание». Новая модель скачивается один раз. Разбивка по голосам (pyannote, 31 МБ) ставится вместе с приложением для любой модели.

Несколько языков. В «Языках звонков» можно отметить несколько: язык определяется для каждой дорожки. Если собеседники переходят с языка на язык посреди разговора, включи «Язык может меняться посреди речи», тогда язык определяется для каждой фразы, это медленнее на 20-30%.

Саммари

Саммари пишется на языке разговора: коротко о звонке, решения, задачи с исполнителями, открытые вопросы. Его делает помощник, который уже стоит у тебя:

• Claude Code по твоей подписке, по умолчанию модель Sonnet.
• Codex CLI по твоей подписке OpenAI.
• Cursor CLI (cursor-agent) по твоей подписке Cursor, с моделью, выбранной в Cursor.
• Только локально: без саммари и подписи имён, текст расшифровки никуда не уходит.

Помощник выбирается в «Настройки», вкладка «Ассистенты». Если саммари не получилось (нет сети, кончился лимит), расшифровка всё равно сохраняется.

Claude Code, Codex и Cursor (MCP)

Sozvon может отдавать звонки твоему ассистенту: «что решили с Acme на прошлой неделе?», «найди, где обсуждали SLA». Пока Sozvon запущен, он держит один общий MCP-сервер на 127.0.0.1:47816 для всех сессий, около 40 МБ памяти. Сервер доступен только с этого Mac и требует пароль (bearer-токен).

Подключить

«Настройки», вкладка «Ассистенты», кнопка «Подключить» рядом с нужным ассистентом. Это всё: в новой сессии Claude Code, Codex или Cursor звонки уже видны. «Отключить» убирает Sozvon из настроек ассистента.

Звонков ещё нет? Там же «Демо-звонки», «Добавить»: в папке появится несколько вымышленных звонков с расшифровкой и саммари, без звука, и ассистента можно сразу спросить про них. В списке они с пометкой «Демо», на твой сервер не уходят, «Убрать» отправляет в Корзину только их.

Что происходит под капотом

Один сервер на всех. MCP-сервер запускает само приложение Sozvon, а не каждая сессия ассистента. Если бы каждая сессия поднимала свою копию, десять открытых сессий держали бы десять Python-процессов. Общий сервер занимает около 40 МБ, ассистенты подключаются к нему по адресу http://127.0.0.1:47816/mcp. Сервер живёт, пока запущен Sozvon, и завершается вместе с ним.

Зачем пароль. Адрес 127.0.0.1 недоступен из сети, но на самом Mac к нему может обратиться любая программа: приложение из App Store в песочнице (ему нельзя читать ~/Documents, а ходить на localhost можно), процессы других пользователей этого Mac. Без пароля такая программа прочитала бы все расшифровки, а через инструмент transcribe заставила бы Sozvon прочитать любой твой файл. Поэтому при первом запуске Sozvon создаёт случайный пароль (32 байта) в ~/Library/Application Support/Sozvon/.mcp-token с правами только для тебя, и сервер отвечает лишь на запросы с ним. Заодно сервер проверяет заголовки Host и Origin, чтобы до него не добрался сайт в браузере.

Что делает кнопка «Подключить». Для Claude Code она выполняет

claude mcp add --scope user --transport http sozvon http://127.0.0.1:47816/mcp \
  --header "Authorization: Bearer $(cat ~/Library/Application\ Support/Sozvon/.mcp-token)"

Для Codex выполняет codex mcp add sozvon --url http://127.0.0.1:47816/mcp и дописывает пароль в секцию [mcp_servers.sozvon] файла ~/.codex/config.toml:

http_headers = { "Authorization" = "Bearer <пароль>" }

У Cursor нет команды mcp add, поэтому Sozvon сам дописывает запись первой в "mcpServers" файла ~/.cursor/mcp.json. Комментарии и другие серверы в файле остаются как были. Этот же файл читают и приложение Cursor, и Cursor CLI. Если файл не получается разобрать, Sozvon его не трогает и предлагает скопировать запись:

"sozvon": {
  "url": "http://127.0.0.1:47816/mcp",
  "headers": { "Authorization": "Bearer <пароль>" }
}

Эти же команды можно выполнить руками, результат будет тот же. Кнопка с двумя листками рядом с «Подключить» копирует готовую команду с паролем. Другой MCP-клиент подключается так же: HTTP-адрес выше и заголовок Authorization: Bearer <пароль>.

Инструменты

То, что ассистент прочитал через MCP, уходит в Anthropic, OpenAI или Cursor вместе с твоим вопросом, как любой другой контекст сессии.

Свой сервер: звонки с телефона

Необязательно. Если хочется спросить Claude или ChatGPT о звонке с телефона, когда Mac далеко, Sozvon может держать копии расшифровок на твоём собственном сервере. Это сделано ради твоей безопасности и приватности: каждый поднимает свой сервер в своём аккаунте Cloudflare (бесплатного тарифа хватает), поэтому звонки не попадают ни к нам, ни в какой-то общий сервис. Мы не видим твои данные, а удалить их все можно в любой момент.

Что уходит: расшифровки, саммари, заметки и данные звонка (дата, тема, проект, участники) только законченных звонков. Кроме того, на вкладке «Облако» два переключателя, оба включены по умолчанию:

• «Отправлять аудио звонков». Звук хранится частями в твоей базе D1, чтобы новый Mac получил звонки вместе с записью. Бесплатного тарифа хватает примерно на 80 часов звонков. Дальше сервер не принимает новый звук, синхронизируется только текст, и Sozvon об этом скажет. Звук удалённых звонков и звук, удалённый автоудалением, освобождает место.
• «Отправлять отпечатки голосов». Голоса, чтобы другие Mac узнавали тех же людей.

Распознавание всё равно идёт на Mac: звук уходит только на твой сервер и только с включённым переключателем. Claude и ChatGPT через коннектор никогда не получают звук и голоса, только текст.

Что могут ассистенты. Смотреть список звонков, читать и искать их (тем же ранжированным поиском, что и на Mac) и добавлять заметки. Менять или удалять звонки и заметки они не могут.

Честно об ограничениях. Текст не зашифрован end-to-end: серверу нужно его читать, чтобы искать. Его видит твой аккаунт Cloudflare, а когда помощник читает звонок, текст уходит в Anthropic или OpenAI, как любой контекст разговора. Согласие собеседников на запись и хранение на тебе. Со звуком и голосами в твоём аккаунте Cloudflare хранятся и чужие голоса, за них и за согласие этих людей отвечаешь ты.

Настройка в два шага

1. В Sozvon открой «Настройки», вкладку «Облако», нажми «Подключить Cloudflare» и в браузере «Разрешить» (бесплатного аккаунта Cloudflare хватает, его можно завести там же). Sozvon сам создаст базу, загрузит сервер в твой аккаунт, придумает надёжный пароль и синхронизирует звонки: отправит свои и скачает те, что уже есть на сервере. Дальше каждый новый звонок уходит после расшифровки. Если разрешил несколько аккаунтов, Sozvon спросит, в какой ставить. После «Разрешить» браузер сам вернёт тебя в Sozvon (в первый раз он спросит «Открыть Sozvon?»).
2. Подключи ассистента. Адрес коннектора и пароль на той же вкладке, у каждого кнопка копирования.
   • Claude: нажми «Открыть Claude». Адрес уже в буфере, откроется окно добавления коннектора (claude.ai/customize/connectors): вставь адрес, назови Sozvon, добавь и войди паролем. Коннектор сразу работает и в приложениях Claude для телефона и компьютера. В тарифах Team и Enterprise свои коннекторы может понадобиться разрешить владельцу.
   • ChatGPT: нажми «Открыть ChatGPT» и добавь адрес как свой MCP-сервер с входом через OAuth, потом войди паролем. Нужен платный тариф ChatGPT, точный путь в меню в docs/SERVER.md.

Какие права просит Sozvon: чтение настроек аккаунта (узнать его имя и адрес workers.dev), запись в D1 (база звонков), Workers Editor и Workers Admin (загрузить сервер; без Admin Cloudflare не даст создать новый Worker) и Workers KV (сессии входа Claude и ChatGPT и копия пароля для других Mac). Доступ нужен только на время настройки: Sozvon держит его только в памяти и забывает, как только настройка закончится. Отозвать разрешение можно в Cloudflare: My Profile, Access Management, список авторизованных приложений (прямая ссылка), кнопка Revoke. Сервер после этого продолжит работать.

Обновление. Когда в новой версии Sozvon есть новый сервер, на вкладке появляется «Обновить сервер»: войди в Cloudflare ещё раз, и Sozvon загрузит новую версию. Звонки, пароль и коннекторы остаются как были. После обновления Sozvon один раз нажми «Обновить сервер»: синхронизация звука и голосов нужна серверу 0.4.0.

Вручную. Можно поднять сервер и без кнопки: кнопкой Deploy или через wrangler по docs/SERVER.md, а потом вставить адрес и пароль в разделе «Свой адрес» на той же вкладке.

Подробности, лимиты бесплатного тарифа и удаление сервера: docs/SERVER.md на GitHub.

Синхронизация между Mac

Свой сервер заодно связывает несколько Mac. Подключи тот же сервер на втором Mac («Подключить Cloudflare» в том же аккаунте или адрес и пароль вручную), и Sozvon скачает все звонки, которых там нет: текст, саммари, заметки и звук, если его отправляли, так что плеер работает. Голоса тоже приходят, и второй Mac узнаёт тех же людей.

• Новые звонки уходят на сервер после расшифровки, остальные Mac забирают их при следующей синхронизации. Синхронизировать сразу можно кнопкой «Синхронизировать» на вкладке «Облако».
• Заметки идут в обе стороны: оставленные Claude или ChatGPT на сервере приходят в окно «Звонки», твои уходят на сервер.
• Удаление только из Sozvon. С сервера удаляются только звонки, которые ты удалил в Sozvon (в корзину из окна «Звонки»). Звонок, которого просто нет в папке, сервер не трогает, а скачивает обратно. Поэтому удаляй звонки в Sozvon, а не в Finder.
• Удалённый на одном Mac звонок на других переносится в Корзину macOS, оттуда его можно вернуть. Отмена удаления в Sozvon возвращает звонок и на сервер. Звонок, который сейчас записывается или расшифровывается, ждёт следующей синхронизации.
• Если звонок не отправился, остальные всё равно синхронизируются, на вкладке «Облако» видно «Не отправились: N», а следующая синхронизация попробует снова.
• Пароль на новом Mac. «Подключить Cloudflare» кладёт копию пароля сервера в хранилище KV самого сервера (sozvon-oauth, ключ sozvon:password) в твоём аккаунте Cloudflare. Сам сервер этот ключ не читает и никому не отдаёт. На новом Mac «Подключить Cloudflare» берёт эту копию, и если сервер её принимает, коннекторы Claude и ChatGPT остаются подключёнными. Если нет, Sozvon ставит новый пароль и пишет, что в коннекторах нужно войти ещё раз. У сервера, поднятого кнопкой Deploy или через wrangler, копии нет, поэтому первое подключение из приложения один раз сменит пароль. Если вводишь адрес вручную, пароль сам не подставится: введи оба, Sozvon проверит их по Enter или «Сохранить».

Настройки

Приватность: что уходит в сеть

Ни телеметрии, ни своих серверов. Вот полный список.

Весь код открыт. Каждый коммит проверяют Gitleaks, Semgrep и CodeQL: секреты, уязвимости, подозрительный код.

Где лежат файлы

Каждый звонок это папка в ~/Documents/Calls, например 2026-11-04 15-01 · Acme · запуск · Анна:

Это обычные файлы: их можно читать, переносить, класть в заметки. Движок, модели, проекты и голоса (папка voices) лежат в ~/Library/Application Support/Sozvon. Как устроено взаимодействие приложения и движка, описано в CONTRACT.md.

Если что-то не так

«В записи нет звука»

Проверь разрешения «Микрофон», «Запись экрана» и «Запись системного аудио» в Настройках Sozvon → Основные → Разрешения или в Системных настройках, затем перезапусти Sozvon. Если в звонке ты был в наушниках с отдельным микрофоном, убедись, что macOS использует именно его.

«Cloudflare сейчас не отвечает (код 503)»

Это временный сбой на стороне Cloudflare: Sozvon уже сам повторил запрос. Подожди несколько минут и нажми «Подключить Cloudflare» или «Обновить сервер» ещё раз, твой сервер и звонки при этом не страдают. Если не проходит час и больше, в ~/Library/Logs/Sozvon/cloudflare.log есть номер запроса (cf-ray) для поддержки Cloudflare.

В расшифровке «ДИНАМИЧНАЯ МУЗЫКА» и подобное

Так Whisper иногда подписывает паузы и шум, он учился на субтитрах. Sozvon убирает такие пометки сам; если в старой расшифровке они остались, нажми «Ещё», «Расшифровать заново…».

Mac тормозит во время расшифровки

Включи «Расшифровывать с низким приоритетом» на вкладке «Распознавание». Расшифровка станет чуть дольше, зато не будет мешать.

«Движок сломан» или «Модель не скачана»

«Настройки», вкладка «Распознавание», «Переустановить…»: выбери модель и нажми «Переустановить». Записи при этом не трогаются.

«Этот формат macOS прочитать не может»

Импорт не принимает webm, ogg, opus, oga и mkv. Их сначала сконвертируй в m4a, mp3 или wav, например ffmpeg -i call.webm call.m4a, и импортируй снова.

«Нет доступа к Напоминаниям»

Включи Sozvon в «Системных настройках», раздел «Конфиденциальность и безопасность», «Напоминания» (туда ведёт кнопка «Открыть настройки» рядом с сообщением), и нажми «Добавить» ещё раз.

Ассистент не видит звонки

Sozvon должен быть запущен. В разделе «Движок» на вкладке «Распознавание» видно, работает ли MCP-сервер, там же кнопка «Проверить». Переподключи ассистента на вкладке «Ассистенты» и перезапусти сессию.

«Cloudflare не дал доступ»

В сообщении видно, какой запрос не прошёл и что ответил Cloudflare. Обычно не отмечено какое-то право: нажми «Попробовать ещё раз» и на странице Cloudflare разреши всё. Ошибки запросов к Cloudflare пишутся в ~/Library/Logs/Sozvon/cloudflare.log (без токенов и паролей).

«Сервер загружен, но пока не отвечает»

Новому адресу workers.dev иногда нужна минута. Попробуй ещё раз чуть позже: Sozvon возьмёт уже созданные базу и сервер, ничего не задвоится.

Вход в коннектор: «This authorization expired or was already used»

Страница входа открыта по старой ссылке, обновлена или отправлена дважды. Начни подключение в Claude или ChatGPT заново.

«Сервер не принял пароль»

Пароль на сервере сменился. Введи текущий в разделе «Свой адрес» на вкладке «Облако». После 10 неверных попыток с одного адреса сервер не пускает 15 минут.

Журналы

• process.log в папке звонка: расшифровка.
• ~/Library/Logs/Sozvon/recorder.log: запись звука.
• ~/Library/Logs/Sozvon/cloudflare.log: неудачные запросы к Cloudflare при «Подключить Cloudflare».
• ~/Library/Application Support/Sozvon/setup.log и mcp.log: установка и MCP-сервер.

Проще всего собрать всё сразу: «Настройки», «О программе», «Диагностика…» показывает, что в порядке, а «Сохранить архив…» кладёт в zip проверки и эти журналы (process.log последних 5 звонков). В архиве нет расшифровок, саммари, аудио, паролей и голосов, имена участников и проектов из журналов убраны, пути к домашней папке заменены на ~.

Если не помогло, открой issue и приложи архив. Отдельные журналы приложи только после проверки: в process.log бывают имена участников.

Удаление

1. Если подключал ассистентов: claude mcp remove sozvon --scope user, codex mcp remove sozvon, а для Cursor убери запись "sozvon" из ~/.cursor/mcp.json.
2. Выйди из Sozvon и перетащи его из «Программ» в корзину.
3. Удали движок и модели: папку ~/Library/Application Support/Sozvon и журналы ~/Library/Logs/Sozvon.

Записи в ~/Documents/Calls остаются, удали их сам, если они не нужны.

Если поднимал свой сервер:

1. В Cloudflare удали Worker sozvon (Workers & Pages), базу D1 sozvon со всеми звонками, звуком и голосами (Storage & Databases, D1) и пространство KV sozvon-oauth (в нём же лежит копия пароля сервера). Или командами wrangler из docs/SERVER.md.
2. Отзови доступ Sozvon в Cloudflare: My Profile, Access Management, список авторизованных приложений (прямая ссылка), Revoke.
3. Удали коннектор Sozvon в настройках коннекторов Claude или ChatGPT.

Сборка из исходников

Нужны Xcode 26 и uv. По желанию Node.js 22 или новее: без него приложение соберётся, но без сервера внутри, и «Подключить Cloudflare» будет недоступна.

git clone https://github.com/Able1991/sozvon && cd sozvon
./test.sh              # тесты движка, переводов, сервера (при Node.js 22+) и приложения
./build.sh install     # ~/Applications/Sozvon.app
./build.sh dmg         # build/Sozvon.dmg

Устройство проекта описано в README, подпись и выпуск релизов в SIGNING.md.

Documentation

Everything you need to record calls and get text out of them. Missing something? Open an issue.

Install

Requirements: a Mac with Apple silicon (M1 or later), macOS 15 Sequoia or later, 2-5 GB of free space. For summaries and project discovery, optionally Claude Code, Codex CLI or Cursor CLI.

1. Download Sozvon.dmg, open it and drag Sozvon to Applications. Or with Homebrew: brew install --cask able1991/sozvon/sozvon.
2. Launch it. The assistant asks how to label you in transcripts, which languages your calls are in, which recognition model to install and who writes summaries.
3. It installs the engine itself: Python, the model and speaker separation. That takes 5-10 minutes and 1-4 GB depending on the model. No accounts or tokens.
4. Allow access when macOS asks: Microphone (your voice), Screen Recording and System Audio Recording (the other side, FaceTime included). Setup and Settings > General > Permissions have a button for each. No video is recorded, only sound. Then setup makes a three second test recording to check that recording really works and that the computer's sound is heard. Until setup is finished, the rest of the Sozvon menu is unavailable. Sozvon asks for Reminders access only when you first press To Reminders.

If you denied a permission by accident, turn it on in System Settings, Privacy & Security, and restart Sozvon.

Updates install themselves. Once a day Sozvon checks for a new version, downloads it in the background and installs it when nothing is going on: no recording, no transcription, no call and no open window. The restart takes a couple of seconds, then a notification links to what's new. Every update is checked against the developer's signature and the Sozvon key; your calls and settings stay in place. Turn off Update Automatically in Settings > About to have the menu show Version … Is Available and install it yourself. Versions before 0.1.2 could not update themselves: update them once by hand with the DMG.

Recording a call

• Floating panel. It sits above every window, even full-screen Zoom. Click it to start recording. You can drag it around; dragging doesn’t start a recording.
• Menu bar icon. Record, and Stop while recording.

“A call is on in Zoom. Record?”

When Zoom, Telegram, a browser (Google Meet and other web calls), TrueConf, FaceTime, Slack, Teams or another call app holds the microphone for more than 5 seconds, the panel asks “A call is on in Zoom. Record?”. Record starts a recording, just like the usual button. Not Now hides the question until that app releases the mic, that is, until the call ends. If the floating panel is off, the same question with the same buttons comes as a notification.

By default Sozvon never records by itself: a recording starts only when you press Record. No extra permission is needed: Sozvon only sees which app is using the microphone, never the sound itself, and sends nothing anywhere. Dictation, Siri and unknown apps never trigger it, and neither does anything during a recording.

Record automatically. Settings > General > When a Call Starts offers Ask (the default), Record Automatically and Do Nothing. With Record Automatically the panel shows “Call in Zoom · recording in 10 s” with Record Now and Don't Record; if you press nothing, the recording starts by itself. Getting the other side's consent is up to you.

Stop when the call ends. With this switch on, the recording stops by itself once no call app has held the microphone for 30 seconds: the panel shows “Stopping in 30 s” and Continue, which keeps this recording going until you stop it. Short gaps while Zoom or Telegram reconnects don't end the recording, and there is no countdown while the other side is heard. A recording of a meeting in the room, with no call app, never stops by itself. The countdowns to an automatic start or stop are always visible, even with the floating panel off.

Reflections. Press the capsule and think out loud. At the end choose Reflections in the window; Sozvon suggests it when there was no call and nobody else was heard. Instead of a call summary you get the main point, an analysis, what to do and your open questions. Reflections live in the same list as calls, with a mark and their own filter, can belong to a project, and assistants find them through MCP.

Recordings from your phone. In Settings > General > Recordings from Your Phone, choose a folder, for example in iCloud Drive. On iPhone: Voice Memos, Share, Save to Files, that folder. A new recording is imported and transcribed by itself as a reflection, and the file moves to the Imported subfolder; what could not be read goes to Failed. This folder only picks up finished files.

One tap on iPhone. Add the Think Out Loud shortcut and run it once: it creates a folder named Sozvon in iCloud Drive. Choose that folder in the setting above. From then on it starts recording at once, and Stop saves the file to that folder. Put it on the Home Screen or the Action Button. A recording made through the shortcut may stop if the phone locks: use Voice Memos for long ones.

Consent reminder. Remind Me to Say the Call Is Recorded shows a note on the capsule for a few seconds when recording starts.

Who was on the call. If you have saved voices of other people, Sozvon compares the other side's speech with them during the recording, at low priority and on your Mac. What Was the Call About? opens with the project and participants from Calendar and the voices. When it all agrees, the form continues by itself after 10 seconds: change anything or press Wait to stop it. To turn this off: Settings > General > Transcribe Right Away When It's Clear.

While recording

While recording, the panel shows a timer and a live waveform of both sides: your microphone and your computer’s audio. If your mic stays silent for too long, the panel warns that it can’t hear you: check the selected microphone and that you aren’t muted in the call. Sozvon also warns if the system input volume is below 50% (browser calls often lower it) or your voice has been barely audible for three minutes.

Without headphones. On speakers your microphone hears the other side too. Before recognition Sozvon removes that echo from your track right on the Mac: a filter follows the delay between the tracks, and a small neural model (11 MB, downloaded once, about 2 extra minutes per hour of call) removes the rest, only while the other side is talking. While the other side is silent, your voice and people next to you are left exactly as they are. While the other side talks, voices next to you are kept, but a voice much quieter than the speakers can come out quieter. A very quiet microphone track is raised. The cleaned voice is kept next to it in mic.clean.m4a and the player plays it, so you hear yourself without the echo. The original mic.m4a is never changed and is used to transcribe again. Headphones are still best.

Sozvon doesn’t join the call or add bots. It records what your Mac hears, so it works with any app: Zoom, Google Meet, FaceTime, Telegram, a browser. Telling others you’re recording is up to you, and the rules differ by country.

If you quit during a recording, Sozvon finishes writing the files first. If you quit during transcription, it asks whether to stop it.

After the call

After Stop, the What Was the Call About? window appears. Every field is optional, but each one makes the result better:

Transcribe queues the call. Sozvon transcribes one call at a time; the others show “Queued” and wait, and none starts during a recording or a call. The queue survives a restart, and a call can be removed from it in the Calls window. Later closes the window and keeps what you have typed so far. Don’t Transcribe just keeps the recording; you can transcribe it from the Calls window any time.

Later

If the next call starts right away, press Later or just close the window. The call is marked Needs description in the Calls window, and the Sozvon menu shows Waiting for Description: N, which opens the same window for the oldest such call. Transcribe… in the Calls window does the same.

Once Sozvon has not recorded anything for 10 minutes, a reminder with a Describe button comes, at most once an hour per call. There are no reminders during a recording, and the menu item is hidden then. The call waits until you transcribe it or choose Don’t Transcribe.

What happens next: the tracks are aligned, the other side’s echo is removed from your mic, speech is recognized with hints from the project, voices are separated, known voices are named by themselves, the assistant names the rest from context and writes the summary. An hour-long call takes a few minutes on Whisper Turbo. You get a notification when it’s done.

Calls window

• Search covers date, topic, project, participants and the text of summaries and transcripts.
• From a call’s menu: show in Finder, transcribe again (say, with another model or corrected participants), move to Trash.
• The call being recorded right now is marked as recording and can’t be deleted or transcribed.
• Above the summary is a card with its notes. Share in the toolbar copies the call, opens the transcript and sends tasks to Reminders; More transcribes again, shows the folder in Finder, opens the log and deletes the call.
• Latest Transcript in the menu and the Transcript Ready notification open the call here.
• A call downloaded from your own server comes with its audio if it was sent there, so the player works. Without audio you can read and search it, but not play it or transcribe it again.

Listening to a call

The player sits at the bottom of the window, on both tabs: Play and Pause, back and forward 15 seconds, a scrubber and speed 1×, 1.5× or 2×. Click any line and the call plays from there. The current line is highlighted and the window scrolls to keep it in view. Both tracks, your microphone and the other side, play together and in step with the timestamps. Once a call is transcribed, the player plays a copy with its loudness gently levelled: loud stretches are pulled down firmly, quiet speech is raised by at most 6 dB, and pauses stay about as quiet as they were. A very quiet track is raised first, so it can end up more than 6 dB above the recording. Each side keeps its full bandwidth, except your microphone on a call where echo was removed, which is the cleaned 16 kHz signal. Writing the copy takes about 2 minutes per hour of call, after the transcript and summary are ready. The copy takes about 33 MB per hour of call; transcription and voice prints never use it.

While a call has audio, a click on a line plays it instead of selecting text. To copy a line, use Copy in its context menu, which also has Play from Here.

Fixing the transcript

In a line’s context menu:

• Rename Speaker… opens the Who is speaking? window. Below the field are name suggestions: the other speakers, the call’s participants and the project’s people. With In the whole transcript checked, every line by that person, the participant list in the header and the call’s participants get the new name; unchecked, only the line you clicked goes to that person. If the name already speaks in the call, Sozvon offers Swap (the assistant mixed up two people) or Merge (it is one person). When you name a speaker precisely, Sozvon saves their voice for the project.
• Fix Word…: select the misheard word or phrase in the line and type the correct spelling. Only whole words are replaced, and only in the line you clicked. Then Sozvon asks “Remember for the “Acme” project?” (or “Remember for all calls?” when the call has no project). Remember adds a fix, so new transcripts spell it right straight away.

Edits change transcript.md and transcript.txt. The summary is not rewritten by itself: a bar above it says the transcript was edited after the summary, with Update Summary, and the More menu has the same item. Only the summary is rewritten, nothing is transcribed again. A call can’t be edited while it is being recorded or transcribed. With your own server, the edited call is sent there again.

If the assistant could not write the summary, the notification says “Done, but the summary failed” with the reason and an Update Summary button, and the call in the list gets a “No summary” mark.

Importing a recording

An older recording can be transcribed just like a new one: drop the file onto the call list or click Import Recording… in the toolbar. m4a, mp3, wav, aac, flac, and mp4 or mov video work (only the sound is used). Sozvon doesn’t take webm, ogg, opus, oga or mkv, so convert those to m4a, mp3 or wav first.

Sozvon creates a new call folder dated by the recording date in the file’s metadata (or, without one, the file’s own date), saves the sound as system.m4a and opens What Was the Call About?, as after a recording. There is no separate track for your microphone here, so every voice, yours included, is separated by voice and named from context. If you pick several files, they are imported one after another, the window opens for the last one, and the rest wait in the list with Transcribe….

To Reminders

Add to Reminders… in the Share menu of the call’s toolbar shows up when the summary has action items or the call has notes. Your open tasks are already checked (by your name from Settings, or “me”, “you”). Check other people’s tasks and notes yourself; someone else’s task keeps their name: “Anna: send the contract”.

A due date is set only when the day is clear: “tomorrow”, “Friday”, “Nov 10”, counted from the call date. Anything vaguer gets no date: better none than a wrong one. List: Default or Sozvon (Sozvon creates that list if needed). Each reminder carries the call’s title and date and a link to its summary.

macOS asks for Reminders access the first time you add something. Tasks go to the Reminders app on this Mac; Sozvon sends nothing anywhere. If Reminders on this Mac syncs through iCloud, Apple syncs them further.

Marking what matters

While recording, the panel has a star. Press it, choose Mark as Important in the menu or press ⌃⌥I in any app, even full-screen Zoom, and Sozvon remembers that moment. The number next to the star shows how many moments you marked. The shortcut works only during a recording.

In the transcript the marked line gets a star and a yellow tint, and the summary gets a Key Moments section: the time and what was said or decided there.

When the sound drops

The panel shows “Can’t hear you” or “Can’t hear them” right away. If the microphone gives only digital silence (headphones disconnected, the device changed) or the other side is silent for two minutes, Sozvon captures that source again by itself, without interrupting the other track. If it is still silent half a minute later, a notification with Sound Settings tells you. A quiet room never raises the alarm.

Title and people from Calendar

After Stop, What Was the Call About? is filled from the Calendar meeting at the time of the recording: the topic from its title, the participants from its attendees, and the project when the title or the people match one. A meeting with a Zoom, Meet or Teams link wins over lunch at the same time. Only empty fields are filled: what you typed during the recording stays.

macOS asks for Calendar access the first time. The calendar is read only on this Mac. To turn it off: Settings, General, Title and participants from Calendar.

Deleting audio automatically

Settings, General, Delete audio automatically: never (the default), after a week, 15, 30 or 60 days. Transcribed calls older than that lose only their sound; the transcript, summary and notes stay. Such calls have no player and no Transcribe Again. Their audio is deleted from your own server too. If the new setting would delete audio right away, Sozvon first shows how many calls and how much space.

Notes

Leave a note on a call: a decision, an agreement, something for later. Add your own with Add in the Notes card of the Calls window and delete one with the ⋯ button next to it. Claude Code, Codex and Cursor add notes with the add_note tool, and Claude and ChatGPT on your phone do the same through your own server.

• Each note shows its date and who added it: you, Claude, Codex, Cursor or ChatGPT.
• A note can’t be edited, but you can delete it: the ⋯ button next to it, Delete Note. An assistant can delete a note too when you ask (delete_note).
• Search in the Calls window, search_calls and get_call find notes.
• Notes live in the call’s call.json and sync with your own server both ways. A deleted note doesn’t come back from another Mac.
• Up to 4,000 characters per note and 200 notes per call.

Projects

• People. Participant names, suggested after a call and used to label speakers.
• Terms. Product and company names, jargon. Whisper gets them as a hint and spells them right.
• Fixes. What the model keeps mishearing and what it should be.

Edit projects in the Projects window from the menu. People from labelled calls are added automatically.

Discover projects

Find Projects asks Claude Code, Codex or Cursor to look through your sessions and notes and suggest projects with people and terms; you choose what to keep. The assistant gets project folder names, memory notes and replies from open sessions, which go to Anthropic, OpenAI or Cursor and the model chosen there. Claude is technically limited to ~/.claude. The Codex sandbox blocks writes but not reads, so its limit to ~/.codex is only an instruction. Cursor runs in read-only mode (--mode ask) and looks at past chats in ~/.cursor/projects; its limit to that folder is also only an instruction.

Voices

Sozvon can recognize people by voice instead of only guessing names from the conversation. Two people called Alexander in one project are no longer mixed up.

• Your voice. Settings, General, My voice under your name: Record…, then read the simple text on the screen aloud, 20 seconds. The text is in a call language, not the interface language; with several call languages you pick one at the top. Later the Sample menu has Add Sample…, which adds one more recording to the voice print (say, in your second call language), and Re-record…, which starts over.
• Confirm voices. When a transcript names everyone right, a bar above the summary and transcript says “Names right? Remember the voices” with Remember Voices. For one person: right-click a line of theirs, Remember the Voice. Participants whose voice is saved get a green check in the call header.
• Other people’s voices. When you name a speaker in a call (Rename Speaker… or Swap), Sozvon saves that person’s voice print for the project. In the project’s later calls those voices are named by themselves, and the assistant only names the rest.
• Next to you. If your voice is saved and someone else speaks at your microphone for at least 15 seconds, their lines get their saved name or a separate Speaker label instead of yours. Without a saved voice, the whole microphone is labeled as you.
• Who is saved. The Projects window shows which of the project’s people have a saved voice, and you can delete it there. Settings, General, Voices, Show… lists every saved voice: whose, in which project, how much speech and when; delete any of them, or Delete All….

Voice prints are biometric data. They are kept on this Mac and, with Send voice prints on, on your own server in your own Cloudflare account, nowhere else. Claude and ChatGPT never see them. Deleting a voice deletes it everywhere: on this Mac, on the server and on your other Macs.

Models

Switch in Settings, Recognition tab. A new model downloads once. Speaker separation (pyannote, 31 MB) ships with the app for every model.

Several languages. Pick several in Call languages and the language is detected per track. If people switch languages mid-conversation, turn on mid-sentence switching: the language is then detected per phrase, 20-30% slower.

Summaries

Summaries are written in the language of the call: overview, decisions, action items with owners, open questions. They come from an assistant you already have:

• Claude Code on your subscription, Sonnet by default.
• Codex CLI on your OpenAI subscription.
• Cursor CLI (cursor-agent) on your Cursor subscription, with the model chosen in Cursor.
• Local only: no summaries or speaker naming; the transcript stays on your Mac.

Pick it in Settings, Assistants tab. If a summary fails (no network, limit reached), the transcript is still saved.

Claude Code, Codex and Cursor (MCP)

Sozvon can hand your calls to your assistant: “what did we agree with Acme last week?”, “find where we discussed the SLA”. While Sozvon is running, it keeps one shared MCP server on 127.0.0.1:47816 for every session, about 40 MB of memory. It is reachable only from this Mac and requires a password (bearer token).

Connect

Settings, Assistants tab, Connect next to the assistant. That’s it: a new Claude Code, Codex or Cursor session already sees your calls. Disconnect removes Sozvon from the assistant’s settings.

No calls yet? On the same tab, Demo Calls, Add: a few fictional calls with a transcript and summary, no audio, appear in your calls folder, and you can ask the assistant about them right away. They carry a Demo mark in the list, never go to your own server, and Remove moves only them to the Trash.

Under the hood

One server for everyone. The MCP server is started by the Sozvon app, not by each assistant session. If every session ran its own copy, ten open sessions would mean ten Python processes. The shared server takes about 40 MB, and assistants connect to it at http://127.0.0.1:47816/mcp. It runs while Sozvon is open and exits with it.

Why a password. 127.0.0.1 isn’t reachable from the network, but any program on the Mac itself can talk to it: a sandboxed App Store app (it can’t read ~/Documents, but it can reach localhost) or processes of other users on this Mac. Without a password, such a program could read every transcript, and through the transcribe tool make Sozvon read any of your files. So on first launch Sozvon creates a random 32-byte password in ~/Library/Application Support/Sozvon/.mcp-token, readable only by you, and the server only answers requests that carry it. The server also checks the Host and Origin headers so a website in your browser can’t reach it.

What Connect does. For Claude Code it runs

claude mcp add --scope user --transport http sozvon http://127.0.0.1:47816/mcp \
  --header "Authorization: Bearer $(cat ~/Library/Application\ Support/Sozvon/.mcp-token)"

For Codex it runs codex mcp add sozvon --url http://127.0.0.1:47816/mcp and adds the password to the [mcp_servers.sozvon] section of ~/.codex/config.toml:

http_headers = { "Authorization" = "Bearer <password>" }

Cursor has no mcp add command, so Sozvon adds the entry itself, first in "mcpServers" of ~/.cursor/mcp.json. Comments and other servers in the file stay as they were. The Cursor app and Cursor CLI both read this file. If the file can’t be parsed, Sozvon leaves it alone and offers to copy the entry:

"sozvon": {
  "url": "http://127.0.0.1:47816/mcp",
  "headers": { "Authorization": "Bearer <password>" }
}

You can run the same commands by hand with the same result. The copy button next to Connect puts the ready command, password included, on the clipboard. Any other MCP client connects the same way: the HTTP address above plus an Authorization: Bearer <password> header.

Tools

Whatever the assistant reads through MCP goes to Anthropic, OpenAI or Cursor along with your question, like any other session context.

Your own server: calls from your phone

Optional. If you want to ask Claude or ChatGPT about a call from your phone while your Mac is away, Sozvon can keep copies of your transcripts on your own server. This is about your security and privacy: everyone runs their own server in their own Cloudflare account (the free plan is enough), so your calls never go to us or to any shared service. We never see your data, and you can delete all of it at any time.

What is sent: transcripts, summaries, notes and call details (date, topic, project, participants) of finished calls only. On top of that, the Cloud tab has two toggles, both on by default:

• Send call audio. The audio is stored in chunks in your own D1 database, so a new Mac gets your calls with their recordings. The free plan holds about 80 hours of calls. After that the server refuses new audio, only text syncs, and Sozvon tells you so. Audio of deleted calls, and audio removed by automatic deletion, frees the space.
• Send voice prints. Voices, so your other Macs recognize the same people.

Recognition still runs on the Mac: audio goes only to your own server, and only with the toggle on. Claude and ChatGPT never get audio or voice prints through the connector, only text.

What assistants can do. List, read and search your calls (with the same ranked search as on the Mac) and add notes. They can’t change or delete calls or notes.

The limits, honestly. The text is not end-to-end encrypted: the server has to read it to search. Your Cloudflare account can see it, and when the assistant reads a call, the text goes to Anthropic or OpenAI like any other conversation context. Getting consent from the people you record and store is up to you. With audio and voice prints on, other people’s voices are stored in your Cloudflare account, under your responsibility, including their consent.

Setup in two steps

1. In Sozvon, open Settings, the Cloud tab, click Connect Cloudflare and then Allow in the browser (a free Cloudflare account is enough, you can create one right there). Sozvon creates the database, uploads the server to your account, generates a strong password and syncs your calls: sends yours and downloads the ones already on the server. After that every new call is sent once it is transcribed. If you allowed several accounts, Sozvon asks which one to use. After Allow, the browser brings you back to Sozvon (the first time it asks to open Sozvon).
2. Connect your assistant. The connector address and the password are on the same tab, each with a copy button.
   • Claude: click Open Claude. The address is already on the clipboard and the Add custom connector dialog opens (claude.ai/customize/connectors): paste the address, name it Sozvon, add it and log in with the password. The connector then works in the Claude phone and desktop apps too. On Team and Enterprise plans an owner may need to allow custom connectors.
   • ChatGPT: click Open ChatGPT and add the address as a custom MCP server with OAuth sign-in, then log in with the password. It needs a paid ChatGPT plan; the exact menu path is in docs/SERVER.md.

Permissions Sozvon asks for: read account settings (the account name and its workers.dev address), write to D1 (the calls database), Workers Editor and Workers Admin (to upload the server; without Admin Cloudflare won’t let it create a new Worker) and Workers KV (sign-in sessions of Claude and ChatGPT, and the password copy for your other Macs). The access is needed only during setup: Sozvon keeps it only in memory and drops it as soon as setup finishes. You can revoke it in Cloudflare under My Profile, Access Management, the list of authorized applications (direct link), Revoke. The server keeps working after that.

Updating. When a newer Sozvon ships a newer server, the tab shows Update server: sign in to Cloudflare again and Sozvon uploads the new version. Your calls, the password and the connectors stay as they are. After updating Sozvon, press Update server once: audio and voice sync need server 0.4.0.

Manually. You can also set up the server without the button, with the Deploy button or wrangler as described in docs/SERVER.md, and then paste the address and password under Own address on the same tab.

Details, free plan limits and removing the server: docs/SERVER.md on GitHub.

Sync across Macs

Your own server also links several Macs. Connect the same server on a second Mac (Connect Cloudflare with the same account, or the address and password by hand), and Sozvon downloads every call that Mac doesn’t have: text, summary, notes and the audio if it was sent, so the player works. Voice prints come too, so the second Mac recognizes the same people.

• New calls go to the server once transcribed, and the other Macs pick them up on their next sync. Sync now with the Sync button on the Cloud tab.
• Notes go both ways: notes Claude or ChatGPT leave on the server show up in the Calls window, and yours go up to the server.
• Deletions only from Sozvon. Only calls you delete in Sozvon (move to Trash from the Calls window) are deleted on the server. A call that is merely missing from the folder is left alone there and downloaded back. So delete calls in Sozvon, not in Finder.
• A call deleted on one Mac is moved to the macOS Trash on the others, so you can put it back. Undoing the delete in Sozvon brings it back to the server too. A call being recorded or transcribed waits for the next sync.
• If a call fails to upload, the rest still sync, the Cloud tab shows “Not sent: N”, and the next sync tries again.
• The password on a new Mac. Connect Cloudflare keeps a copy of the server password in the server’s own KV namespace (sozvon-oauth, key sozvon:password) in your Cloudflare account. The server itself never reads or serves that key. On a new Mac, Connect Cloudflare reads the copy, and if the server accepts it, the Claude and ChatGPT connectors stay signed in. If not, Sozvon sets a new password and tells you to sign in to the connectors again. A server deployed with the Deploy button or wrangler has no copy, so the first Connect from the app changes the password once. When you enter the address by hand, the password doesn’t fill in: type both, and Sozvon checks them on Enter or Save.

Settings

Privacy: what goes online

No telemetry, no servers of our own. Here is the complete list.

All code is open. Every commit is checked by Gitleaks, Semgrep and CodeQL for secrets, vulnerabilities and suspicious code.

Where files live

Each call is a folder in ~/Documents/Calls, for example 2026-11-04 15-01 · Acme · launch · Anna:

They are plain files you can read, move or drop into your notes. The engine, models, projects and voices (the voices folder) live in ~/Library/Application Support/Sozvon. The app and engine interface is described in CONTRACT.md.

Troubleshooting

“No sound in the recording”

Check Microphone, Screen Recording and System Audio Recording in Sozvon Settings > General > Permissions or in System Settings, then restart Sozvon. If you used a headset, make sure macOS is using its microphone.

“Cloudflare isn’t responding right now (code 503)”

A temporary outage on Cloudflare’s side; Sozvon has already retried the request. Wait a few minutes and press Connect Cloudflare or Update server again; your server and calls are not affected. If it keeps failing for an hour or more, ~/Library/Logs/Sozvon/cloudflare.log has the request id (cf-ray) for Cloudflare support.

“ДИНАМИЧНАЯ МУЗЫКА” and the like in a transcript

Whisper sometimes labels pauses and noise this way, it learned from subtitles. Sozvon removes such labels by itself; if an older transcript still has them, use More, Transcribe Again….

My Mac slows down while transcribing

Turn on “Don’t slow down my Mac” in the Recognition tab. Transcription takes a bit longer but stays out of your way.

“Engine is broken” or “Model not downloaded”

Settings, Recognition, Reinstall…: pick the model and press Reinstall. Your recordings are not touched.

“macOS can’t read this format”

Import doesn’t take webm, ogg, opus, oga or mkv. Convert them to m4a, mp3 or wav first, for example ffmpeg -i call.webm call.m4a, and import again.

“No access to Reminders”

Allow Sozvon in System Settings, Privacy & Security, Reminders (the Open System Settings button next to the message goes there), then press Add again.

The assistant doesn’t see my calls

Sozvon has to be running. The Engine section on the Recognition tab shows whether the MCP server is up, with a Check button. Reconnect from the Assistants tab and restart the session.

“Cloudflare denied access”

The message shows which request failed and what Cloudflare said. Usually a permission wasn’t allowed: click Try again and allow everything on the Cloudflare page. Failed Cloudflare requests are written to ~/Library/Logs/Sozvon/cloudflare.log (no tokens or passwords).

“The server is uploaded but does not answer yet”

A new workers.dev address sometimes needs a minute. Try again a bit later: Sozvon reuses the database and server it already created, nothing is duplicated.

Connector sign-in: “This authorization expired or was already used”

The sign-in page was opened from an old link, reloaded or submitted twice. Start connecting again in Claude or ChatGPT.

“The server did not accept the password”

The password on the server has changed. Enter the current one under Own address on the Cloud tab. After 10 wrong attempts from one address the server refuses for 15 minutes.

Logs

• process.log in the call folder: transcription.
• ~/Library/Logs/Sozvon/recorder.log: audio recording.
• ~/Library/Logs/Sozvon/cloudflare.log: failed Cloudflare requests during Connect Cloudflare.
• ~/Library/Application Support/Sozvon/setup.log and mcp.log: setup and the MCP server.

The easiest way to collect everything: Settings, About, Diagnostics… shows what is fine, and Save Archive… puts the checks and these logs (process.log of the last 5 calls) in a zip. The archive has no transcripts, summaries, audio, passwords or voices, participant and project names are removed from the logs, and home folder paths are replaced with ~.

Still stuck? Open an issue with the archive. Attach single logs only after checking them: process.log can hold participant names.

Uninstall

1. If you connected assistants: claude mcp remove sozvon --scope user, codex mcp remove sozvon, and for Cursor remove the "sozvon" entry from ~/.cursor/mcp.json.
2. Quit Sozvon and drag it from Applications to the Trash.
3. Delete the engine and models in ~/Library/Application Support/Sozvon and logs in ~/Library/Logs/Sozvon.

Your recordings in ~/Documents/Calls stay; delete them yourself if you don’t need them.

If you set up your own server:

1. In Cloudflare, delete the sozvon Worker (Workers & Pages), the sozvon D1 database with all calls, audio and voices (Storage & Databases, D1) and the sozvon-oauth KV namespace (it also holds the copy of the server password). Or use the wrangler commands in docs/SERVER.md.
2. Revoke Sozvon’s access in Cloudflare: My Profile, Access Management, the list of authorized applications (direct link), Revoke.
3. Remove the Sozvon connector in the Claude or ChatGPT connector settings.

Build from source

You need Xcode 26 and uv. Optionally Node.js 22 or later: without it the app still builds, but without the server inside, and Connect Cloudflare is unavailable.

git clone https://github.com/Able1991/sozvon && cd sozvon
./test.sh              # engine, translation, server (with Node.js 22+) and app tests
./build.sh install     # ~/Applications/Sozvon.app
./build.sh dmg         # build/Sozvon.dmg

See the README for the project layout and SIGNING.md for signing and releases.