VoiceCell

Voice notes for Jupyter notebooks — record audio comments linked to specific lines of code.

Author: Muhammad Yahya Kamran
License: MIT

What it does

VoiceCell adds a Voice Note button to your Jupyter notebook toolbar in VS Code. Click on any line of code, press the button (or Alt+V), and record a voice note. The recording is saved next to your notebook and a clickable marker is injected into that exact line.

Features

• 🎙 Record voice notes linked to specific cells and lines
• ▶ Click Play vm_1 above the line to play back
• 🌊 Waveform visualization in the player
• ⏩ Playback speed control (0.5x, 1x, 1.5x, 2x)
• 🗑 Delete voice notes from within the player
• 💾 Audio saved to voicecells_of_(notebook) folder alongside your notebook
• 🔒 Fully local — no data sent anywhere

Requirements

• VS Code with the Jupyter extension installed
• Python 3.10+
• The following Python packages (installed automatically on first use):
  • sounddevice
  • soundfile
  • numpy

Installation

Search for VoiceCell in the VS Code Extensions marketplace, or install via:

ext install MuhammadYahyaKamran.vscode-voicecell

Usage

1. Open a .ipynb notebook in VS Code
2. Click inside a cell on the line you want to annotate
3. Click Voice Note in the notebook toolbar or press Alt+V
4. Record your message and click Stop & Save
5. A # 🔊 vm_1 [timestamp] comment appears on that line
6. Click ▶ Play vm_1 above the line to play it back

Sharing notebooks

Share the .ipynb file together with the voicecells_of_<notebookname> folder. Anyone with VoiceCell installed can play back all voice notes.

Privacy & Safety

• 🔒 Microphone access is local only
• 💾 Audio saved locally as .webm files — never uploaded anywhere
• 🚫 No telemetry, no tracking, no external connections

Compatibility

• VS Code with Jupyter extension ✅
• JupyterLab 4.x — use jupyter-voicecell instead

License

MIT © 2026 Muhammad Yahya Kamran