PHPackages                             realodix/haiku - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. realodix/haiku

ActiveLibrary[Utility & Helpers](/categories/utility)

realodix/haiku
==============

A tool to manage and maintain Adblock filter lists.

v1.13.10(1w ago)32.2k↑197%MITPHPPHP ^8.4CI passing

Since Dec 5Pushed 3d agoCompare

[ Source](https://github.com/realodix/haiku)[ Packagist](https://packagist.org/packages/realodix/haiku)[ Docs](https://github.com/realodix/haiku)[ RSS](/packages/realodix-haiku/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (102)Versions (53)Used By (0)

[![Ask DeepWiki](https://camo.githubusercontent.com/0f5ae213ac378635adeb5d7f13cef055ad2f7d9a47b36de7b1c67dbe09f609ca/68747470733a2f2f6465657077696b692e636f6d2f62616467652e737667)](https://deepwiki.com/realodix/haiku)

Realodix Haiku
==============

[](#realodix-haiku)

Haiku is a powerful command-line tool for managing adblock filter lists efficiently. It automates repetitive tasks such as merging sources, optimizing, and tidying up filter lists effortlessly.

### \# Three capabilities, one tool

[](#-three-capabilities-one-tool)

#### 01/Lint - Static analysis

[](#01lint---static-analysis)

Analyze your filter lists to catch syntax errors, structural defects, and invalid filter options / modifiers before they impact users. Built with deep understanding of Adblock Plus, AdGuard, and uBlock Origin syntaxes.

#### 02/Fix - Optimizer & Normalizer

[](#02fix---optimizer--normalizer)

An opinionated optimizer that sorts, combines, and deduplicates rules for a leaner, faster-loading filter list. No manual formatting roulette; drop it in, automate it, and move on.

For a complete list of transformations, see [docs/fixer-feature.md](./docs/fixer-feature.md).

#### 03/Build - Compiler & Bundler

[](#03build---compiler--bundler)

Compile multiple filter sources (local files and/or remote URLs) into a single, unified output. Automatically regenerates header metadata, strips unnecessary lines such as comments, and delivers a production-ready deployment.

### \# Three steps to first run

[](#-three-steps-to-first-run)

1. **Install**. Install the package via [Composer](https://getcomposer.org/) — `composer require realodix/haiku`.
2. **Initialize**. Run `vendor/bin/haiku init` in your project root. Haiku detects your layout and writes a `haiku.yml`.
3. **Run**. Use `vendor/bin/haiku lint`, `vendor/bin/haiku fix`, or `vendor/bin/haiku build`. Wire it into pre-commit, CI, or your editor.

For detailed command usage, available options, and more examples, see [docs/usage.md](./docs/usage.md).

### \# Configuration

[](#-configuration)

See [configuration file](./docs/configuration.md) documentation or [AdBlockID-src/haiku.yml](https://github.com/realodix/AdBlockID-src/blob/main/haiku.yml) for a production configuration example.

Contributing
------------

[](#contributing)

Contributions are welcome! Please:

1. Fork the repo and create a feature branch.
2. Add tests for new features.
3. Ensure code passes `composer check`.
4. Submit a PR with a clear description.

Report bugs or suggest features via Issues.

License
-------

[](#license)

This project is licensed under the [MIT License](./LICENSE).

###  Health Score

53

—

FairBetter than 96% of packages

Maintenance99

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~5 days

Recently: every ~10 days

Total

40

Last Release

12d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/01bfff23a3bc54204b47bee797a13a438df9156915ad177258dbd1a9f110f5b7?d=identicon)[KeiJR](/maintainers/KeiJR)

---

Top Contributors

[![realodix](https://avatars.githubusercontent.com/u/1314456?v=4)](https://github.com/realodix "realodix (615 commits)")

---

Tags

adblockadblock-listadblock-plusadblockeradguardblocklistcode-stylefilterlistformatterlinterlintingopinionatedstatic-analysisublockublock-origin

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/realodix-haiku/health.svg)

```
[![Health](https://phpackages.com/badges/realodix-haiku/health.svg)](https://phpackages.com/packages/realodix-haiku)
```

###  Alternatives

[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

13.5k251.2M25.2k](/packages/friendsofphp-php-cs-fixer)[rector/rector-src

Instant Upgrade and Automated Refactoring of any PHP code

136406.3k14](/packages/rector-rector-src)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

21866.0M1.7k](/packages/drupal-core)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6942.5M421](/packages/drupal-core-recommended)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)