SongLL 1.0 — независимый форк SongLyr 3.16
============================================

Установка
---------
1. Дважды нажмите Install.command.
2. Если macOS блокирует запуск: System Settings -> Privacy&Security -> скролл вниз -> Разрешить запуск SongLL.
3. Софт установится в папку приложений текущего пользователя: ~/Applications/SongLL.app. SongLyr не удаляется и продолжает работать независимо.

Обе программы можно держать установленными одновременно. Не запускайте SongLL
и SongLyr одновременно: они управляют одними и теми же QuickTime Player и Preview.

Первый запуск
-------------
Разрешите приложению:
- «Универсальный доступ» — для переключения песен стрелками при открытом Preview;
- управление QuickTime Player;
- управление Preview («Просмотр»).

После предоставления «Универсального доступа» закройте и снова запустите SongLL.

Использование
-------------
1. Запустите SongLL и выберите любую песню MP3/WAV.
2. Приложение соберёт все MP3 и WAV из той же папки в алфавитный список.
3. Для каждой песни ищется JPG, JPEG или PNG с тем же именем:

   01 - Song.mp3
   01 - Song.png

Картинка необязательна. Если её нет, песня просто воспроизводится в QuickTime
Player без запуска Preview. Переключение стрелками и автоматическое закрытие
QuickTime после окончания работают как обычно.

Управление
----------
←     назад на 10 секунд
→     вперёд на 10 секунд
↑     предыдущая песня
↓     следующая песня
Esc   остановить песню и закрыть окна
Space пауза / продолжить с того же места
⌘Q    закрыть QuickTime/Preview и завершить SongLL
⌘O    закрыть текущую песню/картинку и открыть меню выбора песни

Стрелки и пробел работают, когда впереди находится SongLL, Preview,
QuickTime Player или Logic Pro. В остальных программах они остаются обычными
клавишами. Когда режим Logic включён, сразу после открытия песни и картинки SongLL активирует уже запущенный
Logic Pro. Программа проверяет результат и при необходимости повторяет активацию
несколько раз, не прерывая воспроизведение. Preview с текстом остаётся видимым.
Поддерживаются названия Logic Pro.app и Logic Pro Creator Studio.app, а также
переименованный файл Logic: SongLL определяет запущенное приложение и использует
его фактический путь.
Важно: macOS также передаёт эти клавиши самому Logic. Если они вызывают в Logic
нежелательные действия (например, Space запускает транспорт), уберите эти
назначения в Key Commands Logic перед концертом.
Комбинации ⌘O и ⌘Q работают независимо от того, какое из этих четырёх приложений
находится впереди. При ⌘O SongLL сначала закрывает свои окна QuickTime и Preview,
а затем показывает меню выбора. Если нужен поиск, после появления окна можно нажать обычное системное ⌘F; SongLL его не перехватывает.

Режим Logic
------------
В меню «Режим» находится пункт «Работать вместе с Logic Pro»:
- галочка включена — после открытия песни активируется Logic, а стрелки и пробел
  SongLL работают при активном окне Logic;
- галочка выключена — Logic не активируется и клавиши в Logic не перехватываются.

Выбор запоминается между запусками SongLL. При первом запуске режим Logic включён.
Настройка SongLL не влияет на SongLyr.

При переключении песни программа сначала закрывает и проверяет старые документы,
а только затем открывает новые. QuickTime и Preview не перезапускаются между
соседними песнями — это предотвращает одновременное воспроизведение двух треков.

Быстрые повторные нажатия ←/→ складываются и отправляются QuickTime одной
командой после короткой паузы. Например, три быстрых нажатия → перематывают
на 30 секунд. Это устраняет конфликт, из-за которого QuickTime мог выдавать
ошибку при частой перемотке.

Открытые документы отслеживаются по внутреннему ID и фактическому пути файла,
а не только по отображаемому имени. Символы / и :, встроенные теги и особенности
отображения имени в QuickTime/Preview не должны мешать закрытию.

После естественного окончания песни приложение автоматически закрывает открытые
им документы и завершает Preview/QuickTime Player, если в них больше нет других
документов. Затем активируется SongLL. Контроллер остаётся запущенным, поэтому стрелкой можно сразу открыть
следующую или предыдущую песню.

-------------

Софт написан на Javascript. Установщик использует встроенный в macOS osacompile. Xcode и Command Line Tools не нужны.
