MAKING SENSE DOWNLOADER v2
==========================

SETUP (WINDOWS)
---------------
1. Keep MakingSenseDownloader-v2.ps1 and Run-MakingSenseDownloader.cmd in
   the SAME folder (for example Downloads).
2. Install FFmpeg and FFprobe if not already installed. You already have
   FFmpeg through Scoop; FFprobe usually comes with the same package.
3. Review the script and double-click Run-MakingSenseDownloader.cmd.
4. Use the interactive menu to select an episode range, Opus quality,
   whether to keep MP3s, the output folder and optional cover artwork.

The .cmd launcher uses -ExecutionPolicy Bypass ONLY for the new PowerShell
process it starts. It does not change your persistent execution policy.
An organisation-managed computer may still block it through Group Policy.

DIRECT COMMANDS (FROM POWERSHELL)
---------------------------------
Note: Direct .ps1 execution may require your usual execution-policy permission.

& "$HOME\Downloads\MakingSenseDownloader-v2.ps1" -Mode Preview -From 1 -To 500
& "$HOME\Downloads\MakingSenseDownloader-v2.ps1" -Mode Download -From 14 -To 440 -Opus -OpusBitrate 64 -DeleteSource
& "$HOME\Downloads\MakingSenseDownloader-v2.ps1" -Mode Update -Opus -OpusBitrate 64 -DeleteSource
& "$HOME\Downloads\MakingSenseDownloader-v2.ps1" -Mode RetryFailed -Opus -OpusBitrate 64 -DeleteSource
& "$HOME\Downloads\MakingSenseDownloader-v2.ps1" -Mode Gaps -From 1 -To 500
& "$HOME\Downloads\MakingSenseDownloader-v2.ps1" -Mode Stats

Or from CMD:
Run-MakingSenseDownloader.cmd -Mode Download -From 14 -To 440 -Opus -OpusBitrate 64 -DeleteSource

RSS FEED
--------
The script keeps the feed address used by the older downloader for
compatibility. That feed may be outdated or expire. Supply a current RSS
URL that you have permission to use through -FeedUrl YOUR_URL.
The downloader cannot retrieve episodes missing from that feed.

DOWNLOAD SAFETY
---------------
- HTTP range resume only works if the server supports it.
- .part files with matching local URL-hash metadata can be resumed after
  failures or interruptions. Legacy partials without metadata are restarted.
- Completed downloads are checked for consistent length and inspected with
  FFprobe when available. Optional -DeepVerify fully decodes audio, but is
  slower.
- Opus output is verified with FFprobe before any MP3 is removed.
- Interrupted conversions never delete the source.
- Failed episodes are logged in download-history.csv in the output folder.
- A feed gap report compares the feed's numbered entries with the requested
  range. It does not prove the missing episode was never published.

OPUS METADATA
-------------
Opus files receive title, artist, album, track number, publication date and
RSS episode-description tags. Artwork, when selected, is saved separately
as cover.jpg/png/webp (it is not embedded in Opus files).

REQUIREMENTS
------------
Windows PowerShell 5.1 or PowerShell 7; FFmpeg + FFprobe for Opus.
Expected output: Your Music folder / Making Sense, unless changed.
