SACD ISO Patcher 2.4.0
======================

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


ENGLISH
-------

What it is
  Edit metadata inside SACD ISO images in place, without re-authoring the disc -
  album/disc/track titles, artists, publishers, copyright, catalog numbers,
  release date, genres and ISRC, in multiple languages. Hybrid discs whose
  stereo and multichannel areas differ are edited area by area. It also extracts
  audio to DSF/DFF - fast, and bit-exact - and can auto-fill tags (including
  per-track performer/composer/songwriter/arranger credits, performers with
  their instruments) from Discogs or MusicBrainz. When the imported titles are
  Chinese, Japanese or Korean, it detects the text encoding the disc needs
  (Shift-JIS, GB, Big5, KSC) and offers to create the matching language channel
  in one click. Discs made by some SACD-R tools that declare a text channel but
  leave it empty are flagged when opened and can be brought up to standard in
  one click. A single self-contained Windows .exe - no install, no external
  tools required. A separate command-line version is included for scripting
  (sacd-iso-patcher-cli.exe).

Requirements
  - Windows 10/11, 64-bit.
  - Microsoft Edge WebView2 runtime (present on up-to-date Windows; installed
    automatically by Windows Update / most systems already have it).

How to use
  1. Run sacd-iso-patcher.exe.
  2. Open an SACD .iso (File - Open, or drag and drop).
  3. Edit the fields you want (album/disc/track text, catalog numbers, date,
     genres, ISRC, extra languages). On a hybrid disc whose two areas differ,
     edit each area on its own tab.
  4. Save. A backup of every sector the write touches is made first, so the
     image is never corrupted - a save is either fully applied or not applied
     at all. Use Restore to roll a backup back, byte-for-byte.
  5. Extract: export tracks to DSF, DFF (DSD), DFF (DST) or a DSDIFF Edit Master,
     by layer (Stereo / multichannel) and selected tracks. Everything goes into
     one album folder ("Artist - Album (Year)"), with a separate subfolder per
     variant (for example "Stereo [DFF-DST]"), so different formats and layers
     never overwrite each other and track names stay clean. For a plain-DSD disc
     (no DST), the DFF (DST) export - and the Edit Master (DST) option - encode
     the DSD into lossless DST on the fly; such a disc also offers the Edit
     Master as the as-is uncompressed DSD.
  6. Online metadata: search Discogs or MusicBrainz by catalog number / barcode
     or by artist + album, or fetch by a direct release ID/URL, then Apply.
     MusicBrainz needs no account; Discogs lookup needs your own free Discogs
     API token (enter it 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, the app does everything with a window. Run
  it from a terminal; "sacd-iso-patcher-cli --help" lists every command with
  examples. It can show a disc's metadata, extract audio, edit metadata (always
  making a backup first, just like the app), and look up releases on Discogs /
  MusicBrainz. English by default; add "--lang ru" for Russian.

Data safety
  The disc image is treated as an irreplaceable copy. Every write is backed up
  first and is all-or-nothing; a backup that cannot restore byte-for-byte is
  rejected rather than written. Keeping your own copy of valued rips is always
  wise.

Files in this folder
  - sacd-iso-patcher.exe        the application (run this)
  - sacd-iso-patcher-cli.exe    command-line version (optional, for scripting)
  - CHANGELOG.md                version history (English and Russian)
  - LICENSE.txt                 license terms
  - THIRD_PARTY_LICENSES.md     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.md.

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: paypal.me/losinka


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

Что это
  Правка метаданных внутри образов SACD ISO на месте, без переавторинга диска -
  названия альбома/диска/треков, исполнители, издатели, копирайт, каталожные
  номера, дата выпуска, жанры и ISRC, на нескольких языках. Гибридные диски, у
  которых стерео- и многоканальная области различаются, правятся по областям.
  Также извлечение аудио в DSF/DFF - быстрое и побитово точное - и
  автозаполнение тегов (включая потрековые исполнитель/композитор/автор/
  аранжировщик, исполнители с инструментами) из Discogs или MusicBrainz. Если
  импортируемые названия на китайском, японском или корейском, приложение
  определяет нужную диску кодировку (Shift-JIS, GB, Big5, KSC) и одной кнопкой
  предлагает создать подходящий языковой канал. Диски от некоторых программ
  авторинга SACD-R, где текстовый канал заявлен, но пуст, помечаются при
  открытии и одной кнопкой приводятся к стандарту. Один самодостаточный .exe для
  Windows - без установки и без внешних программ. В комплекте также отдельная
  консольная версия для скриптов (sacd-iso-patcher-cli.exe).

Требования
  - Windows 10/11, 64-бит.
  - Среда выполнения Microsoft Edge WebView2 (есть в актуальной Windows;
    ставится автоматически через Windows Update / у большинства уже есть).

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

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

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

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

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

Автор
  Oskar Iossad - e-mail: reauthor@foreigner.cc
  Создано на Tauri (Rust + WebView2).
  Если SACD ISO Patcher сэкономил вам время и результат понравился -
  благодарность приветствуется: paypal.me/losinka
