# Binary file comparator

- Human page: https://happytails.ai/en/developer-tools/binary-file-comparator/
- Markdown: https://happytails.ai/en/developer-tools/binary-file-comparator.md
- Structured JSON: https://happytails.ai/agents/en/developer-tools/binary-file-comparator/index.json
- Visibility: public

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `binary-file-comparator` |
| Category | developer-tools |
| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |
| Browser execution | Use the visible action or interactive controls. |
| Browser processing | Browser; see tool notes for network behavior. |
| HTTP API | Not callable through HTTP. |
| Browser-agent interface | run_current_tool |

### Implementation notes

Select exactly two files, each up to 256 MiB. Compare corresponding byte offsets; inserted data is not realigned. Download changed regions with decimal and hexadecimal offsets.

### Inputs and settings

No free-text input is required. Use the file inputs and/or settings below.

Accepted browser files: `See implementation notes`. Multiple files are supported.

Browser file-input limit: 536870912 bytes in total. HTTP limits can differ.

No additional settings are declared for this tool.

### Browser-agent workflow

1. Open the human page in a browser that supports WebMCP.
2. Discover the interface exposed by that page; use its actual schema.
3. Select files on the page first when the tool requires files.
4. Call `run_current_tool` with valid input and settings.
5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.

Calls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.

### Planning specification

Exactly two files, up to 256 MiB each and 512 MiB total. Offsets start at zero; range ends are exclusive. Comparison uses corresponding offsets and does not realign insertions. Up to 10,000 ranges are exported, with the total count retained.

This describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.

### Complete machine-readable capability record

```json
{
  "id": "binary-file-comparator",
  "category": "developer-tools",
  "built": true,
  "requirements": "Exactly two files, up to 256 MiB each and 512 MiB total. Offsets start at zero; range ends are exclusive. Comparison uses corresponding offsets and does not realign insertions. Up to 10,000 ranges are exported, with the total count retained.",
  "implementation": {
    "fields": [],
    "files": true,
    "input": false,
    "multiple": true,
    "maxFileBytes": 536870912,
    "presentation": "metrics",
    "deferImagePreview": true,
    "note": "Select exactly two files, each up to 256 MiB. Compare corresponding byte offsets; inserted data is not realigned. Download changed regions with decimal and hexadecimal offsets.",
    "experience": {
      "automatic": false,
      "single": false,
      "inputMaxLength": 1000000,
      "inputMode": "text",
      "label": "Your text",
      "placeholder": "Type or paste your input…",
      "help": "Up to 1,000,000 characters. Review the settings before running.",
      "action": null
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}
```

## Page guide

Compare two local files byte by byte and download the changed offset ranges.

How can we improve this tool?

Report a problem or share an idea.

Please leave out private information. Your message and the tool name go to our team via PostHog.

### How to use Binary file comparator

1. Choose the local file or files.
2. Review the action and limits, then run the inspection.
3. Check the result and download a separate output or report.

## Useful next steps

- [Byte order mark editor](https://happytails.ai/en/developer-tools/byte-order-mark-editor/) ([Markdown](https://happytails.ai/en/developer-tools/byte-order-mark-editor.md))

- [Line ending auditor](https://happytails.ai/en/developer-tools/line-ending-auditor/) ([Markdown](https://happytails.ai/en/developer-tools/line-ending-auditor.md))

- [File hash](https://happytails.ai/en/developer-tools/file-hash/) ([Markdown](https://happytails.ai/en/developer-tools/file-hash.md))

## Choose two files

Select both local files. Their selection order determines the left and right byte streams.

### Inspect changed regions

Each contiguous difference becomes an offset range. Extra bytes at the end also count as differences.

### Export a precise report

Download CSV with decimal and hexadecimal starting offsets and JSON with the byte counts. Neither original file is modified.