С чего всё началось?

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

Во времена группы я впервые воспользовался распечатками на пюпитре. Спойлер – провал, было неудобно, в том числе, потому что зрение у меня не очень. Может, поэтому, когда появилась возможность прикоснуться к разработке, я подумал, а почему бы не попытаться решить этот вопрос.

23 мая этого года мне исполнилось 35 лет, и я решил попробовать что-то новое для себя. У меня была подписка на ChatGPT, и мне стало интересно узнать, как работает Codex. Изначально не было цели делать суфлёр или что-то подобное, но одна из первых идей, которые пришла в голову, сделать приложение, которое может помогать во время выступлений, почему бы и нет.

Раньше я пробовал несколько известных приложений в рамках домашних репетиций, иногда опыт на старте был неплохим, но потом начинались разные штуки, вроде «купите подписку, чтобы сохранять песни офлайн, добавить больше песен, собрать избранное. И как-то желание пользоваться этими штуками отпадало. А ещё, во многие нельзя добавить свои песни. Для меня, как автора, это тоже было важно.

Вайб-кодинг

Итак, мне 35, я открываю ChatGPT и просто спрашиваю, а что такое Codex, а можно ли написать с ним приложение на Android, а что, если это будет, например суфлёр для музыкантов?

Через 15 минут у меня был первый «прототип» приложения. Криво, косо, но работает. И меня это очень впечатлило. Я не написал ни строчки кода и получил рабочую вещь! Да ладно?!

Под впечатлением, я начал работать с тем, что получилось и стараться его улучшить, в основном, по собственным ощущениям и пожеланиям. Процесс всё так же увлекал. Причём, сначала я не планировал для него какое-то будущее за пределами моего телефона, но через пару дней получилась забавная штука, которой я захотел поделиться с парой друзей. И получил хороший отклик, мне сказали, что это очень удобно и они будут им пользоваться!

Разработка

До определённого момента, я просто старался добавить знакомые функции, но во время теста стало понятно, что этого недостаточно. Есть прокрутка, есть скорость прокрутки, но точности не хватает. Тогда я решил, что мне нужна функция, с помощью которой, можно было бы добавить приблизительное время песни, для того чтобы скорость рассчитывалась исходя из него. Стало лучше, но всё равно не идеально. И борьба за точность продолжилась. Но, не сразу…

В процессе оказалось, что 6000 строк кода в MainActivity это не очень и как будто бы надо с этим что-то делать. И начался рефакторинг. Огромная трудоёмкая работа, полезная… результаты которой не увидит практически никто. Зато в последствии это дало больше свободы в работе – стало не так страшно что-то менять, добавлять новые функции, заниматься дизайном, а после редизайном приложения.

Философия

Также, в процессе работы, начала, простите за громкое слово, проявляться философия проекта. Например, базой для себя я решил сделать offline-first и мысль о том, что «Всё уже у тебя». Локации для выступлений могут быть очень разными, в том числе бары в подвалах, загородные дома и дачи. Даже парковка! Поэтому очень важно, чтобы твой репертуар всегда был тебе доступен. Даже если ты не в «труднодоступном» месте, никто не застрахован от падения интернета.

Следующие основополагающие принципы пошли из базового. Например, аккаунты оффлайн-приложению, по сути, не нужны. Есть твоё приложение и песни в нём. Чего ещё желать?

А вот отсутствие подписки – немного другая история. Да это выливается из offline-first. Но, я считаю, что твой суфлёр – это такой же инструмент, как тюнер и каподастр. И мне не нравится идея того, что каждый месяц тебе продают одно и то же приложение, твои песни и твою работу, проделанную с ними. Никто не платит за молоток каждый месяц просто для того, чтобы им владеть. Инструменты рулят, долой сервисы!

Поэтому, база приложения:

- Музыкант важнее, чем технология. Приложение должно помогать, а не управлять и командовать;
- Инструмент, а не сервис;
- Офлайн в первую очередь, регистрации не нужны, вся работа пользователя принадлежит пользователю;
- Нет функциям ради функций, надёжность важнее;
- Никаких лишних и подозрительных разрешений;
- Интерфейс должен быть простым, не отвлекать, не давить;

В сумме: Я не хочу ещё один музыкальный сервис. Мне нужен инструмент, который не требует интернета, не просит войти в аккаунт за пять минут до выступления, просто хранит мои песни там, где они должны быть и показывает текст, когда он нужен.

Функции

Давайте рассмотрим приложение поближе. В самом начале появились библиотека, редактор текста с аккордами, транспонирование и сценический режим – наш основной рабочий экран. А ещё, на ранней стадии появился «умный» перенос строк, для того чтобы адекватно перенести аккорды и текст при большом размере шрифта. То, что надо для людей со слабым зрением (меня, например).

