@karaplay/file-coder 1.4.8 → 1.5.0

package/debug-timing.js

@@ -1,159 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const { parseMidi } = require('midi-file');
-
-// Parse KAR file (which is a MIDI file)
-function analyzeKarFile(filePath) {
-  console.log(`\n=== Analyzing: ${path.basename(filePath)} ===`);
-  
-  const buffer = fs.readFileSync(filePath);
-  const midi = parseMidi(buffer);
-  
-  console.log(`Format: ${midi.header.format}`);
-  console.log(`Tracks: ${midi.tracks.length}`);
-  console.log(`Ticks per beat: ${midi.header.ticksPerBeat}`);
-  
-  // Find karaoke track (track with lyric text events)
-  let karaokeTrackIdx = -1;
-  let maxTextEvents = 0;
-  
-  midi.tracks.forEach((track, idx) => {
-    const textEvents = track.filter(e => e.type === 'text' && e.text && e.text.trim());
-    if (textEvents.length > maxTextEvents) {
-      maxTextEvents = textEvents.length;
-      karaokeTrackIdx = idx;
-    }
-  });
-  
-  if (karaokeTrackIdx === -1) {
-    console.log('No karaoke track found!');
-    return null;
-  }
-  
-  console.log(`\nKaraoke track index: ${karaokeTrackIdx}`);
-  console.log(`Text events: ${maxTextEvents}`);
-  
-  // Extract timing information
-  const karaokeTrack = midi.tracks[karaokeTrackIdx];
-  let absoluteTime = 0;
-  const timings = [];
-  
-  karaokeTrack.forEach((event, idx) => {
-    absoluteTime += event.deltaTime;
-    
-    if (event.type === 'text' && event.text && event.text.trim()) {
-      timings.push({
-        index: idx,
-        deltaTime: event.deltaTime,
-        absoluteTime: absoluteTime,
-        text: event.text
-      });
-    }
-  });
-  
-  // Show first 20 timing entries
-  console.log(`\nFirst 20 timing entries:`);
-  timings.slice(0, 20).forEach((t, i) => {
-    console.log(`${i+1}. Delta: ${t.deltaTime.toString().padStart(6)}, Absolute: ${t.absoluteTime.toString().padStart(8)}, Text: "${t.text}"`);
-  });
-  
-  // Calculate average delta between events
-  const deltas = timings.map(t => t.deltaTime).filter(d => d > 0);
-  const avgDelta = deltas.reduce((a, b) => a + b, 0) / deltas.length;
-  const minDelta = Math.min(...deltas);
-  const maxDelta = Math.max(...deltas);
-  
-  console.log(`\nDelta statistics:`);
-  console.log(`  Average: ${avgDelta.toFixed(2)}`);
-  console.log(`  Min: ${minDelta}`);
-  console.log(`  Max: ${maxDelta}`);
-  console.log(`  Total events: ${timings.length}`);
-  
-  return {
-    ticksPerBeat: midi.header.ticksPerBeat,
-    timings: timings,
-    avgDelta: avgDelta,
-    minDelta: minDelta,
-    maxDelta: maxDelta
-  };
-}
-
-// Compare two KAR files
-function compareKarFiles(originalPath, convertedPath) {
-  console.log('\n' + '='.repeat(80));
-  console.log('COMPARING TIMING');
-  console.log('='.repeat(80));
-  
-  const original = analyzeKarFile(originalPath);
-  const converted = analyzeKarFile(convertedPath);
-  
-  if (!original || !converted) {
-    console.log('Cannot compare - one of the files has no karaoke track');
-    return;
-  }
-  
-  console.log('\n' + '='.repeat(80));
-  console.log('COMPARISON RESULTS');
-  console.log('='.repeat(80));
-  
-  console.log(`\nTicks per beat:`);
-  console.log(`  Original:  ${original.ticksPerBeat}`);
-  console.log(`  Converted: ${converted.ticksPerBeat}`);
-  
-  console.log(`\nAverage delta time:`);
-  console.log(`  Original:  ${original.avgDelta.toFixed(2)}`);
-  console.log(`  Converted: ${converted.avgDelta.toFixed(2)}`);
-  console.log(`  Ratio: ${(converted.avgDelta / original.avgDelta).toFixed(4)}x`);
-  
-  // Compare first 20 events side by side
-  console.log(`\nFirst 20 events comparison:`);
-  console.log(`${'Idx'.padEnd(4)} | ${'Original Delta'.padEnd(14)} | ${'Converted Delta'.padEnd(15)} | ${'Ratio'.padEnd(8)} | Text`);
-  console.log('-'.repeat(100));
-  
-  const minLength = Math.min(original.timings.length, converted.timings.length, 20);
-  for (let i = 0; i < minLength; i++) {
-    const origDelta = original.timings[i].deltaTime;
-    const convDelta = converted.timings[i].deltaTime;
-    const ratio = origDelta > 0 ? (convDelta / origDelta).toFixed(4) : 'N/A';
-    
-    console.log(
-      `${(i+1).toString().padEnd(4)} | ${origDelta.toString().padEnd(14)} | ${convDelta.toString().padEnd(15)} | ${ratio.toString().padEnd(8)} | "${original.timings[i].text}"`
-    );
-  }
-}
-
-// Main
-const originalKar = './songs/fix/song.kar';
-const emkFile = './songs/fix/song.emk';
-
-console.log('Step 1: Analyzing original KAR file...');
-analyzeKarFile(originalKar);
-
-console.log('\n\nStep 2: Converting EMK to KAR...');
-const { convertEmkToKar } = require('./dist/index.js');
-
-const tempKar = './songs/fix/converted-test.kar';
-try {
-  const result = convertEmkToKar({
-    inputEmk: emkFile,
-    outputKar: tempKar,
-    keepIntermediateFiles: false
-  });
-  
-  console.log(`Conversion ${result.success ? 'SUCCESS' : 'FAILED'}`);
-  if (result.warnings.length > 0) {
-    console.log('Warnings:', result.warnings);
-  }
-  
-  console.log('\n\nStep 3: Comparing original vs converted...');
-  compareKarFiles(originalKar, tempKar);
-  
-  // Cleanup
-  if (fs.existsSync(tempKar)) {
-    fs.unlinkSync(tempKar);
-    console.log('\nCleaned up temporary file.');
-  }
-} catch (error) {
-  console.error('Error during conversion:', error.message);
-  console.error(error.stack);
-}

