@pro-gram/flux 1.5.0 → 1.6.1

package/NOTICE.txt

@@ -1,4 +1,4 @@
-Flux 1.5.0 - third-party components
+Flux 1.6.1 - third-party components
 
 FFmpeg 9.0.2, release essentials build by Gyan Doshi
 Used as a separate command-line decoding process.
@@ -20,8 +20,9 @@ Copyright (c) .NET Foundation and Contributors. MIT license.
 https://github.com/dotnet/runtime/blob/main/LICENSE.TXT
 
 Zoom H5studio and R16/R24 drivers: linked from Zoom's official support pages, not bundled.
-R16 reference panel image: copyright Zoom Corporation. The npm installer
-fetches the image directly from Zoom's public product website.
+R16 reference panel image: copyright Zoom Corporation. The reference image
+is included from Zoom's public product website; its source URL and SHA-256
+are recorded in dependency-lock.json.
 Zoom and R16 are trademarks of Zoom Corporation. This is an independent app.
 
 The original drummer mascot was generated for Drum Buddy using OpenAI's

package/README.md

@@ -7,10 +7,21 @@ Flux is a compact Windows audio studio with a 16-track editor/recorder, a Media
 Close the running audio application, then:
 
 ```powershell
-npm.cmd install -g @pro-gram/flux@latest
-flux.cmd
+npm install -g @pro-gram/flux@latest
+flux --setup
+flux
 ```
 
+**If npm skips setup or the Desktop shortcut is missing, run `flux --setup`.** This completes the desktop installation and creates the Flux Desktop and Start menu shortcuts. When npm allows the setup script, these steps happen automatically. An `allowScripts` notice can also appear after a successful installation. The first `flux` launch completes setup if it is needed.
+
+To allow Flux's setup script for one installation:
+
+```powershell
+npm install -g @pro-gram/flux@latest --allow-scripts=@pro-gram/flux
+```
+
+If PowerShell blocks the `npm.ps1` or `flux.ps1` launcher, use `npm.cmd` and `flux.cmd` for the same commands.
+
 Windows 10/11 x64 is supported. macOS is planned. Basic tools work locally without an account.
 
 ### Moving from Drum Buddy / FluxTempo
@@ -25,17 +36,31 @@ flux.cmd
 
 Removing that npm package leaves its separate desktop installation and audio files in place. Flux updates the existing desktop installation and uses its saved folders/settings. The launch command is now `flux.cmd`; older launchers belong to the old npm package and should be removed during migration.
 
-If npm skipped the install script, the first launch completes setup. `flux.cmd --setup` repairs the installation. The Windows executable is unsigned. Setup downloads pinned FFmpeg/R16 panel assets from their published sources, verifies hashes and caches them. The standalone installer includes those assets. Vendor audio drivers are linked from their official support pages.
+If npm skipped the install script, the first launch completes setup. `flux.cmd --setup` repairs the installation. The Windows executable is unsigned. The npm and standalone installers both include FFmpeg and the R16 panel assets, with payload integrity checks. There is no separate codec download during setup. Vendor audio drivers are linked from their official support pages.
 
 ## Editor and recording
 
 Editor opens by default. File contains New, Open session, Save, Save as and Add audio. Home and View open Converter, Media Player and the R16 workspace.
 
+The compact header puts navigation beside the logo. Grid and zoom share one toolbar, and playback/output selection share the bottom strip. Export settings and extra range/import options expand when needed, keeping more tracks visible on smaller displays.
+
 The editor supports 16 tracks, multiple audio regions, selected/all-track edits, mute/solo, levels, split, cut/copy/paste, undo/redo, saved `.dbedit` sessions and PCM/float mix export. Original audio stays unchanged.
 
 Select audio, press **Ctrl+C**, press **Backspace** to delete that section, place the playhead and press **Ctrl+V**. Deleting preserves the timeline gap and the internal audio clipboard. Delete is also available as an editable alternate; Ctrl+X still cuts. Paste starts exactly at the playhead. The Cut/Copy/Paste toolbar buttons are removed.
 
-**S** splits at the playhead; **K** toggles the scissors pointer. Drag the upper ruler for the playhead and the lower-ruler selection handles to adjust a range. Range / zoom exposes numeric selection and zoom controls. Zoom extends to 2560 px/s for fine chops.
+**V** selects the pointer tool; **S** splits at the playhead. Click a region to select it; Shift-click adds/removes clips, and dragging selects a time range. Selected clips use a brighter purple fill and border. Drag the upper ruler for the playhead and the lower-ruler selection handles to adjust a range. Range exposes numeric selection controls.
+
+Drag a clip's header to move it; selected groups retain their time/track offsets. Drag the left/right edges to trim within the source audio. The waveform body remains available for range selection. **Y** switches to slip editing, which shifts source contents inside a trimmed clip; **F** switches to the fade tool. Selected clips also show fade handles.
+
+**Ctrl+D** duplicates selected clips or time; **Ctrl+L** repeats the selection with a chosen number of additional copies. **M** mutes/unmutes selected clips or isolates and mutes a time range. **X** crossfades two staggered, overlapping clips on the same track. Right-click audio for these tools, clipboard actions and Clear fades. The scissors/split toolbar buttons are removed.
+
+Moves, trims, slip, clip mute and fades are non-destructive and undoable. Fades affect playback and exported mixes; splitting/copying inside a fade preserves the original envelope. Escape cancels a clip drag. The editor's select/slip/fade modes and all default commands have editable keybindings.
+
+### Editor zoom
+
+The visible **- / + buttons and slider** zoom the timeline from a full-project overview to individual samples. **Ctrl+mouse wheel** zooms around the time under the pointer; **Shift+wheel** scrolls sideways. **Fit** shows the full project, and **Selection** fills the pane with the selected time range.
+
+**Ctrl+Plus / Ctrl+Minus** zoom (including Ctrl+= and numeric-keypad keys), **Ctrl+0** fits the project and **Ctrl+Shift+0** fits the selection. These shortcuts are editable in Settings > Keybinds. At close zoom, waveform detail is read from decoded audio in the background, preserving positive/negative peaks and float headroom. The ruler displays fractional seconds when a close-up contains no labeled beat. Zoom changes the view without changing audio, the playhead or undo history.
 
 Record options contains microphone/input channels, sample rate and PCM/float format. Recording saves original takes and inserts them at the starting playhead on the selected track; separate input channels use consecutive tracks. Use hardware direct monitoring. Software overdub latency alignment is not included.
 
@@ -58,7 +83,9 @@ Tempo changes the grid, without stretching existing audio. Tempo, meter, divisio
 
 ## Audio devices
 
-Settings > Audio selects speakers/headphones and recording input. Playback output is shared between Editor and Media Player. Windows speakers use shared WASAPI with native endpoint format handling and an endpoint-matched 16-bit PCM compatibility fallback. Select the same device's Compatibility output if needed.
+Settings > Audio selects speakers/headphones and recording input. Playback output is shared between Editor and Media Player. Windows default displays the current Windows output and resolves it again when playback starts. Named entries select active Windows endpoints; installed ASIO drivers are listed separately. Device changes refresh the selector automatically. Retired compatibility selections migrate to the corresponding real endpoint.
+
+Windows playback uses one shared WASAPI renderer with device activation, initialization, buffering and release on its own audio thread. Audio is resampled/adapted to the endpoint's exact mix format, without an extra Windows automatic converter or WinMM playback fallback. Initialization and runtime errors retain the actual failing stage in diagnostics.
 
 Ordinary Windows/Realtek/USB microphones capture 16-bit PCM. Saving that input in a float or 24-bit container adds no input precision or native float headroom. H5studio ASIO preserves native 32-bit float when the Zoom driver supplies it. Install Drivers links to official H5studio/R16 support. R16 ASIO recording remains available.
 
@@ -68,6 +95,8 @@ Test speakers plays a short quiet tone. Save diagnostics exports device formats
 
 Media Player decodes PCM/float WAV, AIFF, FLAC, MP3 and audio from video without Windows Media Player codecs. Gain / Save provides +/-36 dB adjustment, safe level, protection and compact Save copy for PCM or float WAV. Gain affects playback and saved copies; listening volume affects playback only. Copies receive new names instead of overwriting originals or exports.
 
+The bundled FFmpeg build contains 227 audio decoders, including integer PCM and IEEE float. Both installation paths include the decoder executable. No Windows Media Player codec pack is required. Protected, damaged or unsupported files can still be rejected; supported decoders are listed in the release's audio-decoder inventory.
+
 Open **View > Converter**, drop audio/video, choose the target type and convert. WAV PCM, WAV float, AIFF, FLAC, MP3 and AAC/M4A are supported, including MP3 -> AIFF and AIFF -> WAV. Preserve source rate or choose 44.1/48/96 kHz; MP3 uses at most 48 kHz. Converter contains no gain amplifier or navigation tab.
 
 The Zoom R16 conversion preset writes classic 44.1 kHz 16/24-bit PCM WAV with short compatible filenames. R16 Control also retains the hardware panel, mixer/EQ, MIDI control, MIDI recording/playback and native project-copy tools. Verify edited R16 projects on the hardware. Zoom's internal effect DSP is not emulated.
@@ -79,7 +108,10 @@ The Zoom R16 conversion preset writes classic 44.1 kHz 16/24-bit PCM WAV with sh
 | Play/pause; stop active recording | Space |
 | Stop | Shift+Space |
 | Record | R |
-| Split / scissors pointer | S / K |
+| Split / selection cursor | S / V |
+| Slip / fade tool | Y / F |
+| Duplicate / repeat | Ctrl+D / Ctrl+L |
+| Clip mute / crossfade | M / X |
 | Copy / paste / cut | Ctrl+C / Ctrl+V / Ctrl+X |
 | Delete selected section | Backspace or Delete |
 | Undo / redo | Ctrl+Z / Ctrl+Y |
@@ -87,6 +119,8 @@ The Zoom R16 conversion preset writes classic 44.1 kHz 16/24-bit PCM WAV with sh
 | Open / new session | Ctrl+O / Ctrl+N |
 | Import / export | Ctrl+I / Ctrl+E |
 | Start / end | Home / End |
+| Zoom in / out | Ctrl+= / Ctrl+- |
+| Fit project / selection | Ctrl+0 / Ctrl+Shift+0 |
 | Home / Editor / Converter / Player | Ctrl+1 / Ctrl+2 / Ctrl+3 / Ctrl+4 |
 | Settings | Ctrl+, |
 
@@ -96,8 +130,8 @@ Keybind Edit immediately focuses/selects the capture field. Save commits changes
 
 The editor's working timeline is 44.1 kHz float. Mix exports support 16/24-bit PCM or 32-bit float WAV, with a 4 GB limit. Source-rate conversion reads the original file. Keep original sources alongside saved sessions.
 
-The enlarged PNG is used in the header. A refined SVG alternative and the original black-haired Drum Buddy mascot are preserved in source. Brand website: https://fluxtempo.ca
+The new Flux PNG is used in the app, executable and versioned shortcut icons. A refined SVG alternative and the original black-haired Drum Buddy mascot are preserved in source; the mascot is archived in `source/brand-archive`. Brand website: https://fluxtempo.ca
 
 Physical H5studio/R16 capture and audible playback on the affected Realtek PC require connected-device acceptance. Automated tests cover generated samples, native project fixtures, grid math, editing workflows, settings and local silent output probes.
 
