reauthor 2.6.0
==============

(English first; Russian below / сначала английский, русский ниже.)


ENGLISH
-------

What it is
  Author a complete SACD image from your own audio files: stereo only,
  multichannel only, or both areas on one disc. The program builds every service
  structure the format needs (the tables of contents, the track lists, the text)
  and, if you choose, the file system as well. It always compresses the
  multichannel area to lossless DST, and the stereo area too if you wish. The
  program reads the finished image again, checking it against the standard. Only
  then does it report that everything is done.

  The program takes DSD64 in .dff or .dsf files, one file per track, or an
  Edited Master - a DSDIFF master: one file holding a whole area, with the track
  boundaries marked inside it.

  Disc and track text can be written in several languages at once: up to eight,
  each in a character set the standard allows.

  There are pauses between tracks, indexes inside a track, each track's own
  performer, composer, songwriter and ISRC, area text, and on a version 1.30
  disc web links too. Everything that concerns version 1.30 discs is done fully
  to the SACD specification, but has not been tested: no such discs have come
  our way yet.

  The program places the channels of a multichannel file from the channel names
  inside the file and from the sound itself, and you check the result. If a
  channel carries no music, only faint noise left by a conversion to DSD, the
  program offers to write the standard's silence there instead - the choice is
  yours.

  On startup the program checks whether a newer version is out (this can be
  turned off in Settings).

  The whole program is one Windows .exe file: no install and no external tools.
  A separate command-line version for scripting is included too
  (reauthor-cli.exe).

Requirements
  - Windows 10 or 11, 64-bit.
  - A processor from about 2010 or newer. On an older processor the program does
    not start, and a Windows message names the processor instruction sets that
    are missing.
  - The Microsoft Edge WebView2 runtime. Up-to-date Windows already has it:
    Windows Update installs it.

How to use
  1. Run reauthor-gui.exe.
  2. Disc: choose what the disc holds: stereo only, multichannel only, or stereo
     plus multichannel. The folder for finished images is chosen here too. The
     program makes the image name from the mask in Settings; the name is shown
     on the Review step, and the "Change name..." button there changes it.
  3. Audio: drag .dff or .dsf files into the program window, or add a whole
     folder. To keep stereo and multichannel apart, add a folder per area. The
     program checks each file at once and marks it by colour.

     The program places the channels of a multichannel file by the channel names
     inside the file and checks them against the sound; beside each channel you
     see what it recognised there. If something does not match, the program asks
     you - about each file on its own. Your answer is carried over to another
     file only when that file is built the same way: the same number of
     channels, the same names in the same order, silence and LFE in the same
     channels.

     The ordinary check listens to a track in 24 places. The
     "Check the whole track" button analyses all of it and names the channels
     that are silent for the whole track, and the LFE channel.

     In the stereo area you can swap the channels, and put mono into both
     channels. By default the stereo area is written uncompressed. If you turn
     on DST compression, you can choose its level: maximum, high, fast or turbo.
     Compression is lossless whichever you pick: the choice changes only the
     build time and the image size.
  4. Metadata: only the album title is required. Artist, publisher, year,
     catalogue number and the rest are what a player shows.
  5. Tracks: each track gets a title and, if you want, a pause before it,
     indexes inside it, and its own performer, composer, songwriter and ISRC. If
     the disc has two areas, each has its own track list, in its own tab.
  6. Review: read the summary and press "Build the disc". Before the build two
     lists show what has been checked and what is filled in. The program first
     checks the whole project, and then reads the finished image again and
     checks it against the standard.

Command-line version (optional)
  reauthor-cli.exe is a console version for scripting and batch work. You do not
  need it for normal use: the program window does everything. Run it from a
  terminal; "reauthor-cli --help" lists every command. It makes a project from a
  folder of audio or from an Edited Master, says which channel of a multichannel
  file is which, builds the disc, and maps a finished image field by field. It
  speaks English by default; add "--lang ru" for Russian. The image map (the
  disc-doc command) is always in English.

