modusa 0.3.41__py3-none-any.whl → 0.3.42__py3-none-any.whl

modusa/__init__.py

@@ -4,6 +4,6 @@ from modusa.utils import excp, config
 from modusa.tools import plot1d, plot2d, plot_dist
 #=====
 
-from modusa.tools import play, convert
+from modusa.tools import play, convert, record
 from modusa.tools import download
 from modusa.tools import load, load_ann

modusa/tools/__init__.py

@@ -5,4 +5,5 @@ from .audio_player import play
 from .audio_converter import convert
 from .youtube_downloader import download
 from .audio_loader import load
-from .ann_loader import load_ann
+from .ann_loader import load_ann
+from .audio_recorder import record

modusa/tools/audio_recorder.py

@@ -0,0 +1,115 @@
+#!/usr/bin/env python3
+
+#---------------------------------
+# Author: Ankit Anand
+# Date: 22/08/25
+# Email: ankit0.anand0@gmail.com
+#---------------------------------
+
+
+import sounddevice as sd
+import numpy as np
+import ipywidgets as widgets
+from IPython.display import display, clear_output, Audio
+
+def record():
+	"""
+	Create a UI to record audio in jupyter notebook, the 
+	recorded signal is available as array.
+
+	.. code-block:: python
+		
+		import modusa as ms
+		result = ms.record()
+		y, sr, title = result() # Keep it in the next cell
+
+	Returns
+	-------
+	Callable
+		A lambda function that returns y(audio signal), sr(sampling rate), title(title set in the UI)
+	"""
+	devices = sd.query_devices()
+	device_options = [(d['name'][:30], i) for i, d in enumerate(devices) if d['max_input_channels'] > 0]
+	
+	# Controls
+	device_dropdown = widgets.Dropdown(
+		options=device_options,
+		description="Microphone:",
+		layout=widgets.Layout(width="300px")
+	)
+	
+	sr_dropdown = widgets.Dropdown(
+		options=[('16 Khz', 16000), ('22.05 Khz', 22050), ('44.1 Khz', 44100)],
+		value=22050,
+		description="Sample Rate:",
+		layout=widgets.Layout(width="300px")
+	)
+	
+	title_box = widgets.Text(
+		placeholder="Title",
+		description="Title:",
+		layout=widgets.Layout(width="300px")
+	)
+	
+	toggle_button = widgets.Button(
+		description="Record",
+		button_style="",
+	)
+	
+	status = widgets.HTML(value="")
+	out = widgets.Output()
+	
+	# State
+	recording = {"data": None, "sr": None, "title": None}
+	stream = {"obj": None, "frames": [], "recording": False}
+	
+	def callback(indata, frames, time, status):
+		if not status:
+			stream["frames"].append(indata.copy())
+			
+	def on_toggle(b):
+		if not stream["recording"]:
+			stream["frames"].clear()
+			sr = sr_dropdown.value
+			device_id = device_dropdown.value
+			
+			stream["obj"] = sd.InputStream(callback=callback, channels=1, samplerate=sr, device=device_id)
+			stream["obj"].start()
+			stream["recording"] = True
+			
+			toggle_button.description = "Stop"
+			toggle_button.button_style = "danger"
+			status.value = "Recording..."
+		else:
+			stream["obj"].stop()
+			stream["obj"].close()
+			
+			sr = sr_dropdown.value
+			y = np.concatenate(stream["frames"], axis=0).flatten()
+			title = title_box.value.strip() or "Recording"
+			
+			recording["data"], recording["sr"], recording["title"] = y, sr, title
+			record.result = (y, sr, title)
+			stream["recording"] = False
+			
+			toggle_button.description = "Record"
+			toggle_button.button_style = "success"
+			
+			with out:
+				clear_output()
+				display(Audio(y, rate=sr))
+				
+	toggle_button.on_click(on_toggle)
+	
+	# Layout
+	ui = widgets.VBox([
+		device_dropdown,
+		sr_dropdown,
+		title_box,
+		widgets.HBox([toggle_button]),
+		out
+	])
+	
+	display(ui)
+	record.result = None
+	return lambda: record.result

