@hayatialikeles/dtln-rs

中文文档
0.3.1发布于 2025/10/06MITTypeScriptCommonJS零依赖近 30 天下载 5227

Real-time noise suppression for audio using Dual-Signal Transformation LSTM Network (DTLN)

原始使用文档
文档目录17 节
  1. 🎯 Genel Bakış
  2. ✨ Temel Özellikler
  3. 🚀 Hızlı Başlangıç
  4. 🐳 Docker Kullanımı
  5. 📊 Performans Benchmarkları
  6. 📖 API Referansı
  7. 🎛️ Ses Gereksinimleri
  8. 🌐 WebRTC Entegrasyon Örneği
  9. 🛠️ Platform Desteği
  10. 📦 İçindekiler
  11. 🏗️ Mimari
  12. 🧪 Testleri Çalıştırma
  13. 🤝 Katkıda Bulunma
  14. 📄 Lisans
  15. 🙏 Teşekkürler
  16. 📞 Destek
  17. 🔗 Linkler

dtln-rs

License Node Version Platform

Node.js için yüksek performanslı gerçek zamanlı gürültü bastırma

Rust ile geliştirildi 🦀 | DTLN Sinir Ağı ile desteklenir 🧠 | Üretime hazır 🚀

Türkçe | English


🎯 Genel Bakış

dtln-rs, Node.js için yüksek performanslı bir ses gürültü bastırma kütüphanesidir ve Dual-Signal Transformation LSTM Network (DTLN) mimarisi üzerine inşa edilmiştir. Maksimum performans için Rust ile geliştirilmiş ve native Node.js eklentisi olarak paketlenmiştir. Gerçek zamanlıya yakın gürültü azaltma özellikleri şunlar için mükemmeldir:

  • 🎙️ Sesli aramalar ve konferanslar (WebRTC entegrasyonu)
  • 🎵 Ses akışı uygulamaları
  • 🎧 Podcast ve ses prodüksiyon araçları
  • 📞 VoIP uygulamaları
  • 🤖 Sesli AI asistanları

✨ Temel Özellikler

  • ⚡ Ultra hızlı: Modern donanımda gerçek zamandan 55x daha hızlı işler
  • 🎯 Yüksek Kalite: En gelişmiş DTLN sinir ağı mimarisine dayalıdır
  • 🔌 Tak ve Kullan: Önceden derlenmiş binary'ler dahil - Rust kurulumu gerektirmez
  • 🌍 Çapraz platform: macOS (Intel & Apple Silicon), Linux (x64 & ARM64)
  • 🪶 Hafif: Sadece ~4MB ML modeli, edge deployment için optimize edilmiş
  • 🔒 Thread-safe: Eşzamanlı işleme için tasarlanmış
  • 📦 Sıfır bağımlılık: Kendi kendine yeten native modül

🚀 Hızlı Başlangıç

Kurulum

npm install dtln-rs

Bu kadar! Önceden derlenmiş binary'ler şunlar için dahildir:

  • ✅ macOS ARM64 (Apple Silicon)
  • ✅ macOS x64 (Intel)
  • ✅ Linux x64
  • ✅ Linux ARM64

Temel Kullanım (JavaScript)

const dtln = require('@hayatialikeles/dtln-rs');

// Denoiser başlat
const denoiser = dtln.dtln_create();

// Ses bufferlarını hazırla (16kHz, mono, Float32Array)
const inputAudio = new Float32Array(512);  // Gürültülü sesiniz
const outputAudio = new Float32Array(512); // Temiz ses çıktısı

// Ses frame'ini işle
const isStarved = dtln.dtln_denoise(denoiser, inputAudio, outputAudio);

// Temizle
dtln.dtln_stop(denoiser);

TypeScript Kullanımı

Tam TypeScript desteği - tip tanımlamaları dahil!

import * as dtln from '@hayatialikeles/dtln-rs';

const denoiser: dtln.DenoiserHandle = dtln.dtln_create();

const inputAudio = new Float32Array(512);
const outputAudio = new Float32Array(512);

const isStarved: boolean = dtln.dtln_denoise(denoiser, inputAudio, outputAudio);

dtln.dtln_stop(denoiser);

Kapsamlı TypeScript örnekleri için example.ts dosyasına bakın.

🐳 Docker Kullanımı

