SACD ISO Patcher 2.12.0
=======================

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


ENGLISH
-------

What it is
  Edit metadata right inside an SACD ISO image, without rebuilding the disc:
  album, disc and track titles, artists, publishers, copyright, catalogue
  numbers, release date, genres, ISRC, and each area's description and
  copyright - in several languages. A disc with two areas, stereo and
  multichannel, is edited in two tabs - one per area. On an SACD 1.30 disc you
  can also edit the disc and track web links and the copyright of each track.
  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 also extracts the audio to DSF/DFF, fast and bit for bit, and
  fills tags from Discogs or MusicBrainz: for each track the performer,
  composer, songwriter and arranger, and the performers with their instruments.

  When titles from the internet are Chinese, Japanese or Korean, the program
  works out the character set the disc needs and creates the matching language
  channel in one click.

  The SACD standard has no Cyrillic character set of its own. Russian letters
  exist only in the Japanese, Korean and Simplified Chinese sets, and not every
  player shows such text. So the program rewrites Russian and Belarusian titles
  in Latin letters, in one click.

  Typographic characters that the disc's character set does not hold are
  replaced with plain ones: the ellipsis "…" with three dots, the apostrophe "’"
  with a straight one, an em dash with a hyphen, and so on. This replacement can
  be turned off in Settings. Any other character outside the set is reported at
  once, next to the field.

  When the disc declares a language that holds no text at all, the program shows
  it on opening and brings the disc to standard in one click - it removes the
  empty declaration.

  An image with 2064-byte sectors can be converted to a normal ISO that opens
  and edits like any other.

  On startup the program checks whether a newer version is out. If it is, a
  "version ... available" link appears next to the program name. The check can
  be turned off in Settings. A link to the project page is in the top bar and in
  Settings.

  The "?" button in the top bar opens help at the side, on the section about
  what you are doing right now, and the fields stay in view.

  The whole program is one Windows .exe file: no install and no external tools.
  A separate command-line version for scripting is included too
  (sacd-iso-patcher-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 sacd-iso-patcher.exe.
  2. Open an SACD image (.iso) with the "Open ISO" button, or drag the file into
     the program window.
  3. Edit the fields you want: album, disc and track text, catalogue numbers,
     date, genres, ISRC, other languages. If the disc has two areas, each has
     its own tab.
  4. Press "Save changes". Before writing, the program backs up the parts of the
     image it is about to change, and the write either goes through whole or not
     at all. The "Restore backup" button puts the image back from the backup,
     byte for byte.
  5. Extract: the chosen tracks of the chosen area (stereo, multichannel or
     both) - to DSF, DFF (DSD), DFF (DST) or a DSDIFF Edit Master. The names of
     the album folder, the track files and the Edit Master file are made from
     masks in Settings; under each mask you see the name it will give. Inside
     the album folder each variant has its own subfolder, for example
     "Stereo [DFF-DST]", so different formats and areas never overwrite each
     other. If the audio on the disc is not compressed, DFF (DST) and Edit
     Master (DST) are compressed during extraction, losslessly; the Edit Master
     can also be extracted uncompressed, as it is on the disc. In a .dff file a
     track comes with the pause before it by default, and the file marks where
     the pause ends. The extract window shows the names in advance and warns at
     once if a path will be longer than Windows accepts. After extraction the
     program checks the files it wrote and reports the result in one line; a
     link opens the details and every tag the program wrote into the extracted
     files.
  6. Online data: find the release on Discogs or MusicBrainz by catalogue
     number, or by artist, or by album, or paste the release's address or number
     and press "Fetch". Then press "Apply". MusicBrainz needs no account.
     Discogs needs your own token - free, entered once in Settings.

Command-line version (optional)
  sacd-iso-patcher-cli.exe is a console version for scripting and batch work.
  You do not need it for normal use: everything is done in the program window.
  Run it from a terminal; "sacd-iso-patcher-cli --help" lists every command. It
  shows a disc's text, extracts audio, edits text (also making a backup first),
  looks up releases on Discogs and MusicBrainz, and converts an image with
  2064-byte sectors to a normal ISO. It speaks English by default; add
  "--lang ru" for Russian. The disc map (the disc-doc command) is always in
  English.

Data safety
  The program guards the disc image as the only copy there is. Before every
  write it makes a backup, and the write either goes through whole or not at
  all. A backup that cannot put the image back exactly is rejected rather than
  written. Still, keep your own copy of valued images.

Files in this folder
  - sacd-iso-patcher.exe        the application (run this)
  - sacd-iso-patcher-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 SACD ISO Patcher 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 of the program window (shown while an image is open) opens the same two
  options, and they are printed at the end of "sacd-iso-patcher-cli --help".


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

Что это
  Правка метаданных прямо в образе SACD ISO, без пересборки диска: названия
  альбома, диска и треков, исполнители, издатели, авторские права, номера по
  каталогу, дата выпуска, жанры, ISRC, а также описание и авторские права каждой
  области диска - на нескольких языках. Диск с двумя областями, стерео и
  мультиканальной, правится в двух вкладках - по одной на область. На диске SACD
  1.30 можно также править веб-ссылки диска и треков и авторские права каждого
  трека. Всё, что касается дисков версии 1.30, сделано полностью по спецификации
  SACD, но не проверялось: такие диски пока не попадались.

  Программа также быстро и бит в бит извлекает звук в DSF/DFF и заполняет теги
  из Discogs или MusicBrainz: у каждого трека - исполнителя, композитора, автора
  и аранжировщика, а исполнителей - с их инструментами.

  Если названия из интернета китайские, японские или корейские, программа сама
  определит нужную кодировку и одной кнопкой создаст подходящий языковой канал.

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

  Типографские знаки, которых нет в кодировке диска, программа заменяет
  простыми: многоточие «…» - тремя точками, апостроф «’» - прямым, длинное
  тире - дефисом и т. д. Эту замену можно выключить в настройках. О любом другом
  знаке не из кодировки программа скажет сразу, у поля.

  Если на диске объявлен язык, в котором нет ни одной записи, программа покажет
  это при открытии и одной кнопкой приведёт диск к стандарту - уберёт пустое
  объявление.

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

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

  Кнопка «?» в верхней панели открывает справку сбоку - сразу на разделе о том,
  чем вы сейчас заняты, а поля остаются на виду.

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

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

Как пользоваться
  1. Запустите sacd-iso-patcher.exe.
  2. Откройте образ SACD (.iso) кнопкой «Открыть ISO» или перетащите файл в окно
     программы.
  3. Исправьте нужные поля: тексты альбома, диска и треков, номера по каталогу,
     дату, жанры, ISRC, другие языки. Если на диске две области, у каждой своя
     вкладка.
  4. Нажмите «Сохранить изменения». Перед записью программа делает резервную
     копию тех участков образа, которые изменит, а запись проходит либо целиком,
     либо не проходит вовсе. Кнопка «Восстановить из копии» возвращает образ из
     резервной копии байт в байт.
  5. Извлечение: выбранные треки выбранной области (стерео, мультиканальной или
     обеих) - в DSF, DFF (DSD), DFF (DST) или DSDIFF Edit Master. Имена папки
     альбома, файлов треков и файла Edit Master программа составляет по маскам
     из настроек; под каждой маской видно, какое имя получится. В папке альбома
     у каждого варианта своя подпапка, например «Stereo [DFF-DST]», поэтому
     разные форматы и области не затирают друг друга. Если звук на диске не
     сжат, DFF (DST) и Edit Master (DST) сжимаются при извлечении, без потерь;
     Edit Master можно получить и несжатым, как есть. В файл .dff трек по
     умолчанию попадает вместе с паузой перед ним, и в файле отмечено, где пауза
     заканчивается. Окно извлечения заранее показывает имена и сразу
     предупреждает, если путь окажется длиннее, чем принимает Windows. После
     извлечения программа проверяет записанные файлы и сообщает итог одной
     строкой; по ссылке - подробности и все теги, которые программа
     импортировала в извлечённые файлы.
  6. Данные из интернета: найдите издание в Discogs или MusicBrainz по номеру
     каталога, или по исполнителю, или по альбому, либо вставьте адрес или номер
     издания и нажмите «Загрузить». Потом нажмите «Применить». MusicBrainz
     работает без регистрации. Для Discogs нужен ваш личный токен - бесплатный,
     вводится один раз в настройках.

Консольная версия (по желанию)
  sacd-iso-patcher-cli.exe - консольная версия для скриптов и пакетной
  обработки. Для обычной работы она не нужна: всё делается в окне программы.
  Запускается из командной строки; «sacd-iso-patcher-cli --help» перечисляет все
  команды. Она показывает тексты диска, извлекает звук, правит тексты (тоже
  сначала сделав резервную копию), ищет издания в Discogs и MusicBrainz и
  переводит образ с секторами по 2064 байта в обычный ISO. По умолчанию она
  пишет по-английски; для русского добавьте «--lang ru». Карта диска (команда
  disc-doc) всегда выводится по-английски.

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

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

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

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

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

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