{modusa-0.3.41.dist-info → modusa-0.3.42.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: modusa
-Version: 0.3.41
+Version: 0.3.42
 Summary: A modular signal analysis python library.
 Author-Email: Ankit Anand <ankit0.anand0@gmail.com>
 License: MIT
@@ -10,6 +10,7 @@ Requires-Dist: matplotlib>=3.10.3
 Requires-Dist: yt-dlp>=2025.6.30
 Requires-Dist: librosa==0.11.0
 Requires-Dist: IPython>=8.0.0
+Requires-Dist: sounddevice>=0.5.2
 Description-Content-Type: text/markdown
 
 # modusa

{modusa-0.3.41.dist-info → modusa-0.3.42.dist-info}/RECORD

@@ -1,9 +1,9 @@
-modusa-0.3.41.dist-info/METADATA,sha256=h6zQe0lZ2sqn5JHLbqAw9wqexEXjWW28gNqmXV8OdCk,1369
-modusa-0.3.41.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
-modusa-0.3.41.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
-modusa-0.3.41.dist-info/licenses/LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
+modusa-0.3.42.dist-info/METADATA,sha256=T8MRyy7MBHjm6w1boi604AFhBgWq2zSqNYukSFB9gJw,1403
+modusa-0.3.42.dist-info/WHEEL,sha256=9P2ygRxDrTJz3gsagc0Z96ukrxjr-LFBGOgv3AuKlCA,90
+modusa-0.3.42.dist-info/entry_points.txt,sha256=fmKpleVXj6CdaBVL14WoEy6xx7JQCs85jvzwTi3lePM,73
+modusa-0.3.42.dist-info/licenses/LICENSE.md,sha256=JTaXAjx5awk76VArKCx5dUW8vmLEWsL_ZlR7-umaHbA,1078
 modusa/.DS_Store,sha256=_gm6qJREwfMi8dE7n5S89_RG46u5t3xHyD-smNhtNoM,6148
-modusa/__init__.py,sha256=uq6kORFFAODiCMGmOLWO0shE8-dVFWf5gmV8wxekmnk,280
+modusa/__init__.py,sha256=Vny15JTP5lDr_4VxA_zSqL8eARbQzqLj0dk1OBSpJmk,288
 modusa/config.py,sha256=bTqK4t00FZqERVITrxW_q284aDDJAa9aMSfFknfR-oU,280
 modusa/decorators.py,sha256=8zeNX_wE37O6Vp0ysR4-WCZaEL8mq8dyCF_I5DHOzks,5905
 modusa/devtools/generate_docs_source.py,sha256=UDflHsk-Yh9-3YJTVBzKL32y8hcxiRgAlFEBTMiDqwM,3301
@@ -41,11 +41,12 @@ modusa/models/t_ax.py,sha256=ZUhvZPUW1TkdZYuUd6Ucm-vsv0JqtZ9yEe3ab67Ma6w,8022
 modusa/models/tds.py,sha256=FAGfibjyyE_lkEuQp-vSCuqQnopOjmy_IXqUjRlg9kc,11677
 modusa/plugins/__init__.py,sha256=r1Bf5mnrVKRIwxboutY1iGzDy4EPQhqpk1kSW7iJj_Q,54
 modusa/plugins/base.py,sha256=Bh_1Bja7fOymFsCgwhXDbV6ys3D8muNrPwrfDrG_G_A,2382
-modusa/tools/__init__.py,sha256=ixqujVIJwU5TNX2j64lVajGtZlXTspcxN-30X54GgcM,243
+modusa/tools/__init__.py,sha256=6EO3h7wMRW49ajo27BJprANPQMrOGWZudwYYRNKVISU,278
 modusa/tools/ann_loader.py,sha256=RePlwD4qG6gGrD4mOJ3RDR9q_gUscCY90_R9lgFU9lM,780
 modusa/tools/audio_converter.py,sha256=415qBoPm2sBIuBSI7m1XBKm0AbmVmPydIPPr-uO8D3c,1778
 modusa/tools/audio_loader.py,sha256=DrCzq0pdiQrUDIG-deLJGcu8EaylO5yRtwT4lr8WSf8,2166
 modusa/tools/audio_player.py,sha256=GP04TWW4jBwQBjANkfR_cJtEy7cIhvbu8RTwnf9hD6E,2817
+modusa/tools/audio_recorder.py,sha256=d2fVt0Sd2tlBdb2WlUs60K4N23zuxM3KUpQqX0ifPi8,2769
 modusa/tools/base.py,sha256=C0ESJ0mIfjjRlAkRbSetNtMoOfS6IrHBjexRp3l_Mh4,1293
 modusa/tools/math_ops.py,sha256=ZZ7U4DgqT7cOeE7_Lzi_Qq-48WYfwR9_osbZwTmE9eg,8690
 modusa/tools/plotter.py,sha256=e1NKFTFm8tG7yd-9VLmxmI9h9mTcUl1vaK1XDMvyoOw,18917
@@ -57,4 +58,4 @@ modusa/utils/excp.py,sha256=L9vhaGjKpv9viJYdmC9n5ndmk2GVbUBuFyZyhAQZmWY,906
 modusa/utils/logger.py,sha256=K0rsnObeNKCxlNeSnVnJeRhgfmob6riB2uyU7h3dDmA,571
 modusa/utils/np_func_cat.py,sha256=TyIFgRc6bARRMDnZxlVURO5Z0I-GWhxRONYyIv-Vwxs,1007
 modusa/utils/plot.py,sha256=s_vNdxvKfwxEngvJPgrF1PcmxZNnNaaXPViHWjyjJ-c,5335
-modusa-0.3.41.dist-info/RECORD,,
+modusa-0.3.42.dist-info/RECORD,,