-Source, build instructions and dependency licence notices are included. Premium authentication/billing is not implemented.
+Source, build instructions and dependency licence notices are included. Premium authentication/billing is not implemented.

package/dependencies.json

@@ -10,5 +10,6 @@
     "sha256": "315a71e8942a445c903b2d1aedb703b64aab30f054e46199a2bac447d3d03cb2",
     "alternateSha256": "5564fa622f101dc27ea402c399c5b9b1e1e039b8771daf40b185dab9772adf38"
   },
-  "installerSha256": "cf5047db59588e7cbbd1ceae31f14f5e22689474b658379c4e45098bef38570e"
+  "installerSha256": "3d36d86c4bc3e83276811a59778c2fc0e3fe7368dcb6b0ecbc7658ea99220929",
+  "bundledAssets": true
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pro-gram/flux",
-  "version": "1.5.0",
-  "description": "Flux: Windows audio editor/recorder with tempo grids, independent snapping, 16 tracks, PCM/float playback and file conversion.",
+  "version": "1.6.1",
+  "description": "Flux: a 16-track Windows audio studio with native shared playback, float/PCM recording, clip editing tools, tempo grids and bundled audio codecs.",
   "license": "MIT",
   "author": "pro-gram",
   "os": [
@@ -17,7 +17,7 @@
     "flux": "bin/flux.js"
   },
   "scripts": {
-    "postinstall": "node scripts/install.js",
+    "postinstall": "echo If npm skips setup, run flux --setup && node scripts/install.js",
     "test": "node --test test/*.test.js"
   },
   "files": [

package/scripts/install.js

@@ -44,8 +44,10 @@ async function install() {
   await fsp.mkdir(cache, { recursive: true });
   const installer = path.resolve(__dirname, '..', 'payload', 'DrumBuddy-Setup.exe');
   if (await hash(installer) !== dependencies.installerSha256) throw new Error('The Flux installer failed its integrity check.');
-  await cached(dependencies.ffmpeg, cache);
-  await cached(dependencies.panel, cache);
+  if (!dependencies.bundledAssets) {
+    await cached(dependencies.ffmpeg, cache);
+    await cached(dependencies.panel, cache);
+  }
   console.log('Flux: installing version ' + pkg.version + ' and the Desktop shortcut...');
   execFileSync(installer, ['--update-app'], { windowsHide: true, stdio: 'inherit' });
   await fsp.writeFile(path.join(root, 'npm-version.txt'), pkg.version + '\n');

package/source/AssetBootstrap.cs

@@ -21,7 +21,7 @@ namespace DrumBuddySetup
             if(File.Exists(target) && expected.Contains(Hash(target),StringComparer.OrdinalIgnoreCase))return target;
             string temporary=target+"."+Guid.NewGuid().ToString("N")+".partial";
             try {
-                using(var client=new WebClient()) { client.Headers[HttpRequestHeader.UserAgent]="DrumBuddy/1.5.0";client.DownloadFile(url,temporary); }
+                using(var client=new WebClient()) { client.Headers[HttpRequestHeader.UserAgent]="DrumBuddy/1.6.1";client.DownloadFile(url,temporary); }
                 if(!expected.Contains(Hash(temporary),StringComparer.OrdinalIgnoreCase))throw new IOException("A downloaded component failed its integrity check. Please retry setup or obtain a newer Drum Buddy release.");
                 File.Copy(temporary,target,true);return target;
             }finally { if(File.Exists(temporary))File.Delete(temporary); }

package/source/Audio Decoders.txt

@@ -0,0 +1,230 @@
+Flux 1.6.1 bundled FFmpeg audio decoders
+These decode imported files without Windows Media Player codecs.
+
+ A..... = Audio
+ A....D 8svx_exp             8SVX exponential
+ A....D 8svx_fib             8SVX fibonacci
+ A....D aac                  AAC (Advanced Audio Coding)
+ A....D aac_fixed            AAC (Advanced Audio Coding) (codec aac)
+ A....D aac_latm             AAC LATM (Advanced Audio Coding LATM syntax)
+ A....D ac3                  ATSC A/52A (AC-3)
+ A....D ac3_fixed            ATSC A/52A (AC-3) (codec ac3)
+ A....D acelp.kelvin         Sipro ACELP.KELVIN
+ A....D adpcm_4xm            ADPCM 4X Movie
+ A....D adpcm_adx            SEGA CRI ADX ADPCM
+ A....D adpcm_afc            ADPCM Nintendo Gamecube AFC
+ A....D adpcm_agm            ADPCM AmuseGraphics Movie
+ A....D adpcm_aica           ADPCM Yamaha AICA
+ A....D adpcm_argo           ADPCM Argonaut Games
+ A....D adpcm_circus         ADPCM Circus
+ A....D adpcm_ct             ADPCM Creative Technology
+ A....D adpcm_dtk            ADPCM Nintendo Gamecube DTK
+ A....D adpcm_ea             ADPCM Electronic Arts
+ A....D adpcm_ea_maxis_xa    ADPCM Electronic Arts Maxis CDROM XA
+ A....D adpcm_ea_r1          ADPCM Electronic Arts R1
+ A....D adpcm_ea_r2          ADPCM Electronic Arts R2
+ A....D adpcm_ea_r3          ADPCM Electronic Arts R3
+ A....D adpcm_ea_xas         ADPCM Electronic Arts XAS
+ A....D g722                 G.722 ADPCM (codec adpcm_g722)
+ A....D g726                 G.726 ADPCM (codec adpcm_g726)
+ A....D g726le               G.726 ADPCM little-endian (codec adpcm_g726le)
+ A....D adpcm_ima_acorn      ADPCM IMA Acorn Replay
+ A....D adpcm_ima_alp        ADPCM IMA High Voltage Software ALP
+ A....D adpcm_ima_amv        ADPCM IMA AMV
+ A....D adpcm_ima_apc        ADPCM IMA CRYO APC
+ A....D adpcm_ima_apm        ADPCM IMA Ubisoft APM
+ A....D adpcm_ima_cunning    ADPCM IMA Cunning Developments
+ A....D adpcm_ima_dat4       ADPCM IMA Eurocom DAT4
+ A....D adpcm_ima_dk3        ADPCM IMA Duck DK3
+ A....D adpcm_ima_dk4        ADPCM IMA Duck DK4
+ A....D adpcm_ima_ea_eacs    ADPCM IMA Electronic Arts EACS
+ A....D adpcm_ima_ea_sead    ADPCM IMA Electronic Arts SEAD
+ A....D adpcm_ima_escape     ADPCM IMA Acorn Escape
+ A....D adpcm_ima_hvqm2      ADPCM IMA HVQM2
+ A....D adpcm_ima_hvqm4      ADPCM IMA HVQM4
+ A....D adpcm_ima_iss        ADPCM IMA Funcom ISS
+ A....D adpcm_ima_magix      ADPCM IMA Magix
+ A....D adpcm_ima_moflex     ADPCM IMA MobiClip MOFLEX
+ A....D adpcm_ima_mtf        ADPCM IMA Capcom's MT Framework
+ A....D adpcm_ima_oki        ADPCM IMA Dialogic OKI
+ A....D adpcm_ima_pda        ADPCM IMA PlayDate
+ A....D adpcm_ima_qt         ADPCM IMA QuickTime
+ A....D adpcm_ima_rad        ADPCM IMA Radical
+ A....D adpcm_ima_smjpeg     ADPCM IMA Loki SDL MJPEG
+ A....D adpcm_ima_ssi        ADPCM IMA Simon & Schuster Interactive
+ A....D adpcm_ima_wav        ADPCM IMA WAV
+ A....D adpcm_ima_ws         ADPCM IMA Westwood
+ A....D adpcm_ima_xbox       ADPCM IMA Xbox
+ A....D adpcm_ms             ADPCM Microsoft
+ A....D adpcm_mtaf           ADPCM MTAF
+ A....D adpcm_n64            ADPCM Silicon Graphics N64
+ A....D adpcm_psx            ADPCM Playstation
+ A....D adpcm_psxc           ADPCM Playstation C
+ A....D adpcm_sanyo          ADPCM Sanyo
+ A....D adpcm_sbpro_2        ADPCM Sound Blaster Pro 2-bit
+ A....D adpcm_sbpro_3        ADPCM Sound Blaster Pro 2.6-bit
+ A....D adpcm_sbpro_4        ADPCM Sound Blaster Pro 4-bit
+ A....D adpcm_swf            ADPCM Shockwave Flash
+ A....D adpcm_thp            ADPCM Nintendo THP
+ A....D adpcm_thp_le         ADPCM Nintendo THP (little-endian)
+ A....D adpcm_vima           LucasArts VIMA audio
+ A....D adpcm_xa             ADPCM CDROM XA
+ A....D adpcm_xmd            ADPCM Konami XMD
+ A....D adpcm_yamaha         ADPCM Yamaha
+ A....D adpcm_zork           ADPCM Zork
+ A....D ahx                  CRI AHX
+ AF...D alac                 ALAC (Apple Lossless Audio Codec)
+ A....D amrnb                AMR-NB (Adaptive Multi-Rate NarrowBand) (codec amr_nb)
+ A....D libopencore_amrnb    OpenCORE AMR-NB (Adaptive Multi-Rate Narrow-Band) (codec amr_nb)
+ A....D amrwb                AMR-WB (Adaptive Multi-Rate WideBand) (codec amr_wb)
+ A....D libopencore_amrwb    OpenCORE AMR-WB (Adaptive Multi-Rate Wide-Band) (codec amr_wb)
+ A....D anull                null audio
+ A....D apac                 Marian's A-pac audio
+ A....D ape                  Monkey's Audio
+ A....D aptx                 aptX (Audio Processing Technology for Bluetooth)
+ A....D aptx_hd              aptX HD (Audio Processing Technology for Bluetooth)
+ A....D atrac1               ATRAC1 (Adaptive TRansform Acoustic Coding)
+ A....D atrac3               ATRAC3 (Adaptive TRansform Acoustic Coding 3)
+ A....D atrac3al             ATRAC3 AL (Adaptive TRansform Acoustic Coding 3 Advanced Lossless)
+ A....D atrac3plus           ATRAC3+ (Adaptive TRansform Acoustic Coding 3+) (codec atrac3p)
+ A....D atrac3plusal         ATRAC3+ AL (Adaptive TRansform Acoustic Coding 3+ Advanced Lossless) (codec atrac3pal)
+ A....D atrac9               ATRAC9 (Adaptive TRansform Acoustic Coding 9)
+ A....D on2avc               On2 Audio for Video Codec (codec avc)
+ A....D binkaudio_dct        Bink Audio (DCT)
+ A....D binkaudio_rdft       Bink Audio (RDFT)
+ A....D bmv_audio            Discworld II BMV audio
+ A....D bonk                 Bonk audio
+ A....D cbd2_dpcm            DPCM Cuberoot-Delta-Exact
+ A....D comfortnoise         RFC 3389 comfort noise generator
+ A....D cook                 Cook / Cooker / Gecko (RealAudio G2)
+ A....D derf_dpcm            DPCM Xilam DERF
+ A....D dfpwm                DFPWM1a audio
+ A....D dolby_e              Dolby E
+ A.S..D dsd_lsbf             DSD (Direct Stream Digital), least significant bit first
+ A.S..D dsd_lsbf_planar      DSD (Direct Stream Digital), least significant bit first, planar
+ A.S..D dsd_msbf             DSD (Direct Stream Digital), most significant bit first
+ A.S..D dsd_msbf_planar      DSD (Direct Stream Digital), most significant bit first, planar
+ A....D dsicinaudio          Delphine Software International CIN audio
+ A....D dss_sp               Digital Speech Standard - Standard Play mode (DSS SP)
+ A....D dst                  DST (Digital Stream Transfer)
+ A....D dca                  DCA (DTS Coherent Acoustics) (codec dts)
+ A....D dvaudio              Ulead DV Audio
+ A....D eac3                 ATSC A/52B (AC-3, E-AC-3)
+ A....D evrc                 EVRC (Enhanced Variable Rate Codec)
+ A....D fastaudio            MobiClip FastAudio
+ AF...D flac                 FLAC (Free Lossless Audio Codec)
+ A....D ftr                  FTR Voice
+ A....D g723_1               G.723.1
+ A....D g728                 G.728)
+ A....D g729                 G.729
+ A....D gremlin_dpcm         DPCM Gremlin
+ A....D gsm                  GSM
+ A....D libgsm               libgsm GSM (codec gsm)
+ A....D gsm_ms               GSM Microsoft variant
+ A....D libgsm_ms            libgsm GSM Microsoft variant (codec gsm_ms)
+ A....D hca                  CRI HCA
+ A....D hcom                 HCOM Audio
+ A....D iac                  IAC (Indeo Audio Coder)
+ A....D ilbc                 iLBC (Internet Low Bitrate Codec)
+ A....D imc                  IMC (Intel Music Coder)
+ A....D interplay_dpcm       DPCM Interplay
+ A....D interplayacm         Interplay ACM
+ A....D mace3                MACE (Macintosh Audio Compression/Expansion) 3:1
+ A....D mace6                MACE (Macintosh Audio Compression/Expansion) 6:1
+ A....D metasound            Voxware MetaSound
+ A....D misc4                Micronas SC-4 Audio
+ A....D mlp                  MLP (Meridian Lossless Packing)
+ A....D mp1                  MP1 (MPEG audio layer 1)
+ A....D mp1float             MP1 (MPEG audio layer 1) (codec mp1)
+ A....D mp2                  MP2 (MPEG audio layer 2)
+ A....D mp2float             MP2 (MPEG audio layer 2) (codec mp2)
+ A....D mp3float             MP3 (MPEG audio layer 3) (codec mp3)
+ A....D mp3                  MP3 (MPEG audio layer 3)
+ A....D mp3adufloat          ADU (Application Data Unit) MP3 (MPEG audio layer 3) (codec mp3adu)
+ A....D mp3adu               ADU (Application Data Unit) MP3 (MPEG audio layer 3)
+ A....D mp3on4float          MP3onMP4 (codec mp3on4)
+ A....D mp3on4               MP3onMP4
+ A....D als                  MPEG-4 Audio Lossless Coding (ALS) (codec mp4als)
+ A....D msnsiren             MSN Siren
+ A....D mpc7                 Musepack SV7 (codec musepack7)
+ A....D mpc8                 Musepack SV8 (codec musepack8)
+ A....D nellymoser           Nellymoser Asao
+ A....D opus                 Opus
+ A....D libopus              libopus Opus (codec opus)
+ A....D osq                  OSQ (Original Sound Quality)
+ A....D paf_audio            Amazing Studio Packed Animation File Audio
+ A....D pcm_alaw             PCM A-law / G.711 A-law
+ A....D pcm_bluray           PCM signed 16|20|24-bit big-endian for Blu-ray media
+ A....D pcm_dvd              PCM signed 16|20|24-bit big-endian for DVD media
+ A....D pcm_f16le            PCM 16.8 floating point little-endian
+ A....D pcm_f24le            PCM 24.0 floating point little-endian
+ A....D pcm_f32be            PCM 32-bit floating point big-endian
+ A....D pcm_f32le            PCM 32-bit floating point little-endian
+ A....D pcm_f64be            PCM 64-bit floating point big-endian
+ A....D pcm_f64le            PCM 64-bit floating point little-endian
+ A....D pcm_lxf              PCM signed 20-bit little-endian planar
+ A....D pcm_mulaw            PCM mu-law / G.711 mu-law
+ A....D pcm_s16be            PCM signed 16-bit big-endian
+ A....D pcm_s16be_planar     PCM signed 16-bit big-endian planar
+ A....D pcm_s16le            PCM signed 16-bit little-endian
+ A....D pcm_s16le_planar     PCM signed 16-bit little-endian planar
+ A....D pcm_s24be            PCM signed 24-bit big-endian
+ A....D pcm_s24daud          PCM D-Cinema audio signed 24-bit
+ A....D pcm_s24le            PCM signed 24-bit little-endian
+ A....D pcm_s24le_planar     PCM signed 24-bit little-endian planar
+ A....D pcm_s32be            PCM signed 32-bit big-endian
+ A....D pcm_s32le            PCM signed 32-bit little-endian
+ A....D pcm_s32le_planar     PCM signed 32-bit little-endian planar
+ A....D pcm_s64be            PCM signed 64-bit big-endian
+ A....D pcm_s64le            PCM signed 64-bit little-endian
+ A....D pcm_s8               PCM signed 8-bit
+ A....D pcm_s8_planar        PCM signed 8-bit planar
+ A....D pcm_sga              PCM SGA
+ A....D pcm_u16be            PCM unsigned 16-bit big-endian
+ A....D pcm_u16le            PCM unsigned 16-bit little-endian
+ A....D pcm_u24be            PCM unsigned 24-bit big-endian
+ A....D pcm_u24le            PCM unsigned 24-bit little-endian
+ A....D pcm_u32be            PCM unsigned 32-bit big-endian
+ A....D pcm_u32le            PCM unsigned 32-bit little-endian
+ A....D pcm_u8               PCM unsigned 8-bit
+ A....D pcm_vidc             PCM Archimedes VIDC
+ A....D qcelp                QCELP / PureVoice
+ A....D qdm2                 QDesign Music Codec 2
+ A....D qdmc                 QDesign Music Codec 1
+ A....D qoa                  QOA (Quite OK Audio)
+ A....D real_144             RealAudio 1.0 (14.4K) (codec ra_144)
+ A....D real_288             RealAudio 2.0 (28.8K) (codec ra_288)
+ A....D ralf                 RealAudio Lossless
+ A....D rka                  RKA (RK Audio)
+ A....D roq_dpcm             DPCM id RoQ
+ A....D s302m                SMPTE 302M
+ A....D sbc                  SBC (low-complexity subband codec)
+ A....D sdx2_dpcm            DPCM Squareroot-Delta-Exact
+ A....D shorten              Shorten
+ A....D sipr                 RealAudio SIPR / ACELP.NET
+ A....D siren                Siren
+ A....D smackaud             Smacker audio (codec smackaudio)
+ A....D sol_dpcm             DPCM Sol
+ A....D speex                Speex
+ A....D libspeex             libspeex Speex (codec speex)
+ AF...D tak                  TAK (Tom's lossless Audio Kompressor)
+ A....D truehd               TrueHD
+ A....D truespeech           DSP Group TrueSpeech
+ AF...D tta                  TTA (True Audio)
+ A....D twinvq               VQF TwinVQ
+ A....D vmdaudio             Sierra VMD audio
+ A....D vorbis               Vorbis
+ A..... libvorbis            libvorbis (codec vorbis)
+ A....D wady_dpcm            DPCM Marble WADY
+ A....D wavarc               Waveform Archiver
+ A....D wavesynth            Wave synthesis pseudo-codec
+ AFS..D wavpack              WavPack
+ A....D ws_snd1              Westwood Audio (SND1) (codec westwood_snd1)
+ A....D wmalossless          Windows Media Audio Lossless
+ A....D wmapro               Windows Media Audio 9 Professional
+ A....D wmav1                Windows Media Audio 1
+ A....D wmav2                Windows Media Audio 2
+ A....D wmavoice             Windows Media Audio Voice
+ A....D xan_dpcm             DPCM Xan
+ A....D xma1                 Xbox Media Audio 1
+ A....D xma2                 Xbox Media Audio 2

package/source/AudioDeviceSettings.cs

@@ -30,7 +30,7 @@ namespace DrumBuddy
             Children.Add(WorkspaceUi.Text("Speakers / headphones", 18));
             outputs = new AudioOutputPicker(delegate { StopTest(); if (stopPlayback != null) stopPlayback(); }, delegate(string text) { if (result != null) result.Text = text; });
             outputs.Margin = new Thickness(0, 8, 0, 4); Children.Add(outputs);
-            var help = WorkspaceUi.Text("For a Realtek or Windows audio error, choose that device's Compatibility (16-bit PCM) entry. Automatic Windows output also tries this path if shared audio cannot open.", 14);
+            var help = WorkspaceUi.Text("Windows default follows the speakers/headphones selected in Windows. Choose a named device to keep playback on that output. Only active Windows endpoints and installed ASIO drivers are listed.", 14);
             help.Margin = new Thickness(0, 0, 0, 10); Children.Add(help);
             Children.Add(WorkspaceUi.Button("Test speakers", Test));
             Children.Add(WorkspaceUi.Text("Recording input", 18));

package/source/AudioEndpointWatcher.cs

@@ -0,0 +1,25 @@
+using System;
+using System.Threading;
+using NAudio.CoreAudioApi;
+using NAudio.CoreAudioApi.Interfaces;
+
+namespace DrumBuddy
+{
+    internal sealed class AudioEndpointWatcher : IMMNotificationClient, IDisposable
+    {
+        private readonly MMDeviceEnumerator enumerator;
+        private readonly Action changed;
+        private volatile bool disposed;
+        public AudioEndpointWatcher(Action changed)
+        { this.changed = changed; enumerator = new MMDeviceEnumerator(); enumerator.RegisterEndpointNotificationCallback(this); }
+        private void Notify()
+        { if (!disposed) ThreadPool.QueueUserWorkItem(delegate { if (!disposed) changed(); }); }
+        public void OnDeviceStateChanged(string id, DeviceState state) { Notify(); }
+        public void OnDeviceAdded(string id) { Notify(); }
+        public void OnDeviceRemoved(string id) { Notify(); }
+        public void OnDefaultDeviceChanged(DataFlow flow, Role role, string id) { if (flow == DataFlow.Render || flow == DataFlow.All) Notify(); }
+        public void OnPropertyValueChanged(string id, PropertyKey key) { Notify(); }
+        public void Dispose()
+        { if (disposed) return; disposed = true; try { enumerator.UnregisterEndpointNotificationCallback(this); } finally { enumerator.Dispose(); } }
+    }
+}

package/source/AudioOutputs.cs

@@ -164,31 +164,26 @@ namespace DrumBuddy
         public static event Action OutputChanged;
         public static string PreferredKey {
             get { return preferredKey; }
-            set { value = value ?? "default"; if (value == preferredKey) return; preferredKey = value; var changed = OutputChanged; if (changed != null) changed(); }
+            set { value = NormalizeKey(value); if (value == preferredKey) return; preferredKey = value; var changed = OutputChanged; if (changed != null) changed(); }
         }
-        public static readonly string ErrorLog = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "DrumBuddy", "audio-output-errors.txt");
+        public static string NormalizeKey(string key)
+        { return string.IsNullOrEmpty(key) || key == "compat:default" ? "default" : key.StartsWith("compat:", StringComparison.Ordinal) ? "windows:" + key.Substring(7) : key; }
+        internal static string TestErrorLog;
+        public static string ErrorLog { get { return TestErrorLog ?? Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "DrumBuddy", "audio-output-errors.txt"); } }
         public static List<OutputChoice> Choices()
         {
             var choices = new List<OutputChoice> { new OutputChoice { Name = "Windows default speakers / headphones" } };
             try {
                 using (var enumerator = new MMDeviceEnumerator()) {
-                    try { using (var defaultDevice = enumerator.GetDefaultAudioEndpoint(DataFlow.Render, Role.Multimedia)) choices[0].Name = "Windows default — " + defaultDevice.FriendlyName; } catch { }
+                    try { using (var defaultDevice = enumerator.GetDefaultAudioEndpoint(DataFlow.Render, Role.Console)) { choices[0].Name = "Windows default — " + defaultDevice.FriendlyName; choices[0].DefaultEndpointId = defaultDevice.ID; } } catch { }
                     foreach (var endpoint in enumerator.EnumerateAudioEndPoints(DataFlow.Render, DeviceState.Active)) {
                         using (endpoint) choices.Add(new OutputChoice { Name = endpoint.FriendlyName + " (Windows)", EndpointId = endpoint.ID });
                     }
                 }
             }
             catch { /* The default entry keeps the picker usable if Windows Audio is stopped. */ }
-            choices.Add(new OutputChoice { Name = "Windows default - Compatibility (16-bit PCM)", Compatibility = true });
-            try {
-                for (int i = 0; i < OutputDevices.waveOutGetNumDevs(); i++) {
-                    string endpoint = WindowsWaveDevices.EndpointId(i);
-                    string name = choices.Where(c => !c.Compatibility && c.EndpointId == endpoint).Select(c => c.Name.Replace(" (Windows)", "")).FirstOrDefault() ?? OutputDevices.Name(i);
-                    if (!string.IsNullOrEmpty(endpoint)) choices.Add(new OutputChoice { Name = name + " - Compatibility (16-bit PCM)", Compatibility = true, EndpointId = endpoint, Device = i });
-                }
-            } catch { }
             try { foreach (string driver in AsioOut.GetDriverNames()) choices.Add(new OutputChoice { Name = driver + " (ASIO)", Driver = driver }); } catch { }
-            return choices;
+            return choices.GroupBy(c => c.Key, StringComparer.OrdinalIgnoreCase).Select(g => g.First()).ToList();
         }
         public static ISampleProvider Adapt(ISampleProvider source, int rate, int channels)
         {
@@ -213,56 +208,22 @@ namespace DrumBuddy
                 }
                 catch (Exception ex) { route.Dispose(); throw DeviceError(choice.Name, ex); }
             }
