Skip to content

tryptz/Seap-Engine

Repository files navigation

SeapEngine 🌊🎧

The Professional Web Audio Workstation
Convert, Edit, Equalize, and Calibrate directly in your browser.

License React TypeScript Tailwind

SeapEngine is a high-performance, privacy-focused audio toolset built on the modern Web Audio API. It combines a batch file converter, a non-linear waveform editor, and advanced acoustic calibration tools into a single, sleek application.

Unlike traditional online converters, SeapEngine processes everything client-side. Your files never leave your device.


πŸ“Έ Screenshots

Database View AutoEq View

✨ Key Features

1. πŸ”„ Universal Audio Converter

A robust batch processor designed for speed and security.

  • Formats: WAV, MP3, FLAC, OGG.
  • Quality Control: Custom sample rates (up to 96kHz), bit depths (up to 32-bit float), and bitrate sliders.
  • Privacy First: Files are processed in memory using WebAssembly encoders (lamejs, libflac, libvorbis).
  • Resilience: Built-in "Circuit Breaker" pauses queue on repeated errors.
  • Bulk Export: Download individual files or auto-zip the entire batch.

2. 🎚️ Waveform Editor

A non-destructive audio manipulation environment.

  • Visualization: smooth, zoomable canvas waveform renderer.
  • Tools: Select, Cut, Hand/Pan.
  • Real-time Effects Rack:
    • πŸŽ› Parametric EQ: 3-band shelf/peak filters.
    • πŸ“‰ Compressor: Dynamic range control with visual feedback.
    • 🌫 Reverb: Convolution reverb engine with procedural impulse generation.
    • πŸ” Delay: Feedback echo loop.
  • Playlist: Manage multiple files in a session.

3. 🎧 Precision AutoEqβ„’

Automated headphone frequency correction.

  • Massive Database: Integrates directly with the AutoEq repository, providing instant access to 4000+ headphone profiles.
  • Algorithmic Generation: Calculates parametric EQ bands (Peaking, Low/High Shelf) to match your headphones to a target curve (Harman, Diffuse Field, or custom).
  • Visualization: Interactive frequency response graph with target overlays and predicted correction.
  • Export: Generate standardized EQ text files for use in system-wide equalizers (APO, Peace, etc.).

4. πŸ”Š Surround Calibration & Room EQ

Tools for hifi and home theater enthusiasts.

  • Speaker Calibration:
    • Visual 2.0, 5.1, and 7.1 mapping.
    • Per-channel Pink Noise generator.
    • Integrated SPL Meter using your microphone for level balancing.
  • Room Correction: Import room measurement files (REW/microphone) and generate corrective filters for specific speakers.

πŸ› οΈ Technology Stack

  • Frontend: React 19, TypeScript
  • Styling: Tailwind CSS (Custom "Meru Dark" theme)
  • Audio Core: Native Web Audio API (AudioContext, AudioWorklet)
  • Codecs:
    • lamejs (MP3)
    • libflac.js (FLAC)
    • libvorbis.js (OGG)
  • Utilities: jszip for batch downloads.

πŸš€ Getting Started

To run SeapEngine locally:

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn

Installation

  1. Clone the repository

    git clone https://github.com/username/seapengine.git
    cd seapengine
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Open your browser to http://localhost:5173 (or the port shown in your terminal).


πŸ›‘οΈ Security & Privacy

SeapEngine is designed with a "Zero-Upload" architecture.

  • No Cloud Processing: All audio manipulation happens within your browser's sandboxed environment.
  • File Validation: Input files are checked for "Magic Bytes" to prevent malicious file execution.
  • Anti-Tamper: Basic protections against console injection attacks to protect non-technical users.

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“œ License

Distributed under the MIT License. See LICENSE for more information.


πŸ’– Support

If you enjoy using SeapEngine, consider supporting the development!

Buy Me A Coffee

Built with πŸ’œ

About

Audio tools

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages