react-native-simple-note-pitch-detector 0.5.1 → 0.6.1

package/android/.idea/gradle.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="GradleMigrationSettings" migrationVersion="1" />
+  <component name="GradleSettings">
+    <option name="linkedExternalProjectsSettings">
+      <GradleProjectSettings>
+        <option name="testRunner" value="CHOOSE_PER_TEST" />
+        <option name="externalProjectPath" value="$PROJECT_DIR$" />
+        <option name="gradleJvm" value="#GRADLE_LOCAL_JAVA_HOME" />
+      </GradleProjectSettings>
+    </option>
+  </component>
+</project>

package/android/.idea/migrations.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectMigrations">
+    <option name="MigrateToGradleLocalJavaHome">
+      <set>
+        <option value="$PROJECT_DIR$" />
+      </set>
+    </option>
+  </component>
+</project>

package/android/.idea/misc.xml

@@ -0,0 +1,9 @@
+<project version="4">
+  <component name="ExternalStorageConfigurationManager" enabled="true" />
+  <component name="ProjectRootManager">
+    <output url="file://$PROJECT_DIR$/build/classes" />
+  </component>
+  <component name="ProjectType">
+    <option name="id" value="Android" />
+  </component>
+</project>

package/android/.idea/runConfigurations.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="RunConfigurationProducerService">
+    <option name="ignoredProducers">
+      <set>
+        <option value="com.intellij.execution.junit.AbstractAllInDirectoryConfigurationProducer" />
+        <option value="com.intellij.execution.junit.AllInPackageConfigurationProducer" />
+        <option value="com.intellij.execution.junit.PatternConfigurationProducer" />
+        <option value="com.intellij.execution.junit.TestInClassConfigurationProducer" />
+        <option value="com.intellij.execution.junit.UniqueIdConfigurationProducer" />
+        <option value="com.intellij.execution.junit.testDiscovery.JUnitTestDiscoveryConfigurationProducer" />
+        <option value="org.jetbrains.kotlin.idea.junit.KotlinJUnitRunConfigurationProducer" />
+        <option value="org.jetbrains.kotlin.idea.junit.KotlinPatternConfigurationProducer" />
+      </set>
+    </option>
+  </component>
+</project>

package/android/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/.." vcs="Git" />
+  </component>
+</project>

package/android/local.properties

@@ -0,0 +1,8 @@
+## This file must *NOT* be checked into Version Control Systems,
+# as it contains information specific to your local configuration.
+#
+# Location of the SDK. This is only used by Gradle.
+# For customization when using a Version Control System, please read the
+# header note.
+#Mon Feb 02 16:28:55 PST 2026
+sdk.dir=/Users/derekdawson/Library/Android/sdk

package/android/src/main/java/expo/modules/simplenotepitchdetector/PitchAnalyzer.kt

@@ -1,5 +1,6 @@
 package expo.modules.simplepitchdetector
 
+import android.util.Log
 import be.tarsos.dsp.AudioDispatcher
 import be.tarsos.dsp.AudioProcessor
 import be.tarsos.dsp.io.android.AudioDispatcherFactory
@@ -11,6 +12,8 @@ import kotlin.math.round
 import kotlin.math.pow
 import kotlin.math.abs
 
+private const val TAG = "PitchAnalyzer"
+
 data class PitchData(
     val note: String,
     val octave: Int,
@@ -24,8 +27,16 @@ class PitchAnalyzer {
     private val notes = arrayOf("C","C#","D","D#","E","F","F#","G","G#","A","A#","B")
 
     private lateinit var onPitchDetected: (PitchData) -> Unit
+    private var onStatus: ((String, String) -> Unit)? = null
     private var isRecording = false
     private var levelThreshold = -30f
+    // Configurable buffer size - can be changed from JS
+    // Larger buffer = better low frequency detection, more latency
+    // Smaller buffer = better high frequency detection, less latency
+    private var bufferSize = 2048
+    // Configurable algorithm - can be changed from JS
+    private var algorithm = PitchEstimationAlgorithm.FFT_YIN
+    private var algorithmName = "fft_yin"
 
     private var dispatcher: AudioDispatcher? = null
     private var processor: AudioProcessor? = null
@@ -36,15 +47,26 @@ class PitchAnalyzer {
         val decibel = e.getdBSPL().toFloat()
         // Only process if above the level threshold
         if (decibel > levelThreshold) {
+            // Note: Not logging every pitch detection to JS to avoid flooding
+            // Use adb logcat for verbose pitch logs
+            Log.v(TAG, "Pitch detected: ${pitchInHz}Hz at ${decibel}dB")
             process(pitchInHz, decibel)
         }
     }
 
     private fun prepare() {
-        processor =
-            PitchProcessor(PitchEstimationAlgorithm.FFT_YIN, 22050f, 1024, handler)
-        dispatcher = AudioDispatcherFactory.fromDefaultMicrophone(22050, 1024, 0)
-        dispatcher?.addAudioProcessor(processor)
+        try {
+            logStatus("debug", "prepare() called with bufferSize=$bufferSize, algorithm=$algorithmName")
+            processor = PitchProcessor(algorithm, 22050f, bufferSize, handler)
+            logStatus("debug", "PitchProcessor created successfully")
+            dispatcher = AudioDispatcherFactory.fromDefaultMicrophone(22050, bufferSize, 0)
+            logStatus("debug", "AudioDispatcher created successfully: $dispatcher")
+            dispatcher?.addAudioProcessor(processor)
+            logStatus("debug", "AudioProcessor added to dispatcher")
+        } catch (e: Exception) {
+            logStatus("error", "Error in prepare(): ${e.message}")
+            throw e
+        }
     }
 
     private fun process(pitchInHz: Float, decibel: Float) {
@@ -82,15 +104,62 @@ class PitchAnalyzer {
         this.onPitchDetected = listener
     }
 
+    fun setOnStatusListener(listener: (String, String) -> Unit) {
+        this.onStatus = listener
+    }
+
+    private fun logStatus(level: String, message: String) {
+        when (level) {
+            "debug" -> Log.d(TAG, message)
+            "error" -> Log.e(TAG, message)
+            "verbose" -> Log.v(TAG, message)
+            else -> Log.d(TAG, message)
+        }
+        onStatus?.invoke(level, message)
+    }
+
     fun setLevelThreshold(threshold: Float) {
         this.levelThreshold = threshold
     }
 
+    fun setBufferSize(size: Int) {
+        this.bufferSize = size
+    }
+
+    fun getBufferSize(): Int {
+        return this.bufferSize
+    }
+
+    fun setAlgorithm(name: String) {
+        this.algorithmName = name.lowercase()
+        this.algorithm = when (this.algorithmName) {
+            "yin" -> PitchEstimationAlgorithm.YIN
+            "fft_yin" -> PitchEstimationAlgorithm.FFT_YIN
+            "mpm" -> PitchEstimationAlgorithm.MPM
+            "fft_pitch" -> PitchEstimationAlgorithm.FFT_PITCH
+            "dynamic_wavelet" -> PitchEstimationAlgorithm.DYNAMIC_WAVELET
+            "amdf" -> PitchEstimationAlgorithm.AMDF
+            else -> PitchEstimationAlgorithm.FFT_YIN // Default
+        }
+    }
+
+    fun getAlgorithm(): String {
+        return this.algorithmName
+    }
+
     fun start() {
-        prepare()
-        runner = Thread(dispatcher)
-        runner?.start()
-        isRecording = true
+        try {
+            logStatus("debug", "start() called")
+            prepare()
+            runner = Thread(dispatcher)
+            logStatus("debug", "Thread created, starting...")
+            runner?.start()
+            isRecording = true
+            logStatus("debug", "Recording started successfully")
+        } catch (e: Exception) {
+            logStatus("error", "Error in start(): ${e.message}")
+            isRecording = false
+        }
     }
 
     fun stop() {

package/android/src/main/java/expo/modules/simplenotepitchdetector/ReactNativeSimpleNotePitchDetectorModule.kt

@@ -10,11 +10,21 @@ class ReactNativeSimpleNotePitchDetectorModule : Module() {
 
   private val pitchAnalyzer = PitchAnalyzer()
 
+  private fun sendStatus(level: String, message: String) {
+    this.sendEvent(
+      "onStatus",
+      bundleOf(
+        "level" to level,
+        "message" to message
+      )
+    )
+  }
+
   override fun definition() = ModuleDefinition {
 
     Name("ReactNativeSimpleNotePitchDetector")
 
-    Events("onChangeNote")
+    Events("onChangeNote", "onStatus")
 
     Function("isRecording") {
       pitchAnalyzer.isRecording()
@@ -33,6 +43,10 @@ class ReactNativeSimpleNotePitchDetectorModule : Module() {
         )
       }
 
+      pitchAnalyzer.setOnStatusListener { level: String, message: String ->
+        this@ReactNativeSimpleNotePitchDetectorModule.sendStatus(level, message)
+      }
+
       pitchAnalyzer.start()
     }
 
@@ -43,5 +57,29 @@ class ReactNativeSimpleNotePitchDetectorModule : Module() {
     Function("setLevelThreshold") { threshold: Double ->
       pitchAnalyzer.setLevelThreshold(threshold.toFloat())
     }
+
+    // Allow JS to configure the buffer size
+    // Must be called before start() to take effect
+    // Common values: 1024 (better for high frequencies), 2048 (balanced), 4096 (better for low frequencies)
+    Function("setBufferSize") { size: Int ->
+      pitchAnalyzer.setBufferSize(size)
+    }
+
+    // Get current buffer size
+    Function("getBufferSize") {
+      pitchAnalyzer.getBufferSize()
+    }
+
+    // Allow JS to configure the estimation algorithm
+    // Android options: "yin", "fft_yin", "mpm", "fft_pitch", "dynamic_wavelet", "amdf"
+    // Must be called before start() to take effect
+    Function("setAlgorithm") { algorithm: String ->
+      pitchAnalyzer.setAlgorithm(algorithm)
+    }
+
+    // Get current algorithm name
+    Function("getAlgorithm") {
+      pitchAnalyzer.getAlgorithm()
+    }
   }
 }

package/build/ReactNativeSimpleNotePitchDetectorModule.web.d.ts

@@ -2,8 +2,13 @@ import { ChangeEventPayload } from "./ReactNativeSimpleNotePitchDetector.types";
 declare const _default: {
     start: () => void;
     stop: () => void;
-    isRecording: () => void;
+    isRecording: () => boolean;
     onChangePitch: (_: ChangeEventPayload) => void;
+    setLevelThreshold: (_: number) => void;
+    setBufferSize: (_: number) => void;
+    getBufferSize: () => number;
+    setAlgorithm: (_: string) => void;
+    getAlgorithm: () => string;
 };
 export default _default;
 //# sourceMappingURL=ReactNativeSimpleNotePitchDetectorModule.web.d.ts.map

package/build/ReactNativeSimpleNotePitchDetectorModule.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeSimpleNotePitchDetectorModule.web.d.ts","sourceRoot":"","sources":["../src/ReactNativeSimpleNotePitchDetectorModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;;;;;uBAM3D,kBAAkB;;AAJvC,wBAKE"}
+{"version":3,"file":"ReactNativeSimpleNotePitchDetectorModule.web.d.ts","sourceRoot":"","sources":["../src/ReactNativeSimpleNotePitchDetectorModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;;;;;uBAM3D,kBAAkB;2BACd,MAAM;uBACV,MAAM;;sBAEP,MAAM;;;AAR1B,wBAUE"}

package/build/ReactNativeSimpleNotePitchDetectorModule.web.js

@@ -1,7 +1,12 @@
 export default {
     start: () => { },
     stop: () => { },
-    isRecording: () => { },
+    isRecording: () => false,
     onChangePitch: (_) => { },
+    setLevelThreshold: (_) => { },
+    setBufferSize: (_) => { },
+    getBufferSize: () => 8192,
+    setAlgorithm: (_) => { },
+    getAlgorithm: () => "yin",
 };
 //# sourceMappingURL=ReactNativeSimpleNotePitchDetectorModule.web.js.map

package/build/ReactNativeSimpleNotePitchDetectorModule.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReactNativeSimpleNotePitchDetectorModule.web.js","sourceRoot":"","sources":["../src/ReactNativeSimpleNotePitchDetectorModule.web.ts"],"names":[],"mappings":"AAEA,eAAe;IACb,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;IACrB,aAAa,EAAE,CAAC,CAAqB,EAAE,EAAE,GAAE,CAAC;CAC7C,CAAC","sourcesContent":["import { ChangeEventPayload } from \"./ReactNativeSimpleNotePitchDetector.types\";\n\nexport default {\n  start: () => {},\n  stop: () => {},\n  isRecording: () => {},\n  onChangePitch: (_: ChangeEventPayload) => {},\n};\n"]}
+{"version":3,"file":"ReactNativeSimpleNotePitchDetectorModule.web.js","sourceRoot":"","sources":["../src/ReactNativeSimpleNotePitchDetectorModule.web.ts"],"names":[],"mappings":"AAEA,eAAe;IACb,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK;IACxB,aAAa,EAAE,CAAC,CAAqB,EAAE,EAAE,GAAE,CAAC;IAC5C,iBAAiB,EAAE,CAAC,CAAS,EAAE,EAAE,GAAE,CAAC;IACpC,aAAa,EAAE,CAAC,CAAS,EAAE,EAAE,GAAE,CAAC;IAChC,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI;IACzB,YAAY,EAAE,CAAC,CAAS,EAAE,EAAE,GAAE,CAAC;IAC/B,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK;CAC1B,CAAC","sourcesContent":["import { ChangeEventPayload } from \"./ReactNativeSimpleNotePitchDetector.types\";\n\nexport default {\n  start: () => {},\n  stop: () => {},\n  isRecording: () => false,\n  onChangePitch: (_: ChangeEventPayload) => {},\n  setLevelThreshold: (_: number) => {},\n  setBufferSize: (_: number) => {},\n  getBufferSize: () => 8192,\n  setAlgorithm: (_: string) => {},\n  getAlgorithm: () => \"yin\",\n};\n"]}

package/build/index.d.ts

@@ -11,6 +11,71 @@ export declare function isRecording(): any;
  * @param threshold - Level threshold in dB (e.g., -30, -35, -40)
  */
 export declare function setLevelThreshold(threshold: number): any;
+/**
+ * Set the buffer size for pitch detection.
+ * Must be called before start() or will restart the engine if already running.
+ *
+ * Buffer size affects the trade-off between frequency range and responsiveness:
+ * - Smaller buffer (2048-4096): Better for high frequencies, faster response, but less accurate for low notes
+ * - Larger buffer (8192-16384): Better for low frequencies, more accurate, but slightly more latency
+ *
+ * iOS defaults to 8192, Android defaults to 2048.
+ *
+ * Recommended values:
+ * - 4096: Good balance for most use cases
+ * - 8192: Better for bass instruments or full piano range (iOS default)
+ * - 2048: Better for high-pitched instruments, faster response (Android default)
+ *
+ * @param size - Buffer size (must be power of 2: 1024, 2048, 4096, 8192, 16384)
+ */
+export declare function setBufferSize(size: number): any;
+/**
+ * Get the current buffer size.
+ * @returns Current buffer size
+ */
+export declare function getBufferSize(): number;
+/**
+ * Set the pitch estimation algorithm.
+ * Must be called before start() or will restart the engine if already running.
+ *
+ * Available algorithms differ by platform:
+ *
+ * **iOS (Beethoven library):**
+ * - "yin" (default) - YIN algorithm, good for monophonic instruments
+ * - "hps" - Harmonic Product Spectrum
+ * - "barycentric" - Barycentric interpolation
+ * - "quadradic" - Quadratic interpolation
+ * - "jains" - Jain's method
+ * - "quinnsFirst" - Quinn's first estimator
+ * - "quinnsSecond" - Quinn's second estimator
+ * - "maxValue" - Maximum value method
+ *
+ * **Android (TarsosDSP library):**
+ * - "fft_yin" (default) - FFT-based YIN, faster than pure YIN
+ * - "yin" - Pure YIN algorithm
+ * - "mpm" - McLeod Pitch Method, good for speech and music
+ * - "fft_pitch" - FFT bin with most energy
+ * - "dynamic_wavelet" - Dynamic wavelet algorithm
+ * - "amdf" - Average Magnitude Difference Function
+ *
+ * @param algorithm - Algorithm name (case-insensitive)
+ */
+export declare function setAlgorithm(algorithm: string): any;
+/**
+ * Get the current algorithm name.
+ * @returns Current algorithm name
+ */
+export declare function getAlgorithm(): string;
 export declare function onChangeNote(listener: (event: ChangeEventPayload) => void): Subscription;
+export interface StatusEventPayload {
+    level: "debug" | "error" | "verbose";
+    message: string;
+}
+/**
+ * Listen for status/debug messages from the native module.
+ * Useful for debugging audio initialization issues.
+ * @param listener - Callback that receives status events with level and message
+ */
+export declare function onStatus(listener: (event: StatusEventPayload) => void): Subscription;
 export { ReactNativeSimpleNotePitchDetectorViewProps, ChangeEventPayload };
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,2CAA2C,EAC5C,MAAM,4CAA4C,CAAC;AAEpD,wBAAgB,KAAK,QAEpB;AAED,wBAAgB,IAAI,QAEnB;AAED,wBAAgB,WAAW,QAE1B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,OAElD;AAOD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,YAAY,CAEd;AAED,OAAO,EAAE,2CAA2C,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,2CAA2C,EAC5C,MAAM,4CAA4C,CAAC;AAEpD,wBAAgB,KAAK,QAEpB;AAED,wBAAgB,IAAI,QAEnB;AAED,wBAAgB,WAAW,QAE1B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,OAElD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,OAEzC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,OAE7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAOD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,YAAY,CAEd;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC5C,YAAY,CAEd;AAED,OAAO,EAAE,2CAA2C,EAAE,kBAAkB,EAAE,CAAC"}

package/build/index.js

@@ -19,9 +19,80 @@ export function isRecording() {
 export function setLevelThreshold(threshold) {
     return ReactNativeSimpleNotePitchDetectorModule.setLevelThreshold(threshold);
 }
+/**
+ * Set the buffer size for pitch detection.
+ * Must be called before start() or will restart the engine if already running.
+ *
+ * Buffer size affects the trade-off between frequency range and responsiveness:
+ * - Smaller buffer (2048-4096): Better for high frequencies, faster response, but less accurate for low notes
+ * - Larger buffer (8192-16384): Better for low frequencies, more accurate, but slightly more latency
+ *
+ * iOS defaults to 8192, Android defaults to 2048.
+ *
+ * Recommended values:
+ * - 4096: Good balance for most use cases
+ * - 8192: Better for bass instruments or full piano range (iOS default)
+ * - 2048: Better for high-pitched instruments, faster response (Android default)
+ *
+ * @param size - Buffer size (must be power of 2: 1024, 2048, 4096, 8192, 16384)
+ */
+export function setBufferSize(size) {
+    return ReactNativeSimpleNotePitchDetectorModule.setBufferSize(size);
+}
+/**
+ * Get the current buffer size.
+ * @returns Current buffer size
+ */
+export function getBufferSize() {
+    return ReactNativeSimpleNotePitchDetectorModule.getBufferSize();
+}
+/**
+ * Set the pitch estimation algorithm.
+ * Must be called before start() or will restart the engine if already running.
+ *
+ * Available algorithms differ by platform:
+ *
+ * **iOS (Beethoven library):**
+ * - "yin" (default) - YIN algorithm, good for monophonic instruments
+ * - "hps" - Harmonic Product Spectrum
+ * - "barycentric" - Barycentric interpolation
+ * - "quadradic" - Quadratic interpolation
+ * - "jains" - Jain's method
+ * - "quinnsFirst" - Quinn's first estimator
+ * - "quinnsSecond" - Quinn's second estimator
+ * - "maxValue" - Maximum value method
+ *
+ * **Android (TarsosDSP library):**
+ * - "fft_yin" (default) - FFT-based YIN, faster than pure YIN
+ * - "yin" - Pure YIN algorithm
+ * - "mpm" - McLeod Pitch Method, good for speech and music
+ * - "fft_pitch" - FFT bin with most energy
+ * - "dynamic_wavelet" - Dynamic wavelet algorithm
+ * - "amdf" - Average Magnitude Difference Function
+ *
+ * @param algorithm - Algorithm name (case-insensitive)
+ */
+export function setAlgorithm(algorithm) {
+    return ReactNativeSimpleNotePitchDetectorModule.setAlgorithm(algorithm);
+}
+/**
+ * Get the current algorithm name.
+ * @returns Current algorithm name
+ */
+export function getAlgorithm() {
+    return ReactNativeSimpleNotePitchDetectorModule.getAlgorithm();
+}
 const emitter = new EventEmitter(ReactNativeSimpleNotePitchDetectorModule ??
     NativeModulesProxy.ReactNativeSimpleNotePitchDetector);
 export function onChangeNote(listener) {
     return emitter.addListener("onChangeNote", listener);
 }
+/**
+ * Listen for status/debug messages from the native module.
+ * Useful for debugging audio initialization issues.
+ * @param listener - Callback that receives status events with level and message
+ */
+export function onStatus(listener) {
+    return emitter.addListener("onStatus", listener);
+}
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,GAEb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,wCAAwC,MAAM,4CAA4C,CAAC;AAMlG,MAAM,UAAU,KAAK;IACnB,OAAO,wCAAwC,CAAC,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,OAAO,wCAAwC,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,wCAAwC,CAAC,WAAW,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,wCAAwC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B,wCAAwC;IACtC,kBAAkB,CAAC,kCAAkC,CACxD,CAAC;AAEF,MAAM,UAAU,YAAY,CAC1B,QAA6C;IAE7C,OAAO,OAAO,CAAC,WAAW,CAAqB,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC","sourcesContent":["import {\n  NativeModulesProxy,\n  EventEmitter,\n  Subscription,\n} from \"expo-modules-core\";\n\nimport ReactNativeSimpleNotePitchDetectorModule from \"./ReactNativeSimpleNotePitchDetectorModule\";\nimport {\n  ChangeEventPayload,\n  ReactNativeSimpleNotePitchDetectorViewProps,\n} from \"./ReactNativeSimpleNotePitchDetector.types\";\n\nexport function start() {\n  return ReactNativeSimpleNotePitchDetectorModule.start();\n}\n\nexport function stop() {\n  return ReactNativeSimpleNotePitchDetectorModule.stop();\n}\n\nexport function isRecording() {\n  return ReactNativeSimpleNotePitchDetectorModule.isRecording();\n}\n\n/**\n * Set the minimum audio level threshold for pitch detection.\n * Values are in dB (e.g., -30 means sounds quieter than -30dB are ignored).\n * Lower values = more sensitive (picks up quieter sounds).\n * Default is -30.\n * @param threshold - Level threshold in dB (e.g., -30, -35, -40)\n */\nexport function setLevelThreshold(threshold: number) {\n  return ReactNativeSimpleNotePitchDetectorModule.setLevelThreshold(threshold);\n}\n\nconst emitter = new EventEmitter(\n  ReactNativeSimpleNotePitchDetectorModule ??\n    NativeModulesProxy.ReactNativeSimpleNotePitchDetector\n);\n\nexport function onChangeNote(\n  listener: (event: ChangeEventPayload) => void\n): Subscription {\n  return emitter.addListener<ChangeEventPayload>(\"onChangeNote\", listener);\n}\n\nexport { ReactNativeSimpleNotePitchDetectorViewProps, ChangeEventPayload };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,GAEb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,wCAAwC,MAAM,4CAA4C,CAAC;AAMlG,MAAM,UAAU,KAAK;IACnB,OAAO,wCAAwC,CAAC,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,OAAO,wCAAwC,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,wCAAwC,CAAC,WAAW,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,wCAAwC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,wCAAwC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,wCAAwC,CAAC,aAAa,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,wCAAwC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,wCAAwC,CAAC,YAAY,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B,wCAAwC;IACtC,kBAAkB,CAAC,kCAAkC,CACxD,CAAC;AAEF,MAAM,UAAU,YAAY,CAC1B,QAA6C;IAE7C,OAAO,OAAO,CAAC,WAAW,CAAqB,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,QAA6C;IAE7C,OAAO,OAAO,CAAC,WAAW,CAAqB,UAAU,EAAE,QAAQ,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import {\n  NativeModulesProxy,\n  EventEmitter,\n  Subscription,\n} from \"expo-modules-core\";\n\nimport ReactNativeSimpleNotePitchDetectorModule from \"./ReactNativeSimpleNotePitchDetectorModule\";\nimport {\n  ChangeEventPayload,\n  ReactNativeSimpleNotePitchDetectorViewProps,\n} from \"./ReactNativeSimpleNotePitchDetector.types\";\n\nexport function start() {\n  return ReactNativeSimpleNotePitchDetectorModule.start();\n}\n\nexport function stop() {\n  return ReactNativeSimpleNotePitchDetectorModule.stop();\n}\n\nexport function isRecording() {\n  return ReactNativeSimpleNotePitchDetectorModule.isRecording();\n}\n\n/**\n * Set the minimum audio level threshold for pitch detection.\n * Values are in dB (e.g., -30 means sounds quieter than -30dB are ignored).\n * Lower values = more sensitive (picks up quieter sounds).\n * Default is -30.\n * @param threshold - Level threshold in dB (e.g., -30, -35, -40)\n */\nexport function setLevelThreshold(threshold: number) {\n  return ReactNativeSimpleNotePitchDetectorModule.setLevelThreshold(threshold);\n}\n\n/**\n * Set the buffer size for pitch detection.\n * Must be called before start() or will restart the engine if already running.\n *\n * Buffer size affects the trade-off between frequency range and responsiveness:\n * - Smaller buffer (2048-4096): Better for high frequencies, faster response, but less accurate for low notes\n * - Larger buffer (8192-16384): Better for low frequencies, more accurate, but slightly more latency\n *\n * iOS defaults to 8192, Android defaults to 2048.\n *\n * Recommended values:\n * - 4096: Good balance for most use cases\n * - 8192: Better for bass instruments or full piano range (iOS default)\n * - 2048: Better for high-pitched instruments, faster response (Android default)\n *\n * @param size - Buffer size (must be power of 2: 1024, 2048, 4096, 8192, 16384)\n */\nexport function setBufferSize(size: number) {\n  return ReactNativeSimpleNotePitchDetectorModule.setBufferSize(size);\n}\n\n/**\n * Get the current buffer size.\n * @returns Current buffer size\n */\nexport function getBufferSize(): number {\n  return ReactNativeSimpleNotePitchDetectorModule.getBufferSize();\n}\n\n/**\n * Set the pitch estimation algorithm.\n * Must be called before start() or will restart the engine if already running.\n *\n * Available algorithms differ by platform:\n *\n * **iOS (Beethoven library):**\n * - \"yin\" (default) - YIN algorithm, good for monophonic instruments\n * - \"hps\" - Harmonic Product Spectrum\n * - \"barycentric\" - Barycentric interpolation\n * - \"quadradic\" - Quadratic interpolation\n * - \"jains\" - Jain's method\n * - \"quinnsFirst\" - Quinn's first estimator\n * - \"quinnsSecond\" - Quinn's second estimator\n * - \"maxValue\" - Maximum value method\n *\n * **Android (TarsosDSP library):**\n * - \"fft_yin\" (default) - FFT-based YIN, faster than pure YIN\n * - \"yin\" - Pure YIN algorithm\n * - \"mpm\" - McLeod Pitch Method, good for speech and music\n * - \"fft_pitch\" - FFT bin with most energy\n * - \"dynamic_wavelet\" - Dynamic wavelet algorithm\n * - \"amdf\" - Average Magnitude Difference Function\n *\n * @param algorithm - Algorithm name (case-insensitive)\n */\nexport function setAlgorithm(algorithm: string) {\n  return ReactNativeSimpleNotePitchDetectorModule.setAlgorithm(algorithm);\n}\n\n/**\n * Get the current algorithm name.\n * @returns Current algorithm name\n */\nexport function getAlgorithm(): string {\n  return ReactNativeSimpleNotePitchDetectorModule.getAlgorithm();\n}\n\nconst emitter = new EventEmitter(\n  ReactNativeSimpleNotePitchDetectorModule ??\n    NativeModulesProxy.ReactNativeSimpleNotePitchDetector\n);\n\nexport function onChangeNote(\n  listener: (event: ChangeEventPayload) => void\n): Subscription {\n  return emitter.addListener<ChangeEventPayload>(\"onChangeNote\", listener);\n}\n\nexport interface StatusEventPayload {\n  level: \"debug\" | \"error\" | \"verbose\";\n  message: string;\n}\n\n/**\n * Listen for status/debug messages from the native module.\n * Useful for debugging audio initialization issues.\n * @param listener - Callback that receives status events with level and message\n */\nexport function onStatus(\n  listener: (event: StatusEventPayload) => void\n): Subscription {\n  return emitter.addListener<StatusEventPayload>(\"onStatus\", listener);\n}\n\nexport { ReactNativeSimpleNotePitchDetectorViewProps, ChangeEventPayload };\n"]}

package/ios/ReactNativeSimpleNotePitchDetectorModule.swift

@@ -5,39 +5,128 @@ import Pitchy
 
 public class ReactNativeSimpleNotePitchDetectorModule: Module {
 
+    // Configurable buffer size - can be changed from JS
+    // Larger buffer = better low frequency detection, more latency
+    // Smaller buffer = better high frequency detection, less latency
+    private var bufferSize: UInt32 = 8192
+    private var estimationStrategy: EstimationStrategy = .yin
+    private var _pitchEngine: PitchEngine?
+
+    private func sendStatus(_ level: String, _ message: String) {
+        self.sendEvent("onStatus", [
+            "level": level,
+            "message": message
+        ])
+    }
+
     public func definition() -> ModuleDefinition {
 
         Name("ReactNativeSimpleNotePitchDetector")
 
-        Events("onChangeNote")
+        Events("onChangeNote", "onStatus")
 
         Function("start") {
-            pitchEngine.start()
+            self.sendStatus("debug", "start() called with bufferSize=\(self.bufferSize), algorithm=\(self.estimationStrategy)")
+            self.pitchEngine.start()
+            self.sendStatus("debug", "Recording started successfully")
         }
 
         Function("stop") {
-            pitchEngine.stop()
+            self.pitchEngine.stop()
         }
 
         Function("isRecording") {
-            return pitchEngine.active
+            return self.pitchEngine.active
         }
 
         // Allow JS to configure the level threshold
         Function("setLevelThreshold") { (threshold: Double) in
             self.pitchEngine.levelThreshold = Float(threshold)
         }
+
+        // Allow JS to configure the buffer size
+        // Must be called before start() or after stop() to take effect
+        // Common values: 4096 (better for high frequencies), 8192 (balanced), 16384 (better for low frequencies)
+        Function("setBufferSize") { (size: Int) in
+            let wasActive = self._pitchEngine?.active ?? false
+            if wasActive {
+                self._pitchEngine?.stop()
+            }
+            self.bufferSize = UInt32(size)
+            self._pitchEngine = nil // Force recreation with new buffer size
+            if wasActive {
+                self.pitchEngine.start()
+            }
+        }
+
+        // Get current buffer size
+        Function("getBufferSize") {
+            return Int(self.bufferSize)
+        }
+
+        // Allow JS to configure the estimation algorithm
+        // iOS options: "yin", "hps", "barycentric", "quadradic", "jains", "quinnsFirst", "quinnsSecond", "maxValue"
+        // Must be called before start() or will restart the engine
+        Function("setAlgorithm") { (algorithm: String) in
+            let wasActive = self._pitchEngine?.active ?? false
+            if wasActive {
+                self._pitchEngine?.stop()
+            }
+
+            switch algorithm.lowercased() {
+            case "yin":
+                self.estimationStrategy = .yin
+            case "hps":
+                self.estimationStrategy = .hps
+            case "barycentric":
+                self.estimationStrategy = .barycentric
+            case "quadradic":
+                self.estimationStrategy = .quadradic
+            case "jains":
+                self.estimationStrategy = .jains
+            case "quinnsfirst":
+                self.estimationStrategy = .quinnsFirst
+            case "quinnssecond":
+                self.estimationStrategy = .quinnsSecond
+            case "maxvalue":
+                self.estimationStrategy = .maxValue
+            default:
+                // Default to YIN if unknown
+                self.estimationStrategy = .yin
+            }
+
+            self._pitchEngine = nil // Force recreation with new algorithm
+            if wasActive {
+                self.pitchEngine.start()
+            }
+        }
+
+        // Get current algorithm name
+        Function("getAlgorithm") {
+            switch self.estimationStrategy {
+            case .yin: return "yin"
+            case .hps: return "hps"
+            case .barycentric: return "barycentric"
+            case .quadradic: return "quadradic"
+            case .jains: return "jains"
+            case .quinnsFirst: return "quinnsFirst"
+            case .quinnsSecond: return "quinnsSecond"
+            case .maxValue: return "maxValue"
+            }
+        }
     }
 
-    lazy var pitchEngine: PitchEngine = { [weak self] in
-        // Larger buffer (8192) = more accurate pitch detection, slightly more latency
-        // Using .yin which is generally best for monophonic instruments
-        let config = Config(bufferSize: 8192, estimationStrategy: .yin)
-        let pitchEngine = PitchEngine(config: config, delegate: self)
+    var pitchEngine: PitchEngine {
+        if let engine = _pitchEngine {
+            return engine
+        }
+        let config = Config(bufferSize: bufferSize, estimationStrategy: estimationStrategy)
+        let engine = PitchEngine(config: config, delegate: self)
         // Default threshold - can be adjusted from JS via setLevelThreshold()
-        pitchEngine.levelThreshold = -30
-        return pitchEngine
-    }()
+        engine.levelThreshold = -30
+        _pitchEngine = engine
+        return engine
+    }
 }
 
 extension ReactNativeSimpleNotePitchDetectorModule: PitchEngineDelegate {
@@ -70,7 +159,7 @@ extension ReactNativeSimpleNotePitchDetectorModule: PitchEngineDelegate {
     }
 
     public func pitchEngine(_ pitchEngine: PitchEngine, didReceiveError error: Error) {
-        // Optionally send error events to JS
+        self.sendStatus("error", "PitchEngine error: \(error.localizedDescription)")
     }
 
     public func pitchEngineWentBelowLevelThreshold(_ pitchEngine: PitchEngine) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-simple-note-pitch-detector",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "a simple react native library to detect the pitch of the input recording",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -39,4 +39,4 @@
     "react": "*",
     "react-native": "*"
   }
-}
+}