package/find-midi-in-block.js

@@ -1,96 +0,0 @@
-const fs = require('fs');
-const { inflateSync } = require('zlib');
-const { parseMidi } = require('midi-file');
-
-const XOR_KEY = Buffer.from([0xAF, 0xF2, 0x4C, 0x9C, 0xE9, 0xEA, 0x99, 0x43]);
-const MAGIC_SIGNATURE = '.SFDS';
-const ZLIB_SECOND_BYTES = new Set([0x01, 0x5E, 0x9C, 0xDA, 0x7D, 0x20, 0xBB]);
-
-function xorDecrypt(data) {
-  const decrypted = Buffer.alloc(data.length);
-  for (let i = 0; i < data.length; i++) {
-    decrypted[i] = data[i] ^ XOR_KEY[i % XOR_KEY.length];
-  }
-  return decrypted;
-}
-
-console.log('Finding MIDI in Block 3...\n');
-
-const emkBuffer = fs.readFileSync('./songs/emk/failed01.emk');
-const decryptedBuffer = xorDecrypt(emkBuffer);
-
-// Find block 3 (offset 387)
-const block3Compressed = decryptedBuffer.subarray(387);
-const block3 = inflateSync(block3Compressed);
-
-console.log(`Block 3 size: ${block3.length} bytes`);
-console.log(`First 64 bytes (hex):`);
-console.log(block3.subarray(0, 64).toString('hex').match(/.{1,2}/g).join(' '));
-console.log('');
-
-// Search for 'MThd'
-const mthdIndex = block3.indexOf('MThd');
-console.log(`Index of 'MThd': ${mthdIndex}`);
-
-if (mthdIndex >= 0) {
-  console.log(`\nFound 'MThd' at offset ${mthdIndex}!`);
-  console.log(`\nBytes before 'MThd':`);
-  console.log(`  HEX: ${block3.subarray(0, mthdIndex).toString('hex')}`);
-  console.log(`  ASCII: ${block3.subarray(0, mthdIndex).toString('ascii')}`);
-  console.log(`  Length: ${mthdIndex} bytes`);
-  
-  // Extract MIDI starting from MThd
-  const midiData = block3.subarray(mthdIndex);
-  console.log(`\nMIDI data size: ${midiData.length} bytes`);
-  console.log(`First 32 bytes of MIDI:`);
-  console.log(midiData.subarray(0, 32).toString('hex').match(/.{1,2}/g).join(' '));
-  
-  // Try to parse it
-  try {
-    const midi = parseMidi(midiData);
-    console.log(`\n✅ MIDI parsed successfully!`);
-    console.log(`  Format: ${midi.header.format}`);
-    console.log(`  Tracks: ${midi.tracks.length}`);
-    console.log(`  Ticks per beat: ${midi.header.ticksPerBeat}`);
-    
-    // Check tempo
-    let tempoFound = false;
-    midi.tracks.forEach((track, idx) => {
-      track.forEach(event => {
-        if (event.type === 'setTempo' && !tempoFound) {
-          const bpm = (60000000 / event.microsecondsPerBeat).toFixed(2);
-          console.log(`  Initial tempo: ${bpm} BPM (${event.microsecondsPerBeat} µs/beat) in Track ${idx}`);
-          tempoFound = true;
-        }
-      });
-    });
-    
-    if (!tempoFound) {
-      console.log(`  ⚠️  No tempo events found`);
-    }
-    
-    // Save the extracted MIDI
-    fs.writeFileSync('./songs/emk/failed01-extracted.mid', midiData);
-    console.log(`\n✓ Extracted MIDI saved to: ./songs/emk/failed01-extracted.mid`);
-    
-  } catch (err) {
-    console.log(`\n❌ Failed to parse MIDI: ${err.message}`);
-  }
-} else {
-  console.log('\n❌ No MThd signature found in Block 3');
-}
-
-// Also check what "zxio" might be
-console.log('\n' + '='.repeat(60));
-console.log('Analysis of header "zxio":');
-console.log('='.repeat(60));
-
-const header = block3.subarray(0, 12);
-console.log('Bytes: ' + header.toString('hex').match(/.{1,2}/g).join(' '));
-console.log('ASCII: ' + header.toString('ascii'));
-
-// Could be a custom header or file identification
-const possibleMagic = header.subarray(0, 4).toString('ascii');
-console.log(`\nFirst 4 bytes as string: "${possibleMagic}"`);
-console.log('This might be a custom EMK MIDI format identifier.');
-console.log('The standard EMK decoder needs to be updated to handle this format.');