-            if (choice.Compatibility) return OpenCompatibility(source, choice);
-            Exception lastError = null; string endpointId = choice.EndpointId; var failures = new List<string>();
-            // Retry polling on the same selected endpoint if its driver rejects event sync.
+            Exception lastError = null; var failures = new List<string>();
             foreach (bool events in new[] { true, false }) {
                 var route = new PlaybackRoute();
-                string stage = "find endpoint";
                 try {
-                    using (var enumerator = new MMDeviceEnumerator())
-                        route.Endpoint = string.IsNullOrEmpty(choice.EndpointId)
-                            ? enumerator.GetDefaultAudioEndpoint(DataFlow.Render, Role.Multimedia)
-                            : enumerator.GetDevice(choice.EndpointId);
-                    endpointId = route.Endpoint.ID; stage = "create shared audio client";
-                    var wasapi = new WasapiOut(route.Endpoint, AudioClientShareMode.Shared, events, Math.Max(40, Math.Min(250, LatencyMilliseconds))); route.Player = wasapi;
-                    WaveFormat mix = wasapi.OutputWaveFormat;
-                    route.Counter = new CountedPlayback(Adapt(source, mix.SampleRate, mix.Channels));
-                    var wire = new EndpointWaveProvider(route.Counter, mix); route.PlaybackFormat = wire.WaveFormat;
-                    stage = "initialize " + mix;
-                    wasapi.Init(wire);
-                    route.Description = route.Endpoint.FriendlyName + " · Windows shared audio · " + mix.SampleRate + " Hz";
+                    var player = new WindowsAudioPlayer(source, choice.EndpointId, events, LatencyMilliseconds);
+                    route.Player = player; route.Counter = player.Counter; route.PlaybackFormat = player.OutputFormat; route.Description = player.Description;
+                    if (failures.Count > 0) WriteFailures(choice.Name, failures, "Opened native shared stream");
                     return route;
                 }
-                catch (Exception ex) { lastError = ex; failures.Add("WASAPI " + (events ? "event" : "polling") + " / " + stage + ": " + ex); route.Dispose(); }
-            }
-            try {
-                var result = OpenCompatibility(source, new OutputChoice { Name = choice.Name, Compatibility = true, EndpointId = endpointId });
-                WriteFailures(choice.Name, failures, "Recovered using " + result.Description); return result;
+                catch (Exception ex) { lastError = ex; failures.Add("Windows shared " + (events ? "event" : "polling") + ": " + ex); route.Dispose(); }
             }
