MG Song Renderer & Converter 1.0.24
=====================

Renoise 3.5.4 / API 6 / Windows

Features
--------
- Exports the complete song as MP3, FLAC, or OGG Vorbis.
- Destination folder and filename templates, with an option to follow each saved song's folder.
- Tokens: {song}, {title}, {artist}, {composer}, {by}, {date}, {time}, {format}.
- Ask, overwrite, or auto-number existing files.
- Selectable sample rate and stereo/mono output.
- MP3 VBR quality or CBR bitrate.
- FLAC compression level and 16/24-bit output.
- OGG Vorbis quality or target bitrate.
- Title, artist, and album metadata.
- Renoise render progress and FFmpeg conversion progress.
- Rendered-WAV waveform and optional encoded-file waveform.
- Red markers for analysis blocks whose decoded peak is above 0 dBFS.
- First clipping positions and peak dBFS summaries.

Encoder files
-------------
The XRNX package contains an encoder installer rather than pre-downloaded binary
files. Open the tool and click "Install / Repair Encoder". It first downloads the current BtbN Windows 64-bit shared LGPL FFmpeg build
and places ffmpeg.exe plus its DLL dependencies in the user's local legacy MG Audio Exporter data folder. If
that archive is unavailable, it falls back to Gyan's static essentials build.

Analysis accuracy
-----------------
Clipping positions are analyzed in 1024-frame blocks. At 48 kHz this gives about
21 ms placement resolution. The rendered source is kept at 32-bit depth for the
analysis stage so over-0 dBFS values can be detected before conversion.


1.0.1 changes
-------------
- Replaced the unsupported ViewBuilder progressbar with a Renoise API 6 compatible read-only slider.


Version 1.0.2
- Fixed external-job completion polling caused by Lua string.gsub returning a second value.
- Added validation for partially written exit-code and process-ID files.


Version 1.0.3
- Fixed blank waveform displays by keeping generated bitmaps inside the tool bundle and passing relative bitmap paths to Renoise.
- Uses a fresh bitmap filename for each update so Renoise does not reuse a cached placeholder.
- Explicitly uses plain bitmap drawing and a higher-visibility peak waveform.


Version 1.0.4
- Doubled both waveform display heights from 100 px to 200 px.


Version 1.0.5
- Fixed continuous Renoise tool reloads during waveform drawing and FFmpeg installation.
- Runtime waveform bitmaps and downloaded encoder files now live outside the watched XRNX tool folder.
- Kept unique absolute waveform filenames to avoid cached/blank bitmap updates.
- Removed dialog cleanup based on temporary visibility loss, so switching away from Renoise no longer closes the exporter.
- Existing FFmpeg files from older tool-folder installations remain usable as a read-only fallback.


Version 1.0.6
- Made the Export Settings and Waveform Analysis pages use identical fixed dimensions.
- Removed the unused strip on the right by matching the dialog width to the actual section content.
- Changed all section columns from style "group" to style "body".


Version 1.0.7
- Made the dialog open immediately by using one bundled placeholder waveform instead of generating and deleting large bitmaps before showing the window.
- Removed an unnecessary command-shell directory check from encoder status lookup.
- Added a default-enabled Song folder option that follows the current saved XRNS location; unsaved songs fall back to the Music folder.
- Added filename and metadata tokens for Renoise song title and the By field: {title}, {artist}, {composer}, and {by}.
- Metadata Title and Artist now default to {title} and {artist}.


Version 1.0.8
- Increased the shared fixed page height to 600 px so both Export Settings and Waveform Analysis fit inside the same exact dialog dimensions without either page forcing the window taller.

Version 1.0.9
- Exposed COLUMN_STYLE in the editable styling constants and routed all styled vb:column containers through it.

Version 1.0.12
- Locks both tab pages inside the same fixed-height page host so switching between Export Settings and Waveform Analysis cannot resize the dialog.
Version 1.0.13
- Forces all codec settings panels to the same full section width, including MP3.


Version 1.0.14
- Uses a Renoise 3.5 stack page host so both tabs occupy the exact same fixed rectangle and switching tabs can no longer change the dialog height.
- Sets the exposed COLUMN_STYLE constant to "group".

Automatic waveform and peak analysis is disabled by default. Enable Analyze rendered WAV and/or Analyze encoded file in the export settings when needed. Loading an external audio file remains an explicit manual analysis action.

External audio analysis:
- Use Load Audio File to analyze WAV, MP3, FLAC, or OGG without importing it into the song.