package/fix-tempo.js

@@ -1,155 +0,0 @@
-const fs = require('fs');
-const { parseMidi, writeMidi } = require('midi-file');
-
-/**
- * Copy tempo events from source MIDI to target MIDI
- */
-function copyTempoEvents(sourceMidiPath, targetMidiPath, outputPath) {
-  console.log('Reading source MIDI (original KAR)...');
-  const sourceBuffer = fs.readFileSync(sourceMidiPath);
-  const sourceMidi = parseMidi(sourceBuffer);
-  
-  console.log('Reading target MIDI (converted from EMK)...');
-  const targetBuffer = fs.readFileSync(targetMidiPath);
-  const targetMidi = parseMidi(targetBuffer);
-  
-  // Extract all tempo events from source
-  const tempoEvents = [];
-  sourceMidi.tracks.forEach((track, trackIdx) => {
-    let absoluteTime = 0;
-    track.forEach((event, eventIdx) => {
-      absoluteTime += event.deltaTime;
-      if (event.type === 'setTempo') {
-        const bpm = 60000000 / event.microsecondsPerBeat;
-        tempoEvents.push({
-          trackIdx,
-          eventIdx,
-          absoluteTime,
-          deltaTime: event.deltaTime,
-          microsecondsPerBeat: event.microsecondsPerBeat,
-          bpm: bpm.toFixed(2)
-        });
-      }
-    });
-  });
-  
-  console.log(`\nFound ${tempoEvents.length} tempo event(s) in source:`);
-  tempoEvents.forEach((t, i) => {
-    console.log(`  ${i+1}. Track ${t.trackIdx}, Event ${t.eventIdx}, BPM ${t.bpm}, absolute time: ${t.absoluteTime}`);
-  });
-  
-  // Find and replace tempo events in target
-  let replaced = 0;
-  targetMidi.tracks.forEach((track, trackIdx) => {
-    for (let i = 0; i < track.length; i++) {
-      const event = track[i];
-      if (event.type === 'setTempo') {
-        const oldBpm = (60000000 / event.microsecondsPerBeat).toFixed(2);
-        
-        // Replace with first tempo from source
-        if (tempoEvents.length > 0) {
-          const newTempo = tempoEvents[0];
-          event.microsecondsPerBeat = newTempo.microsecondsPerBeat;
-          
-          console.log(`\nReplaced tempo in target Track ${trackIdx}, Event ${i}:`);
-          console.log(`  Old: ${oldBpm} BPM`);
-          console.log(`  New: ${newTempo.bpm} BPM`);
-          replaced++;
-        }
-      }
-    }
-  });
-  
-  if (replaced === 0) {
-    console.log('\n⚠️  No tempo events found in target to replace');
-    console.log('Adding tempo event to first track...');
-    
-    if (tempoEvents.length > 0 && targetMidi.tracks.length > 0) {
-      const newTempo = tempoEvents[0];
-      
-      // Insert tempo event at the beginning of first track (after deltaTime 0 events)
-      const firstTrack = targetMidi.tracks[0];
-      const tempoEvent = {
-        type: 'setTempo',
-        deltaTime: 0,
-        microsecondsPerBeat: newTempo.microsecondsPerBeat
-      };
-      
-      // Insert after any existing deltaTime 0 events
-      let insertIndex = 0;
-      while (insertIndex < firstTrack.length && firstTrack[insertIndex].deltaTime === 0) {
-        insertIndex++;
-      }
-      
-      firstTrack.splice(insertIndex, 0, tempoEvent);
-      console.log(`Added tempo event: ${newTempo.bpm} BPM to Track 0`);
-      replaced++;
-    }
-  }
-  
-  // Write output
-  console.log(`\nWriting fixed MIDI to: ${outputPath}`);
-  const outputBytes = writeMidi(targetMidi);
-  fs.writeFileSync(outputPath, Buffer.from(outputBytes));
-  
-  console.log(`✓ Fixed tempo in ${replaced} location(s)`);
-  
-  return { replaced, tempoEvents };
-}
-
-// Test with song.emk -> song.kar
-console.log('='.repeat(80));
-console.log('TEMPO FIX TEST');
-console.log('='.repeat(80));
-console.log('');
-
-// First convert EMK to KAR
-const { convertEmkToKar } = require('./dist/index.js');
-const tempKar = './songs/fix/converted-before-fix.kar';
-
-console.log('Step 1: Converting EMK to KAR...\n');
-convertEmkToKar({
-  inputEmk: './songs/fix/song.emk',
-  outputKar: tempKar,
-  keepIntermediateFiles: false
-});
-
-console.log('\nStep 2: Copying tempo from original KAR...\n');
-const fixedKar = './songs/fix/converted-fixed-tempo.kar';
-copyTempoEvents(
-  './songs/fix/song.kar',  // source (original)
-  tempKar,                  // target (converted)
-  fixedKar                  // output
-);
-
-// Verify
-console.log('\n' + '='.repeat(80));
-console.log('VERIFICATION');
-console.log('='.repeat(80));
-
-const verifyOriginal = parseMidi(fs.readFileSync('./songs/fix/song.kar'));
-const verifyFixed = parseMidi(fs.readFileSync(fixedKar));
-
-console.log('\nOriginal song.kar tempo:');
-verifyOriginal.tracks.forEach((track, idx) => {
-  track.forEach(event => {
-    if (event.type === 'setTempo') {
-      const bpm = (60000000 / event.microsecondsPerBeat).toFixed(2);
-      console.log(`  Track ${idx}: ${bpm} BPM`);
-    }
-  });
-});
-
-console.log('\nFixed converted KAR tempo:');
-verifyFixed.tracks.forEach((track, idx) => {
-  track.forEach(event => {
-    if (event.type === 'setTempo') {
-      const bpm = (60000000 / event.microsecondsPerBeat).toFixed(2);
-      console.log(`  Track ${idx}: ${bpm} BPM`);
-    }
-  });
-});
-
-// Cleanup temp file
-fs.unlinkSync(tempKar);
-console.log('\n✓ Test complete! Fixed file saved as: ' + fixedKar);