-            catch (Exception ex) { lastError = ex; failures.Add("Compatibility: " + ex); }
             WriteFailures(choice.Name, failures, "Playback could not start");
             throw DeviceError(choice.Name, lastError);
         }
-        internal static PlaybackRoute OpenCompatibility(ISampleProvider source, OutputChoice choice)
-        {
-            int device = string.IsNullOrEmpty(choice.EndpointId) ? -1 : WindowsWaveDevices.Find(choice.EndpointId);
-            if (device == -2) throw new IOException("The selected output is no longer available. Click Refresh in Audio devices and select it again.");
-            Exception last = null;
-            foreach (int rate in new[] { 48000, 44100 }) {
-                var route = new PlaybackRoute();
-                try {
-                    var player = new WaveOutEvent { DeviceNumber = device, DesiredLatency = Math.Max(100, Math.Min(250, LatencyMilliseconds)), NumberOfBuffers = 3 }; route.Player = player;
-                    route.Counter = new CountedPlayback(Adapt(source, rate, 2));
-                    var wire = new EndpointWaveProvider(route.Counter, new WaveFormat(rate, 16, 2)); route.PlaybackFormat = wire.WaveFormat;
-                    player.Init(wire);
-                    route.Description = (device == -1 ? "Windows default" : OutputDevices.Name(device)) + " - Compatibility / 16-bit PCM / " + rate + " Hz";
-                    return route;
-                }
-                catch (Exception ex) { last = ex; route.Dispose(); }
-            }
-            throw new IOException("Windows PCM compatibility playback failed: " + last.Message + " (0x" + last.HResult.ToString("X8") + ")", last);
-        }
+        internal static void LogPlaybackFailure(string name, Exception error)
+        { WriteFailures(name, new[] { error.ToString() }, "Playback stopped"); }
         private static void WriteFailures(string name, IEnumerable<string> failures, string result)
         {
             try {
@@ -272,8 +233,8 @@ namespace DrumBuddy
         }
         private static IOException DeviceError(string name, Exception error)
         {
-            string detail = error == null ? "No playback device is available." : error.Message + " (0x" + error.HResult.ToString("X8") + ")";
-            return new IOException("Could not open " + name + ". " + detail + " Open Audio devices at the top of the app, click Refresh, and select your speakers/headphones. Try the Compatibility (16-bit PCM) entry. Save diagnostics there if it still fails.", error);
+            string detail = error == null ? "No playback device is available." : error.Message + (error.Message.IndexOf("0x", StringComparison.OrdinalIgnoreCase) >= 0 ? "" : " (0x" + error.HResult.ToString("X8") + ")");
+            return new IOException("Could not open " + name + ". " + detail + " Open Audio devices at the top of the app, click Refresh, and select your speakers/headphones. Save diagnostics there for the exact Windows audio failure.", error);
         }
     }
 
