proc-tap 0.1.1

Process-level audio tap for Windows

📡 ProcTap

Per-Process Audio Capture for Windows

---

ProcTap is a Python library with a high-performance C++ backend that enables per-process audio capture on Windows 10/11 (20H1+) using ActivateAudioInterfaceAsync.

Capture audio from a specific process only — without system sounds or other app audio mixed in. Ideal for VRChat, games, DAWs, browsers, and AI audio analysis pipelines.

---

🚀 Features

• 🎧 Capture audio from a single target process
  (VRChat, games, browsers, Discord, DAWs, streaming tools, etc.)

• ⚡ Uses ActivateAudioInterfaceAsync (modern WASAPI)
  → More stable than legacy IAudioClient2 loopback approaches

• 🧵 Low-latency, thread-safe C++ engine → 44.1 kHz / stereo / 16-bit PCM format

• 🐍 Python-friendly high-level API

  • Callback-based streaming
  • Async generator streaming (async for)

• 🔌 Native extension for high-throughput PCM delivery

• 🪟 Windows-only (10/11, 20H1+)

---

📦 Installation

From PyPI (coming soon):

pip install proctap

From TestPyPI (for testing pre-releases):

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ proctap

From Source:

git clone https://github.com/m96-chan/ProcTap
cd ProcTap
pip install -e .

---

🛠 Requirements

• Windows 10 / 11 (20H1 or later recommended)
• Python 3.10+
• WASAPI support
• No admin privileges required
  (Per-process loopback capture works with standard user permissions)

---

🧰 Basic Usage (Callback API)

from proctap import ProcTap, StreamConfig

def on_chunk(pcm: bytes, frames: int):
    print(f"Received {len(pcm)} bytes ({frames} frames)")

pid = 12345  # Target process ID

tap = ProcTap(pid, StreamConfig(), on_data=on_chunk)
tap.start()

input("Recording... Press Enter to stop.\n")

tap.close()

---

🔁 Async Usage (Async Generator)

import asyncio
from proctap import ProcTap

async def main():
    tap = ProcTap(pid=12345)
    tap.start()

    async for chunk in tap.iter_chunks():
        print(f"PCM chunk size: {len(chunk)} bytes")

asyncio.run(main())

---

📄 API Overview

class ProcTap

Control Methods:

Method	Description
start()	Start WASAPI per-process capture
stop()	Stop capture
close()	Release native resources

Data Access:

Method	Description
iter_chunks()	Async generator yielding PCM chunks
read(timeout=1.0)	Synchronous: read one chunk (blocking)

Properties:

Property	Type	Description
is_running	bool	Check if capture is active
pid	int	Get target process ID
config	StreamConfig	Get stream configuration

Utility Methods:

Method	Description
set_callback(callback)	Change or remove audio callback
get_format()	Get audio format info (dict)

Audio Format

Note: The native extension uses a fixed audio format (hardcoded in C++):

Parameter	Value	Description
Sample Rate	44,100 Hz	CD quality (fixed)
Channels	2	Stereo (fixed)
Bit Depth	16-bit	PCM format (fixed)

The StreamConfig class exists for API compatibility but does not change the native backend format.

---

🎯 Use Cases

• 🎮 Record audio from one game only
• 🕶 Capture VRChat audio cleanly (without system sounds)
• 🎙 Feed high-SNR audio into AI recognition models
• 📹 Alternative to OBS "Application Audio Capture"
• 🎧 Capture DAW/app playback for analysis tools

---

📚 Example: Save to WAV

from proctap import ProcTap
import wave

pid = 12345

wav = wave.open("output.wav", "wb")
wav.setnchannels(2)
wav.setsampwidth(2)  # 16-bit PCM
wav.setframerate(44100)  # Native format is 44.1 kHz

def on_data(pcm, frames):
    wav.writeframes(pcm)

with ProcTap(pid, on_data=on_data):
    input("Recording... Press Enter to stop.\n")

wav.close()

---

📚 Example: Synchronous Read API

from proctap import ProcTap

tap = ProcTap(pid=12345)
tap.start()

try:
    while True:
        chunk = tap.read(timeout=1.0)  # Blocking read
        if chunk:
            print(f"Got {len(chunk)} bytes")
            # Process audio data...
        else:
            print("Timeout, no data")
except KeyboardInterrupt:
    pass
finally:
    tap.close()

---

🏗 Build From Source

git clone https://github.com/m96-chan/ProcTap
cd ProcTap
pip install -e .

Requirements:

• Visual Studio Build Tools
• Windows SDK
• CMake (if you modularize the C++ code)

---

🤝 Contributing

Contributions are welcome! We have structured issue templates to help guide your contributions:

• 🐛 Bug Report - Report bugs or unexpected behavior
• ✨ Feature Request - Suggest new features or enhancements
• ⚡ Performance Issue - Report performance problems or optimizations
• 🔧 Type Hints / Async - Improve type annotations or async functionality
• 📚 Documentation - Improve docs, examples, or guides

Special Interest:

• PRs from WASAPI/C++ experts are especially appreciated
• Help with cross-platform compatibility research
• Performance profiling and optimization

---

📄 License

MIT License

---

👤 Author

Yusuke Harada (m96-chan)
Windows Audio / VRChat Tools / Python / C++
https://github.com/m96-chan