Skip to content
/ 330CUT_FF Public

A Firefox browser extension that provides a toolbar toggle to apply a 330 Hz low-cut (high-pass) filter to audio and video content on web pages. Reduces bass frequencies for clearer audio.

License

Notifications You must be signed in to change notification settings

oib/330CUT_FF

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

330CUT_FF - LowCut Audio Toggle Extension

A Firefox browser extension that provides a toolbar toggle to apply a 330 Hz low-cut (high-pass) filter to audio and video content on web pages.

Features

  • Real-time Audio Processing: Applies a 330 Hz high-pass filter to reduce low-frequency bass
  • Simple Toggle: One-click toolbar button to enable/disable the filter
  • State Persistence: Remembers your preference across browser sessions
  • Universal Compatibility: Works on all websites with HTML5 audio/video
  • Fallback Support: Handles CORS-restricted media via tab capture API

Installation

From Source

  1. Clone this repository:

    git clone https://github.com/yourusername/330CUT_FF.git
    cd 330CUT_FF
  2. Install as temporary add-on in Firefox:

    • Open Firefox and navigate to about:debugging#/runtime/this-firefox
    • Click Load Temporary Add-on…
    • Select extension/manifest.json from the project

From Firefox Add-ons (Coming Soon)

The extension will be published to the Firefox Add-ons store for easy installation.

Usage

  1. Navigate to any webpage with audio or video content (YouTube, Bandcamp, etc.)
  2. Click the LowCut toolbar icon to toggle the filter:
    • OFF (default): Normal audio playback
    • ON: Bass frequencies below 330 Hz are reduced
  3. The icon and tooltip will update to show the current state

Technical Details

  • Filter Type: High-pass (low-cut) at 330 Hz
  • Q Factor: 0.707 (Butterworth response)
  • Manifest Version: 2 (Firefox ESR compatible)
  • Permissions: tabs, storage, activeTab

Development

Project Structure

330CUT_FF/
├── extension/          # Extension source code
│   ├── manifest.json   # Extension manifest
│   ├── background.js   # Background script
│   ├── content/        # Content scripts
│   └── icons/          # Extension icons
├── docs/               # Documentation
└── README.md           # This file

Building

No build process required - the extension uses plain JavaScript.

Testing

  1. Load as temporary add-on (see Installation)
  2. Test on media sites like YouTube or Bandcamp
  3. Verify toolbar icon updates correctly
  4. Check that audio filtering is applied/removed

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Andreas Michael Fleckl - Homepage

Acknowledgments

  • Uses the Web Audio API for real-time audio processing
  • Icon design inspired by audio filter visualizations

About

A Firefox browser extension that provides a toolbar toggle to apply a 330 Hz low-cut (high-pass) filter to audio and video content on web pages. Reduces bass frequencies for clearer audio.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published