Вернёмся к погоне за точностью. Я добавил функцию прокрутки по приблизительной длительности песни, она повышала точность, но всё равно была не идеальна. Поэтому я стал думать, как ещё можно повысить точность? Я решил, что в тексты можно закидывать своеобразные якоря-чекпоинты. И тогда родилась одна из функций, которые, можно сказать, является фишкой приложения – Карта песни. С помощью неё можно настроить, в какой момент времени определённый блок песни проходит через фокусную зону - ещё одно изобретение для комфортного чтения текста. Собственно, та самая ситуация, когда текст тебе не нужен постоянно, но может быть нужен только в определённый момент. И он там будет!

Карту можно записывать двумя способами – с внешним источником - по аудиозаписи, если у вас, например, есть записи с репетиций, концертов или просто диктофонная запись исполнения. Второй – непосредственно внутри приложения – открывается рабочий экран с блоками, начинается процесс записи и блоки, по ходу исполнения, с помощью горизонтальной линии записи, выставляются по времени (минус способа – нужно тапать на кнопку «записи», чтобы отметить вход и выход из блока, но «разницу» можно скорректировать вручную)

А ещё, в нём есть метроном. Просто факт. Потому что это была просьба первого человека, который воспользовался приложением. Сначала я сделал его через tone generator, звучало как будто кто-то ритмично нажимает кнопки на телефоне. В последствии, был улучшен с помощью двух звуков деревянного блока – один клик и один акцент, благодаря этому можно ввести любые ритмические рисунки, но пока в нём только 3/4 и 4/4.

А ещё, по просьбе пользователя появилась функция «Галя, у нас отмена!» в редакторе текстов. Раньше если ты ошибся, то ты ошибся, но теперь всегда можно откатиться. Удивительно, но я не замечал этого простого недостатка уровня слона... потому что пользовался импортом своих подготовленных файлов из txt.

Что произошло за месяц

На текущий момент идёт второй месяц разработки. И я понял, что вайб-кодинг значительно упрощает работу, при условии, что вы знаете над чем работаете. А вот разработка в целом – не настолько простая вещь. За этот период я успел попробовать себя в роли продакт-менеджера, UX/UI-дизайнера, архитектора, тестировщика, технического писателя, аналитика, маркетолога, бренд-стратега, SMM-щика, копирайтера, комьюнити-менеджера, специалиста по публикации приложений, исследователя конкурентов и иногда — психолога собственного проекта. В общем, за короткий период я, можно сказать, прошёл практический курс по продуктовой разработке. А ещё, поверил в то, что можно делать хорошие вещи не только для себя.

Что дальше

К чему дальше движется проект StageLyrics? Сейчас я пытаюсь разобраться с регистрацией в Google Play Console, но несмотря на это, я считаю, что приложение должно быть доступным. Поэтому, если я и осилю этот этап, возможность скачать apk бесплатно останется, а покупка в приложении будет просто способом отблагодарить автора. А ещё, можно отблагодарить добрым словом, честным отзывом или сообщением о баге. Также, думаю о локализации.

А вот не планируется и не будет планироваться превращение инструмента в музыкальный сервис с подписками, аккаунтами и прочими прелестями, которые когда-то оттолкнули меня от других приложений.

Финал

Хочется пожелать всем, кто связан с музыкой и исполнением (да и тем, кто не связан, тоже, чего уж там) успехов в творчестве, будьте смелыми, уверенными и продолжайте делать этот жесткий мир более прекрасным!

"Извинитес, это телеграм"

Если вам интересно скачать приложение и познакомиться с ним, следить за судьбой проекта или просто поддержать «присутствием», можете вступить в тг-чат приложения t.me/stagelyrics

Если хотите просто познакомиться с приложением, но не заходить в тг-чат, я подготовил альтернативные варианты – Яндекс Диск и Google Drive:

Яндекс: https://disk.yandex.ru/d/b84KKMClTOo_gg

Google: https://drive.google.com/file/d/1VqerprHKF8UHM_1zyUPdt-WH5KC...

Почему не GitHub? Честно, я пока ещё не умею, но, надеюсь, что и с этим справлюсь!

Спасибо за ваше внимание! И если StageLyrics поможет хотя бы нескольким музыкантам чувствовать себя спокойнее на сцене — значит, всё это время прошло не зря.

P.S. Маленький бонус, я сделал небольшой demopack, чтобы вы могли без труда посмотреть функционал. Внутри песни из моего сольного проекта с настроенными картами, вы можете открыть песню на любой площадке и посмотреть, насколько точно работает синхронизация. Загрузить demopack можно с помощью импорта резервной копии в настройках приложения.

P.P.S. Это моё первое приложение, но, надеюсь, что не последнее

• можно создать несколько зон;

• перетащить зону куда удобно;