package/kar-diagnostic.js

@@ -1,158 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * KAR File Diagnostic Tool
- * 
- * This tool checks if a KAR file is valid and provides detailed diagnostics
- * Usage: node kar-diagnostic.js <path-to-kar-file>
- */
-
-const fs = require('fs');
-const path = require('path');
-
-function checkKarFile(filePath) {
-  console.log('='.repeat(60));
-  console.log('KAR File Diagnostic Tool');
-  console.log('='.repeat(60));
-  console.log('File:', filePath);
-  console.log('');
-
-  // Check if file exists
-  if (!fs.existsSync(filePath)) {
-    console.error('❌ File not found:', filePath);
-    process.exit(1);
-  }
-
-  // Read file
-  const data = fs.readFileSync(filePath);
-  console.log('✅ File exists');
-  console.log('   Size:', data.length, 'bytes');
-  console.log('');
-
-  // Check MThd header
-  console.log('--- MIDI Header Check ---');
-  const expectedHeader = Buffer.from([0x4D, 0x54, 0x68, 0x64]); // MThd
-  const actualHeader = data.subarray(0, 4);
-  
-  console.log('Expected: 4D 54 68 64 (MThd)');
-  console.log('Actual:  ', actualHeader.toString('hex').match(/.{2}/g).join(' '));
-  
-  if (Buffer.compare(expectedHeader, actualHeader) === 0) {
-    console.log('✅ Valid MThd header');
-  } else {
-    console.log('❌ Invalid header!');
-    console.log('   First 20 bytes:', data.subarray(0, 20).toString('hex'));
-    return false;
-  }
-  console.log('');
-
-  // Check MIDI structure
-  console.log('--- MIDI Structure ---');
-  const headerLength = data.readUInt32BE(4);
-  const format = data.readUInt16BE(8);
-  const numTracks = data.readUInt16BE(10);
-  const division = data.readUInt16BE(12);
-  
-  console.log('Header length:', headerLength, '(expected: 6)');
-  console.log('Format:', format, '(expected: 0 or 1)');
-  console.log('Number of tracks:', numTracks);
-  console.log('Division:', division);
-  
-  if (headerLength !== 6) {
-    console.log('⚠️  Unusual header length');
-  }
-  if (format > 2) {
-    console.log('⚠️  Invalid format');
-    return false;
-  }
-  if (numTracks === 0) {
-    console.log('❌ No tracks found');
-    return false;
-  }
-  console.log('✅ Valid structure');
-  console.log('');
-
-  // Check first track
-  console.log('--- First Track Check ---');
-  const firstTrackPos = 14;
-  const firstTrackHeader = data.subarray(firstTrackPos, firstTrackPos + 4).toString('ascii');
-  const firstTrackLength = data.readUInt32BE(firstTrackPos + 4);
-  
-  console.log('Track header:', firstTrackHeader, '(expected: MTrk)');
-  console.log('Track length:', firstTrackLength);
-  
-  if (firstTrackHeader !== 'MTrk') {
-    console.log('❌ Invalid track header');
-    return false;
-  }
-  console.log('✅ Valid first track');
-  console.log('');
-
-  // Try parsing with midi-file
-  console.log('--- Library Compatibility Test ---');
-  try {
-    const { parseMidi } = require('midi-file');
-    const parsed = parseMidi(data);
-    console.log('✅ midi-file library can parse');
-    console.log('   Parsed tracks:', parsed.tracks.length);
-    console.log('   Format:', parsed.header.format);
-    console.log('   Division:', parsed.header.ticksPerBeat || parsed.header.framesPerSecond);
-  } catch (e) {
-    console.log('❌ midi-file library error:', e.message);
-    return false;
-  }
-  console.log('');
-
-  // Check for karaoke content
-  console.log('--- Karaoke Content Check ---');
-  const fileContent = data.toString('binary');
-  const hasKaraoke = fileContent.includes('@T');
-  const hasWords = fileContent.includes('Words');
-  
-  console.log('Contains @T markers:', hasKaraoke ? '✅' : '❌');
-  console.log('Contains "Words" track:', hasWords ? '✅' : '❌');
-  console.log('');
-
-  // Summary
-  console.log('='.repeat(60));
-  console.log('SUMMARY: File is VALID ✅');
-  console.log('='.repeat(60));
-  console.log('');
-  console.log('If you still get errors when using this file:');
-  console.log('1. Check file transfer method (use binary mode)');
-  console.log('2. Verify file size matches:', data.length, 'bytes');
-  console.log('3. Check first 4 bytes: should be 4D 54 68 64');
-  console.log('4. Try a different MIDI player/library');
-  console.log('5. Check if server is re-encoding the file');
-  console.log('');
-
-  return true;
-}
-
-// Main
-const args = process.argv.slice(2);
-if (args.length === 0) {
-  console.error('Usage: node kar-diagnostic.js <path-to-kar-file>');
-  console.error('');
-  console.error('Example:');
-  console.error('  node kar-diagnostic.js output.kar');
-  console.error('  node kar-diagnostic.js /path/to/song.kar');
-  process.exit(1);
-}
-
-const filePath = args[0];
-try {
-  checkKarFile(filePath);
-} catch (error) {
-  console.error('');
-  console.error('❌ Error:', error.message);
-  console.error('');
-  console.error('Stack trace:');
-  console.error(error.stack);
-  process.exit(1);
-}
-
-
-
-
-