Data safety
  A build writes only to its own files. The program builds the image in a
  temporary file and renames it to the finished image only when everything is
  done, so a cancelled or interrupted build leaves no half-written image. An
  existing file is never replaced without your consent.

Files in this folder
  - reauthor-gui.exe            the application (run this)
  - reauthor-cli.exe            command-line version (optional, for scripting)
  - CHANGELOG.txt               version history (English and Russian)
  - LICENSE.txt                 license terms
  - THIRD_PARTY_LICENSES.txt    licenses of the third-party components used

License
  Free, for personal use - use it, copy it, share it. Selling it and any
  commercial use are forbidden. See LICENSE.txt for the full wording and the
  "as is" / no-warranty notice. Third-party components and their licenses are in
  THIRD_PARTY_LICENSES.txt.

Author
  Oskar Iossad - e-mail: reauthor@foreigner.cc
  Built with Tauri (Rust + WebView2). If reauthor saved you time and you liked
  the result, a thank-you is welcome - entirely optional:

    PayPal          paypal.me/losinka
    Card or wallet  https://buy.stripe.com/aFa14p7ZI5bS6SSfezao800

  The second link takes cards, Apple Pay and Google Pay. If the user has a local
  wallet, such as Alipay or WeChat Pay, it offers that too. The heart at the
  bottom right of the program window opens the same two options, and they are
  printed at the end of "reauthor-cli --help".


РУССКИЙ
-------

Что это
  Сборка готового образа SACD из ваших звуковых файлов: только стерео, только
  мультиканал или обе области на одном диске. Программа строит все служебные
  структуры, которых требует формат (оглавления, списки треков, тексты), а по
  вашему выбору - и файловую систему. Звук мультиканальной области она всегда
  сжимает в DST без потерь, стерео - по желанию. Готовый образ программа
  перечитывает, проверяя его по стандарту. И только потом сообщает, что всё
  готово.

  Программа принимает DSD64 в файлах .dff или .dsf, по файлу на трек, или Edited
  Master - сведённый мастер DSDIFF: один файл на всю область с отметками границ
  треков внутри.

  Тексты диска и треков можно написать сразу на нескольких языках: до восьми,
  каждый в своей кодировке из разрешённых стандартом.

  Есть паузы между треками, индексы внутри трека, у каждого трека - свои
  исполнитель, композитор, автор слов и ISRC, тексты области, а на диске версии
  1.30 - ещё и веб-ссылки. Всё, что касается дисков версии 1.30, сделано
  полностью по спецификации SACD, но не проверялось: такие диски пока не
  попадались.

  Каналы мультиканального файла программа расставляет по подписям в файле и по
  самому звуку, а вы проверяете. Если в канале нет музыки, только слабый шум
  после перевода в DSD, программа предложит записать туда тишину по стандарту -
  решаете вы.

  При запуске программа проверяет, не вышла ли новая версия (проверку можно
  выключить в настройках).

  Вся программа - один файл .exe для Windows: без установки и без внешних
  программ. В комплекте есть и отдельная консольная версия для скриптов
  (reauthor-cli.exe).

Требования
  - Windows 10 или 11, 64-разрядная.
  - Процессор примерно 2010 года выпуска или новее. На более старом процессоре
    программа не запустится, а окно Windows назовёт, каких наборов команд
    процессора не хватает.
  - Среда выполнения Microsoft Edge WebView2. В актуальной Windows она уже есть:
    её ставит Windows Update.

