Communitygithub.com

David-Li0406/meta-skill-evloving

Edge TTS 오디오를 PyAudio의 콜백 메커니즘을 사용하여 실시간으로 스트리밍하여 끊김을 제거하고, MP3를 PCM으로 변환하며 큐 기반 버퍼링을 처리합니다.

meta-skill-evloving란 무엇인가요?

이 스킬은 실시간 TTS(Text-to-Speech) 스트리밍을 위한 Python 기반 솔루션으로, `edge_tts` 라이브러리와 `pyaudio`를 결합하여 오디오 재생 시 발생하는 갭(gap)과 팝핑(popping) 노이즈를 완전히 제거합니다. 주요 특징은 PyAudio의 `stream_callback` 메커니즘을 활용하여 비동기 방식으로 오디오 청크를 지속적으로 재생함으로써, 기존의 블로킹 방식인 `stream.write()` 호출에서 발생하는 오디오 끊김 문제를 해결한다는 점입니다. `edge_tts.Communicate.stream()`을 통해 생성된 MP3 형식의 오디오 청크는 `pydub.AudioSegment`를 사용하여 PCM/WAV 형식으로 변환되며, 변환된 데이터는 `queue.Queue` 버퍼에 저장되어 콜백 함수가 끊김 없이 읽어 재생할 수 있도록 합니다. `asyncio`와 스레딩을 활용하여 동기적인 PyAudio 콜백과 비동기 TTS 생성을 조율하며, 버퍼 언더런, 변환 오류 등의 예외 상황에 대한 견고한 오류 처리를 포함하고 있어 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 실시간 음성 출력이 필요한 개발 작업에 이상적입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/David-Li0406/meta-skill-evloving/tree/HEAD/AutoSkill/SkillBank/ConvSkill/english_gpt4_8/edge_tts_pyaudio_gapless_streaming

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

edge_tts_pyaudio_gapless_streaming

Edge TTS 오디오를 PyAudio의 콜백 메커니즘을 사용하여 실시간으로 스트리밍하여 끊김을 제거하고, MP3를 PCM으로 변환하며 큐 기반 버퍼링을 처리합니다.

프롬프트

역할 및 목표

당신은 Python 오디오 엔지니어입니다. edge_tts와 pyaudio를 사용하여 실시간 TTS(Text-to-Speech) 스트리밍을 구현하는 것이 목표입니다. 주요 목표는 콜백 기반 재생 메커니즘을 사용하여 오디오 갭과 팝핑 노이즈를 제거하는 것입니다.

운영 규칙 및 제약 조건

  1. 아키텍처: PyAudio에서 stream_callback 메커니즘을 반드시 사용해야 합니다(블로킹 방식의 stream.write() 호출 대신). 이는 지속적인 재생을 보장하고 오디오 청크 사이의 빈 공간을 없애기 위함입니다.
  2. TTS 스트리밍: edge_tts.Communicate를 사용하여 오디오를 생성합니다. communicate.stream()을 반복하여 오디오 청크를 가져옵니다.
  3. 형식 변환: edge_tts에서 들어오는 데이터는 MP3 형식입니다. pyaudio로 재생하기 전에 pydub.AudioSegment를 사용하여 이러한 청크를 PCM/WAV 형식으로 변환해야 합니다.
  4. 버퍼링: 변환된 PCM 데이터를 저장할 버퍼(예: queue.Queue)를 구현합니다. 콜백 함수는 이 버퍼에서 데이터를 읽어 오디오 스트림에 지속적으로 공급합니다.
  5. 동시성: edge_tts의 비동기 특성을 동기식 PyAudio 콜백과 함께 처리합니다. asyncio와 스레딩을 사용하여 오디오 재생을 차단하지 않고 버퍼를 채운 상태로 유지합니다.
  6. 오류 처리:
    • 변환 함수 시작 시 pcm_data를 None 또는 b''로 초기화하여 UnboundLocalError를 방지합니다.
    • MP3를 PCM으로 변환하는 중 예외를 처리합니다(오류 기록, 충돌 방지를 위해 데이터를 빈 바이트로 설정).
    • 콜백 내에서 IOError(버퍼 언더런)를 처리하여 경고를 기록하고 무음 또는 일시 중지를 반환합니다.

의사소통 및 스타일 선호 사항

  • 통합 로직에 대해 완전하고 실행 가능한 코드 스니펫을 제공합니다.
  • 필요한 임포트(asyncio, edge_tts, queue, pyaudio, pydub, io, logging, threading)를 포함합니다.
  • TTS 생성부터 오디오 콜백까지의 데이터 흐름을 설명하는 명확한 주석을 사용합니다.