Bu paketi Docker container'larında kullanırken, C++ runtime kütüphanelerini mutlaka yüklemelisiniz:

FROM node:18-slim

# dtln-rs için gerekli C++ kütüphanelerini yükle
RUN apt-get update && apt-get install -y \
    libc++-dev \
    libc++abi-dev \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY package*.json ./
RUN npm install

COPY . .
CMD ["node", "index.js"]

Bu kütüphaneler olmadan şu hatayı alırsınız:

libc++.so.1: cannot open shared object file: No such file or directory

Tam Docker entegrasyon rehberi için DOCKER.md dosyasına bakın.


📊 Performans Benchmarkları

MacBook Pro M1 üzerinde gerçek dünya performansı:

Ses Süresiİşlem SüresiGerçek-zamanlı Faktör
10.00s195ms0.019x ⚡
7.06s132ms0.019x ⚡
22.10s333ms0.015x ⚡

0.019x gerçek-zamanlı faktör, gerçek zamandan 55x daha hızlı demektir 🚀

📖 API Referansı

dtln_create()

Yeni bir DTLN denoiser instance'ı oluşturur.

Döndürür: Denoiser handle

Örnek:

const denoiser = dtln.dtln_create();

dtln_denoise(denoiser, inputSamples, outputSamples)

Ses örneklerini işler ve gürültüyü kaldırır.

Parametreler:

  • denoiser: dtln_create()'den dönen denoiser handle
  • inputSamples: Giriş sesi Float32Array (16kHz, mono, -1.0 to 1.0)
  • outputSamples: Temiz sesi alacak Float32Array (giriş ile aynı uzunlukta)

Döndürür: Boolean - işlemci gerçek zamandan yavaşsa true

Örnek:

const isStarved = dtln.dtln_denoise(denoiser, inputFrame, outputFrame);
if (isStarved) {
  console.warn('⚠️ İşlem gerçek zamandan yavaş');
}

dtln_stop(denoiser)

Denoiser instance'ını durdurur ve temizler. İşiniz bittiğinde mutlaka çağırın!

Parametreler:

  • denoiser: Durdurulacak denoiser handle

Örnek:

dtln.dtln_stop(denoiser);

🎛️ Ses Gereksinimleri

ParametreDeğer
Örnekleme Hızı16kHz (16000 Hz)
KanallarMono (1 kanal)
FormatFloat32Array
Aralık-1.0 to 1.0
Frame Boyutu512 örnek (32ms önerilir)

🌐 WebRTC Entegrasyon Örneği

const dtln = require('dtln-rs');

class RealtimeDenoiser {
  constructor() {
    this.denoiser = dtln.dtln_create();
    this.frameSize = 512; // 16kHz'de 32ms
  }

  /**
   * Sesi gerçek zamanlı olarak işle
   * @param {Float32Array} audioData - Giriş sesi (16kHz mono)
   * @returns {Float32Array} Gürültüsü alınmış ses
   */
  process(audioData) {
    const output = new Float32Array(audioData.length);

    // 512 örneklik parçalar halinde işle
    for (let i = 0; i < audioData.length; i += this.frameSize) {
      const chunk = audioData.slice(i, Math.min(i + this.frameSize, audioData.length));
      const outChunk = new Float32Array(this.frameSize);

      // Son parça küçükse doldur
      const padded = new Float32Array(this.frameSize);
      padded.set(chunk);

      dtln.dtln_denoise(this.denoiser, padded, outChunk);
      output.set(outChunk.slice(0, chunk.length), i);
    }

    return output;
  }

  destroy() {
    dtln.dtln_stop(this.denoiser);
  }
}

// WebRTC'de kullanım
const denoiser = new RealtimeDenoiser();

audioContext.createScriptProcessor(512, 1, 1).onaudioprocess = (e) => {
  const input = e.inputBuffer.getChannelData(0);
  const output = e.outputBuffer.getChannelData(0);

  const clean = denoiser.process(input);
  output.set(clean);
};

// Temizlik
window.addEventListener('beforeunload', () => denoiser.destroy());

🛠️ Platform Desteği

PlatformDurumKurulum
macOS ARM64 (M1/M2/M3)✅ Prebuiltnpm install (Rust gerekmez)
macOS x64 (Intel)✅ Prebuiltnpm install (Rust gerekmez)
Linux x64✅ Prebuiltnpm install (Rust gerekmez)
Linux ARM64🔨 Kaynaktan derlemeRust toolchain gerekir
Windows x64🔨 Kaynaktan derlemeRust + MSVC gerekir