@@ -283,6 +244,7 @@ namespace DrumBuddy
         private readonly Action changed;
         private readonly Action<string> status;
         private bool updating;
+        private AudioEndpointWatcher watcher;
         public OutputChoice Selected { get { return devices.SelectedItem as OutputChoice; } }
         public AudioOutputPicker(Action changed, Action<string> status)
         {
@@ -296,8 +258,12 @@ namespace DrumBuddy
                 if (updating || Selected == null) return;
                 AudioOutputs.PreferredKey = Selected.Key; if (changed != null) changed();
             };
-            Loaded += delegate { AudioOutputs.OutputChanged += SyncSelection; SyncSelection(); };
-            Unloaded += delegate { AudioOutputs.OutputChanged -= SyncSelection; };
+            Loaded += delegate {
+                AudioOutputs.OutputChanged += SyncSelection; Refresh(null, false);
+                try { if (watcher == null) watcher = new AudioEndpointWatcher(delegate { Dispatcher.BeginInvoke((Action)delegate { if (IsLoaded) Refresh(null, false); }); }); }
+                catch (Exception ex) { if (status != null) status("Could not monitor audio device changes: " + ex.Message); }
+            };
+            Unloaded += delegate { AudioOutputs.OutputChanged -= SyncSelection; if (watcher != null) { try { watcher.Dispose(); } catch { } watcher = null; } };
             Refresh();
         }
         private void SyncSelection()