안티 패턴

  • 갭을 유발하는 경우 메인 루프 내에서 블로킹 stream.write() 호출을 사용하지 않습니다.
  • 재생 전에 오디오를 파일로 저장하지 않습니다. 반드시 스트리밍되어야 합니다.
  • MP3 청크를 PCM/WAV로 변환해야 하는 요구 사항을 무시하지 않습니다.
  • 특정 샘플 레이트나 비트 뎁스를 가정하지 않습니다. 오디오 설정에 정의된 값을 사용합니다.
  • 명시적으로 요청되지 않는 한 핵심 오디오 클래스의 내부 로직을 수정하지 않습니다.

트리거

  • stream edge_tts with pyaudio
  • fix audio gaps in python tts
  • real-time text to speech streaming
  • pyaudio callback for tts
  • edge_tts pyaudio player

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

David-Li0406/meta-skill-evloving

Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.

David-Li0406/meta-skill-evloving

Create technical diagrams using Mermaid syntax for architecture, sequences, ERDs, flowcharts, and state machines. Use for visualizing system design, data flows, and processes. Triggers: diagram, mermaid, architecture diagram, sequence diagram, flowchart, ERD, entity relationship, state diagram, C4 model, component diagram, visualize, draw.

David-Li0406/meta-skill-evloving

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

David-Li0406/meta-skill-evloving

Complete color manipulation and green screen effects system. PROACTIVELY activate for: (1) Green screen/chromakey removal, (2) Color grading with LUTs, (3) Color correction (levels, curves, white balance), (4) Colorkey/color removal effects, (5) Hue/saturation manipulation, (6) Color space conversions (BT.709, BT.2020, HDR), (7) Color isolation effects, (8) Teal and orange look, (9) Vintage/film looks, (10) Color keying for transparency. Provides: chromakey and colorkey filters, LUT application (lut3d), curves and levels adjustment, color balance, selective color manipulation, color space handling, HDR tone mapping, professional color grading chains.

David-Li0406/meta-skill-evloving

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

David-Li0406/meta-skill-evloving

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

David-Li0406/meta-skill-evloving

Build with OpenAI's stateless APIs - Chat Completions (GPT-5, GPT-4o), Embeddings, Images (DALL-E 3), Audio (Whisper + TTS), and Moderation. Includes Node.js SDK and fetch-based approaches for Cloudflare Workers. Use when: implementing chat completions with GPT-5/GPT-4o, streaming responses with SSE, using function calling/tools, creating structured outputs with JSON schemas, generating embeddings for RAG (text-embedding-3-small/large), generating images with DALL-E 3, editing images with GPT-Image-1, transcribing audio with Whisper, synthesizing speech with TTS (11 voices), moderating content (11 safety categories), or troubleshooting rate limits (429), invalid API keys (401), function calling failures, streaming parse errors, embeddings dimension mismatches, or token limit exceeded.

David-Li0406/meta-skill-evloving

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

David-Li0406/meta-skill-evloving

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

David-Li0406/meta-skill-evloving

Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas

David-Li0406/meta-skill-evloving

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

David-Li0406/meta-skill-evloving

Best practices for Remotion - Video creation in React

David-Li0406/meta-skill-evloving

Provides bidirectional translation (Chinese/English), grammar checking, and sentence polishing. Supports specific tense constraints, context-aware tone adjustment, and natural expression optimization. Outputs direct text without formatting.

David-Li0406/meta-skill-evloving

指导如何通过自定义注解(如@Unicom)标识Dubbo接口,利用BeanDefinitionRegistryPostProcessor在启动时扫描并动态注册ReferenceBean,实现RPC调用的封装。

David-Li0406/meta-skill-evloving

生成Python脚本,利用FFmpeg将图片序列按3x3布局合并,或将合并图拆分。要求使用subprocess模块执行命令,并支持用户交互式输入路径。

David-Li0406/meta-skill-evloving

SOP for extracting and analyzing promotional activity details, handling time formatting, location mapping, payment logic, and step-by-step process validation.

David-Li0406/meta-skill-evloving

Specializes in creating TikTok short video scripts using an anthropomorphic 'Chef' perspective to explain wildlife food chains and survival environments, utilizing real field footage.

David-Li0406/meta-skill-evloving

针对TikTok平台,以拟人化视角(如动物作为厨师)创作系列短视频脚本。重点介绍野生动物、食物链及生态环境,要求使用野外实拍素材,风格幽默且具有教育意义。

David-Li0406/meta-skill-evloving

Generates KWL (Know, Want to know, Learned) charts for educational videos, specifically BrainPOP, using simple 7th-grade language and short, concise bullet points.

David-Li0406/meta-skill-evloving

Tracks complex, multi-session work using the Beads issue tracker and dependency graphs, and provides persistent memory that survives conversation compaction. Use when work spans multiple sessions, has complex dependencies, or needs persistent context across compaction cycles. Trigger with phrases like "create task for", "what's ready to work on", "show task", "track this work", "what's blocking", or "update status".

관련 스킬