• растянуть за угол;

• выбрать действие;

• поставить пресет;

• очистить всё и вернуться к обычной схеме.

Из действий есть листание вперёд/назад, меню, закладки, оглавление, яркость плюс/минус, TTS, выход из приложения и “ничего”.

“Ничего” оказалось не шуткой. Иногда реально нужна область экрана, которая не делает ничего. Например, если туда часто случайно попадаешь при чтении.

Отдельно пришлось решать пересечения.

Например, можно сделать большую зону “вперёд” почти на весь правый край, а поверх неё маленькую зону “меню” в углу. Тогда возникает вопрос: если тап попал сразу в обе зоны, кто победил?

Я сделал правило простым: побеждает меньшая зона. Обычно маленькую область ставишь специально, а большая работает как фон.

Самая неприятная часть была не в математике прямоугольников, а в жестах.

В Compose зона могла начать перетаскиваться, потом интерфейс пересобирался, pointerInput перезапускался, и drag срывался прямо во время движения. Визуально это выглядело так, будто блок просто отлип от пальца.

Починилось через стабильные ключи для зон. Без key Compose начинал путать элементы при изменении порядка отрисовки, особенно когда выбранная зона поднималась поверх остальных.

В итоге фича получается больше, чем я ожидал. Не просто «тап слева/справа», а маленький редактор управления чтением. Выйдет в следующем обновлении.

Параллельно в последних версиях уже завезено: полка «Читаю», дробные проценты прогресса, PDF-фильтры, кроп, контраст, настройка карточек в библиотеке и фиксы для больших библиотек.

Но тап-зоны сейчас, наверное, самая заметная штука именно в интерфейсе чтения.

MRead бесплатный, без рекламы. GitHub использую как страницу релизов: APK, changelog и контрольные суммы.

Скачать, посмотреть changelog и закинуть баг/идею удобнее всего через канал - там же все ссылки на сторы в закрепе:

https://t.me/mread_app

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

Что появилось в версии 0.4.0

Главное изменение с прошлой версии - история завершенных тренировок. Теперь завершенные тренировки можно посмотреть в отдельном разделе в формате календаря по дням.

Для каждой записи есть подробности:

• итоговое время;

• количество кругов;

• отдых между кругами;

• состав интервалов;

• финишный пульс, если во время тренировки был подключен пульсометр.

Также в новой версии переработан "Ритм" - бывший "Темп". В 0.3.0 в приложении можно было задать темп в BPM. Теперь ритм можно задать либо напрямую в BPM, либо через количество повторов за интервал и приложение само посчитает нужный темп, исходя из количества повторов и длительности рабочего интервала. Для звука ритма можно выбрать стандартный тик или одну из сохраненных голосовых записей.

Почему скрипты, если ИИ "может делать все сам"?

В первых версиях многое из рутины делалось руками: ввод команд для сборки APK, перекидывание файла на телефон, установка, скриншоты и т.д. Но с развитием проекта эти процессы стали занимать все больше времени. Особенно когда надо протестировать на телефоне очередные небольшие изменения.

Следующий этап был через промпты для агента. Я уже не вводил все команды руками, а писал агенту: собери приложение, установи на телефон, сделай набор скриншотов и т.д. Это уже было удобнее, но все равно оставалось больше ручным процессом, чем автоматизацией. И при этом периодически случались косяки, особенно на сложных операциях вроде подготовки скриншотов для релиза.

Очевидным следующим шагом стали скрипты. Действия, которые можно полностью или почти полностью автоматизировать, лучше четко описать один раз в скрипте, а агента потом просить запускать уже готовые команды.

Какие скрипты сейчас используются

Сейчас скрипты помогают автоматизировать часть релизной рутины, а именно:

• заливают тестовые данные в debug-версию приложения: тренировки, интервалы, настройки пульса, ритм и историю тренировок;

• проверяют обновление с предыдущей версии на новую. Для 0.4.0 это был сценарий 0.3.0 -> 0.4.0: поставить старую версию, заполнить ее данными, обновить поверх и убедиться, что ничего не потерялось;

• собирают список UI-элементов из Compose-кода и обновляют карту координат на реальном телефоне, чтобы сценарии скриншотов не зависели от ручных нажатий;

• снимают скриншоты по заранее описанному плану: открывают нужные экраны, проверяют ожидаемый текст, делают исходный скриншот и готовят копию для RuStore;

• собирают release APK, проверяют подпись, архивируют файл, считают SHA256 и сохраняют build-info.md и checksums.txt в релизный пакет.

Проверка обновления

Самый важный сценарий для 0.4.0 - проверка обновления с предыдущей публичной версии. Для этого скрипт устанавливает специальную debug-сборку 0.3.0, заливает в нее тестовые данные, а потом ставит 0.4.0 поверх старой версии без очистки данных.

