FFMSisco 1.0.0

FFMSisco

A lightweight FFmpeg wrapper for .NET with an automatic bootstrapper, audio filters, and an extensible architecture.

FFMSisco is a .NET library that integrates FFmpeg in a clean, portable, and developer‑friendly way.
It does not require FFmpeg to be installed on the system: the library automatically downloads the official FFmpeg build and uses it from a private runtime folder.

The project is designed to be:

• simple to use
• easy to extend
• suitable for desktop apps, tools, and server environments

Features

Core

• Automatic FFmpeg bootstrapper (download, extraction, private runtime)
• Asynchronous FFmpeg command runner
• Zero external dependencies

Audio Filters

• ConvertToWav
• ConvertToMp3
• Normalize
• LowPass
• HighPass
• Firequalizer (FIR EQ)
• Firequalizer10Band (10‑band graphic EQ)

Built‑in EQ Presets

• Flat
• VoiceWarm
• VoiceBright
• VoiceClarity
• BassBoost
• Smile
• Podcast
• Broadcast

Video (coming soon)

The library is structured to support:

• Resize
• Transcode
• ExtractAudio
• Video filters (denoise, sharpen, color correction)
• GIF creation
• Cut / Join

Installation

dotnet add package FFMSisco

(The package will be available on NuGet once published.)

Getting Started

Convert a file to WAV

await AudioFilters.ConvertToWav("input.mp3", "output.wav");

Apply a LowPass filter

await AudioFilters.LowPass("input.wav", "output.wav", 3000);

Use the 10‑band equalizer

double[] gains = { 0,0,0,0,0,0,0,0,0,0 };
await AudioFilters.Firequalizer10Band("in.wav", "out.wav", gains);

Apply an EQ preset

await AudioFilters.Firequalizer10Band(
    "voice.wav",
    "voice_clarity.wav",
    AudioFilters.EqPresets.VoiceClarity
);

Project Structure

FFMSisco currently includes:

• FFmpegBootstrapper.cs
  Handles FFmpeg download and initialization.

• FFmpegRunner.cs
  Executes FFmpeg commands asynchronously.

• AudioFilters.cs
  Contains all audio filters and EQ presets.

• FFMSisco.csproj
  Project file with NuGet metadata.

Architecture

FFMSisco is built with modularity in mind:

• Bootstrap → FFmpeg download and setup
• Runner → FFmpeg command execution
• Audio → audio filters and equalizers
• Video (planned) → video processing and filters
• Utils → helper utilities

Each module is independent and easy to extend.

Roadmap

• Add video filters (resize, crop, denoise, sharpen)
• Add audio/video filter chaining
• Add advanced EQ presets (Podcast Pro, Broadcast FM, Mastering)
• Add fluent API (Filters.Audio.LowPass(3000).HighPass(80).Apply())
• Add GitHub Actions workflow for automatic NuGet publishing

License

FFMSisco is released under the MIT License.
You are free to use it in personal and commercial projects.

Contributing

Contributions and pull requests are welcome.
The project is intended to grow over time, especially in the video processing area.