Как пользоваться
  1. Запустите reauthor-gui.exe.
  2. Диск: выберите, что будет на диске: только стерео, только мультиканал или
     стерео и мультиканал. Здесь же выбирается папка для готовых образов. Имя
     образа программа составит по маске из настроек; оно видно на шаге
     «Проверка», и там же его можно поменять кнопкой «Изменить имя...».
  3. Аудио: перетащите файлы .dff или .dsf в окно программы или добавьте папку
     целиком. Чтобы стерео и мультиканал не смешались, добавьте для каждой
     области свою папку. Каждый файл программа проверяет сразу и отмечает
     цветом.

     Каналы мультиканального файла программа расставляет по подписям в файле и
     сверяет со звуком; рядом видно, что она распознала в каждом канале. Если
     что-то не сходится, программа спросит вас - о каждом файле отдельно. Ваш
     ответ переносится на другой файл, только если тот устроен так же: столько
     же каналов, те же подписи в том же порядке, тишина и LFE в тех же каналах.

     Обычная проверка слушает трек в 24 местах. Кнопка «Проверить весь трек»
     проанализирует его целиком и назовёт каналы, которые молчат весь трек, и
     канал LFE.

     В стереообласти можно поменять каналы местами, а моно записать в оба
     канала. По умолчанию стерео пишется без сжатия. Если включить сжатие в DST,
     можно выбрать, какое: максимальное, высокое, быстрое или турбо. Сжатие в
     любом случае без потерь: от выбора зависят только время сборки и размер
     образа.
  4. Метаданные: обязательно только название альбома. Исполнитель, издатель,
     год, номер по каталогу и остальное - то, что покажет проигрыватель.
  5. Треки: у каждого трека - название, а если нужно - пауза перед ним, индексы
     внутри и свои исполнитель, композитор, автор слов и ISRC. Если на диске две
     области, у каждой свой список треков, на своей вкладке.
  6. Проверка: прочитайте сводку и нажмите «Собрать диск». Перед сборкой видны
     два списка: что проверено и что заполнено. Сначала программа проверяет весь
     проект, а готовый образ перечитывает и сверяет со стандартом.

Консольная версия (по желанию)
  reauthor-cli.exe - консольная версия для скриптов и пакетной обработки. Для
  обычной работы она не нужна: окно программы умеет всё. Запускается из
  командной строки; «reauthor-cli --help» перечисляет все команды. Она делает
  проект из папки со звуком или из Edited Master, говорит, какой канал
  мультиканального файла какой, собирает диск и расписывает готовый образ по
  полям. По умолчанию она пишет по-английски; для русского добавьте «--lang ru».
  Роспись образа по полям (команда disc-doc) всегда выводится по-английски.

Сохранность данных
  Сборка пишет только в свои файлы. Программа собирает образ во временном файле
  и переименовывает его в готовый образ, только когда всё сделано, поэтому
  отменённая или прерванная сборка не оставит недописанного образа. Существующий
  файл программа без вашего согласия не заменит.

Файлы в этой папке
  - reauthor-gui.exe            программа (запускать её)
  - reauthor-cli.exe            консольная версия (по желанию, для скриптов)
  - CHANGELOG.txt               история версий (на английском и русском)
  - LICENSE.txt                 условия лицензии
  - THIRD_PARTY_LICENSES.txt    лицензии сторонних компонентов

Лицензия
  Бесплатно, для личного использования - пользуйтесь, копируйте, делитесь.
  Продажа и любое коммерческое использование запрещены. Полный текст и оговорка
  «как есть» / без гарантий - в LICENSE.txt. Сторонние компоненты и их
  лицензии - в THIRD_PARTY_LICENSES.txt.

Автор
  Оскар Иосад - эл. почта: reauthor@foreigner.cc
  Программа сделана на Tauri (Rust + WebView2). Если reauthor сэкономил вам
  время и результат понравился, автора можно поблагодарить - исключительно по
  желанию:

    PayPal          paypal.me/losinka
    Карта, кошелёк  https://buy.stripe.com/aFa14p7ZI5bS6SSfezao800

  Вторая ссылка принимает карты, Apple Pay и Google Pay. Если у пользователя
  есть местный кошелёк, например Alipay или WeChat Pay, она предложит и его.
  Сердечко внизу окна программы, справа, открывает те же два способа; они же
  напечатаны в конце «reauthor-cli --help».