Kaynaktan Derleme

Platformunuz için önceden derlenmiş binary yoksa:

# Rust'ı yükleyin https://rustup.rs/
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Modülü derleyin
npm install

📦 İçindekiler

  • Prebuilt Binary'ler: macOS & Linux için kullanıma hazır
  • DTLN Modelleri: Quantized TensorFlow Lite modelleri (~4MB)
  • Kaynak Kodu: Tam Rust implementasyonu
  • Örnekler: Gerçek dünya kullanım örnekleri

🏗️ Mimari

┌─────────────────────────────────────────┐
│         Uygulamanız                     │
│         (Node.js / JavaScript)          │
└────────────────┬────────────────────────┘
                 │
                 ▼
┌─────────────────────────────────────────┐
│          dtln-rs (Native Addon)         │
│                                         │
│  ┌───────────────────────────────────┐ │
│  │   DTLN Motoru (Rust)              │ │
│  │  ┌──────────────┐ ┌─────────────┐│ │
│  │  │  Model 1     │ │  Model 2    ││ │
│  │  │  (Frekans)   │ │  (Zaman)    ││ │
│  │  └──────────────┘ └─────────────┘│ │
│  └───────────────────────────────────┘ │
│               │                         │
│               ▼                         │
│  ┌───────────────────────────────────┐ │
│  │   TensorFlow Lite (Static)        │ │
│  └───────────────────────────────────┘ │
└─────────────────────────────────────────┘

🧪 Testleri Çalıştırma

Gerçek ses örnekleri ile test edin:

# Simüle edilmiş ses ile örnek çalıştır
node example.js

# Gerçek WAV dosyaları ile test et (repo'da dahil)
node test-real-audio.js

🤝 Katkıda Bulunma

Katkılarınızı bekliyoruz! Sorun bildirimleri ve pull request'ler göndermekten çekinmeyin.

  1. Repository'i fork edin
  2. Feature branch'i oluşturun (git checkout -b feature/harika-ozellik)
  3. Değişikliklerinizi commit edin (git commit -m 'Harika özellik ekle')
  4. Branch'e push edin (git push origin feature/harika-ozellik)
  5. Pull Request açın

📄 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır - detaylar için LICENSE dosyasına bakın.

🙏 Teşekkürler

Bu proje şu mükemmel çalışmalar üzerine inşa edilmiştir:

Rust ve Node.js topluluklarına mükemmel araçlar ve kütüphaneler için özel teşekkürler!

📞 Destek

🔗 Linkler


Rust ile ❤️ ile yapıldı 🦀

Faydalı bulduysanız bu repository'e ⭐ yıldız verin!

版本与发布记录

@hayatialikeles/dtln-rs 共发布 8 个版本,首次发布于 2025/10/05;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.3.1latest2025/10/061.1 年前
0.3.02025/10/061.1 年前
0.2.32025/10/061.1 年前
0.2.22025/10/061.1 年前
0.2.12025/10/061.1 年前
0.2.02025/10/051.1 年前

关于 @hayatialikeles/dtln-rs 的常见问题

@hayatialikeles/dtln-rs 是什么?

Real-time noise suppression for audio using Dual-Signal Transformation LSTM Network (DTLN)

如何安装 @hayatialikeles/dtln-rs?

在项目目录运行 npm install @hayatialikeles/dtln-rs,或使用 pnpm add / yarn add / bun add。

@hayatialikeles/dtln-rs 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@hayatialikeles/dtln-rs 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@hayatialikeles/dtln-rs 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=14.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@hayatialikeles/dtln-rs 可以商用吗?

@hayatialikeles/dtln-rs 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@hayatialikeles/dtln-rs 的下载量有多少?

根据 npm 官方下载统计,@hayatialikeles/dtln-rs 在 2026/10/18 – 2026/11/16 这 30 天内被下载 5,227 次,日均约 174 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@hayatialikeles/dtln-rs 还在维护吗?

最新版本 0.3.1 发布于 2025/10/06(1.1 年前);至今共发布 8 个版本,其中过去 12 个月发布了 0 个;首次发布于 2025/10/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。