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.13(2w ago)3398.8k↑40827.8%MITPHPPHP ^8.4CI passing

Since Dec 5Pushed 4w 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 2w ago

READMEChangelog (10)Dependencies (121)Versions (56)Used By (0)

[![](https://camo.githubusercontent.com/0f5ae213ac378635adeb5d7f13cef055ad2f7d9a47b36de7b1c67dbe09f609ca/68747470733a2f2f6465657077696b692e636f6d2f62616467652e737667)](https://deepwiki.com/realodix/haiku)[![](https://camo.githubusercontent.com/2c687d1b57339b178e03145c8993225513a8c3b4690a55f1fb06cfba2c0e238b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7265616c6f6469782f6861696b75)](https://packagist.org/packages/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.

**Built with a deep understanding of the syntaxes of Adblock Plus, AdGuard, and uBlock Origin.**

### \# Three capabilities, one tool

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

#### 01/Lint - Static analysis

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

Analyze your filter lists to perform intelligent redundancy analysis, while catching syntax errors and invalid options or modifiers before they affect users.

#### 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

57

—

FairBetter than 98% of packages

Maintenance95

Actively maintained with recent releases

Popularity42

Moderate usage in the ecosystem

Community6

Small or concentrated contributor base

Maturity67

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

Total

43

Last Release

18d 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 (630 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.5k257.0M28.0k](/packages/friendsofphp-php-cs-fixer)[rector/rector-src

Instant Upgrade and Automated Refactoring of any PHP code

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

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

103574.3k69](/packages/friendsoftypo3-content-blocks)[laravel/framework

The Laravel Framework.

34.9k556.2M21.5k](/packages/laravel-framework)[drupal/core

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

19467.3M1.9k](/packages/drupal-core)[drupal/core-recommended

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

6943.5M449](/packages/drupal-core-recommended)

PHPackages © 2026

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