Задача простая: убедиться, что после обновления у пользователя ничего не пропадет и не сломается.

После обновления скрипт проверяет, что приложение запускается, тренировки видны и открываются, а новые поля базы получили безопасные значения по умолчанию.

И только после этого добавляются данные, которые появились уже в 0.4.0: история завершенных тренировок за разные дни, подробности истории и т.д. То есть скрипт не просто заливает демо-данные, а прогоняет почти весь релизный сценарий обновления.

Скрипт для скриншотов

Один из самых муторных процессов перед релизом - скриншоты. Для стора нужны скриншоты конкретных экранов с нормальными данными: главный экран, редактор тренировок, активный таймер, история и т.д.

Раньше это делалось руками: открыл экран, сделал скриншот, перешел дальше, снова сделал скриншот, потом перекинул файлы на комп.

Потом процесс стал полуавтоматическим: я просил агента подготовить план и сделать скриншоты. Сначала в режиме подтверждения - я подтверждал, что нужный экран открыт, после чего он делал скриншот. А потом пытался сразу промптом попросить его сделать план и пройти по нему полностью автоматически. Но без скрипта это выглядело грустно: медленно и с косяками.

Третий этап (сейчас) это уже делается скриптами.

После того, как debug-версия получает тестовые данные через adb run-as, происходит следующий этап - собирается карта интерфейса. Один скрипт проходит по Compose-коду и формирует список UI-элементов, которые могут понадобиться для сценариев съемки. Затем другой скрипт через uiautomator dump читает текущий экран на реальном телефоне, находит нужные элементы, снимает их точные координаты и собирает итоговую карту интерфейса.

Упрощенно схема такая:

• список возможных UI-элементов

• выбранные элементы для съемки

• реальные координаты на устройстве

• сценарий скриншотов

Дальше используется сам план съемки. В нем указываются не координаты, куда нужно нажать, а более глобально: "на экране main нажать control history, дождаться заголовка История тренировок, сделать скриншот 04-workout-history-calendar.png". Координаты подставляются уже из карты.

Дальше скрипт проверяет, что на экране появился ожидаемый текст, делает screencap, сохраняет исходный PNG в screenshots/raw, а затем готовит копию для RuStore.

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

Что дала автоматизация

Во-первых, стало существенно меньше ручной рутины. Перед релизом есть понятная цепочка: подготовить данные, проверить миграцию, снять скриншоты, собрать release, проверить подпись, архивировать APK, сохранить checksum и build info.

Во-вторых, стало проще работать с ИИ-агентом. Когда действие описано словами вроде "подготовь релиз", агент может угадать не все шаги, сделать их в неудобном порядке или вообще накосячить. А когда есть конкретные скрипты, задача становится гораздо точнее: запусти такой-то сценарий, проверь такой-то файл, обнови такой-то пакет.

Что в планах

В ближайших планах по развитию приложения:

• показывать во время тренировки не только пульс, но и пульсовую зону;

• добавить в историю тренировок график пульса с зонами, наложенный на интервалы;

• сделать полный бэкап и восстановление данных, потому что сейчас импорт/экспорт покрывает только тренировки, а голосовые напоминания и историю сохранить пока нельзя.

Ссылка на RuStore Интервальный Таймер.

🔊 Озвучивание (TTS)

Вынес в отдельную кнопку. Выбор голоса, скорость и тон, таймер сна, автопереход страниц и пауза, которая запоминает, где вы остановились.

📚 Словарь и Anki

Выделенное слово можно отправить во внешний словарь, который у вас установлен. А в экспорт карточек Anki теперь попадает ещё и контекст предложения, а не просто слово.

🛠 Чтение и библиотека

• Регулируемый межабзацный интервал и стили Bold/Italic

• Настраиваемые блоки настроек чтения, можно перетаскивать под себя

• Полоса прогресса с засечками глав

• Мягкие переносы и выравнивание по ширине

• Полки, фоновый импорт из папок, оценка книги и личные заметки

• Material You (подхватывает системную тему)

Чего пока НЕ сделал (честно):

• Поиск по сканированным PDF (без текстового слоя). Нужен OCR, это отдельная большая история.

• Подсветка и выделение прямо в PDF.

• Если у вас уже была книга FB2, её нужно переоткрыть (переимпортировать), чтобы заработали новые точные сноски. EPUB подхватит сам.

Где взять:

• RuStore

• GitHub

• 4PDA

Отдельное спасибо тем, кто закинул донат. Я не прошу денег за приложение и не планирую, поэтому каждая копейка от вас это чисто знак, что делаю не зря. Спасибо.

И спасибо всем за идеи, баг-репорты и поддержку. Половина этого обновления выросла из ваших комментариев и issue на гитхабе.