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 &amp; Helpers](/categories/utility)
4. /
5. realodix/haiku

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

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

A tool to manage and maintain Adblock filter lists.

v1.12.5(1mo ago)21.3k↑166.7%MITPHPPHP ^8.4CI passing

Since Dec 5Pushed 1mo 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 1mo ago

READMEChangelog (10)Dependencies (29)Versions (33)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.

### \# Features

[](#-features)

1. **Fixing**: Sorts, combines, normalizes, and optimizes filter rules to produce cleaner and easier-to-maintain filter list.
2. **Building**: Compiles multiple filter list sources (local files and/or remote URLs) into single unified output files, including regenerating headers metadata and removing unnecessary lines such as comments.

Haiku supports multiple adblock syntaxes including Adblock Plus, AdGuard, and uBlock Origin. It uses an incremental caching system to skip unchanged files, enabling efficient processing of large filter lists.

```
!## BEFORE
[$path=/page.html,domain=b.com|a.com]##.textad
example.com##+js(aopw, Fingerprint2)
-banner-$image,domain=example.org
-banner-$image,domain=example.com
b.com,a.com##.ads

!## AFTER
-banner-$image,domain=example.com|example.org
a.com,b.com##.ads
[$domain=a.com|b.com,path=/page.html]##.textad
example.com##+js(aopw, Fingerprint2)
```

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

Installation
------------

[](#installation)

Install the package via [Composer](https://getcomposer.org/):

```
composer require realodix/haiku
```

Composer will install Haiku executable in its `bin-dir` which defaults to `vendor/bin`.

Commands
--------

[](#commands)

#### Initialize configuration

[](#initialize-configuration)

Creates a `haiku.yml` configuration file in your project.

```
vendor/bin/haiku init
```

#### Fixer

[](#fixer)

```
vendor/bin/haiku fix
```

#### Builder

[](#builder)

```
vendor/bin/haiku build
```

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/ca03961fc3/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

49

—

FairBetter than 95% of packages

Maintenance89

Actively maintained with recent releases

Popularity23

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity63

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 ~4 days

Total

28

Last Release

55d 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 (420 commits)")

---

Tags

adblockadblock-listadblock-plusadblockeradguardblocklistcode-styledeterministicfilterlistformatteropinionatedublockublock-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.5k234.7M20.6k](/packages/friendsofphp-php-cs-fixer)[infection/infection

Infection is a Mutation Testing framework for PHP. The mutation adequacy score can be used to measure the effectiveness of a test set in terms of its ability to detect faults.

2.2k26.2M1.8k](/packages/infection-infection)[rector/rector-src

Instant Upgrade and Automated Refactoring of any PHP code

134391.5k12](/packages/rector-rector-src)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[drupal/core

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

19562.3M1.3k](/packages/drupal-core)[tightenco/jigsaw

Simple static sites with Laravel's Blade.

2.2k438.5k29](/packages/tightenco-jigsaw)

PHPackages © 2026

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