@@ -311,10 +277,11 @@ namespace DrumBuddy
             updating = true; devices.SelectedItem = selected; updating = false;
             if (changed != null) changed();
         }
-        private void Refresh(string desiredKey = null)
+        private void Refresh(string desiredKey = null, bool stop = true)
         {
-            string key = desiredKey ?? (Selected == null ? AudioOutputs.PreferredKey : Selected.Key);
-            if (changed != null && devices.Items.Count > 0) changed();
+            string key = AudioOutputs.NormalizeKey(desiredKey ?? AudioOutputs.PreferredKey);
+            var previous = Selected;
+            if (stop && changed != null && devices.Items.Count > 0) changed();
             updating = true;
             try {
                 var choices = AudioOutputs.Choices(); devices.ItemsSource = choices;
@@ -322,6 +289,19 @@ namespace DrumBuddy
             }
             catch (Exception ex) { if (status != null) status("Could not list audio outputs: " + ex.Message); }
             finally { updating = false; }
+            if (Selected != null) {
+                AudioOutputs.PreferredKey = Selected.Key;
+                if (!stop && previous != null && (previous.Key != Selected.Key || previous.DefaultEndpointId != Selected.DefaultEndpointId) && changed != null) changed();
+            }
+        }
+        internal string SelectionForTest { get { return Selected == null ? null : Selected.Key; } }
+        internal void RefreshForTest() { Refresh(); }
+        internal void UseCompactLayout()
+        {
+            Width = 338; Margin = new Thickness(8, 0, 8, 4);
+            foreach (var text in Children.OfType<TextBlock>()) text.Visibility = Visibility.Collapsed;
+            devices.MaxWidth = 306; devices.MinHeight = 26; devices.FontSize = 12; devices.Padding = new Thickness(4, 2, 4, 2);
+            foreach (var button in Children.OfType<Button>()) { button.Content = "↻"; button.ToolTip = "Refresh audio devices"; button.Width = 26; button.MinHeight = 26; button.Padding = new Thickness(0); button.Margin = new Thickness(4, 0, 0, 0); }
         }
     }
 }