# Install orc-tools with Homebrew

ORC java command-line tools and utilities. Version 2.3.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:orc-tools
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install orc-tools
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:orc-tools
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/orc-tools>
- **Version:** 2.3.0
- **Source summary:** ORC java command-line tools and utilities
- **Homepage:** <https://orc.apache.org/>
- **Repository:** <https://github.com/apache/orc>
- **Upstream docs:** <https://orc.apache.org/api/orc-tools/org/apache/orc/tools/package-summary.html>
- **License:** Apache-2.0
- **Source archive:** <https://search.maven.org/remotecontent?filepath=org/apache/orc/orc-tools/2.3.0/orc-tools-2.3.0-uber.jar>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- orc-tools (cli)
- orc-tools (alias)

## Dependencies

- openjdk

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.3.0
- Local data: ok
- Upstream repository: https://orc.apache.org/
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Apache ORC Tools is the Java command-line tooling package for Apache ORC files. It wraps ORC inspection, conversion, counting, merging, metadata dumping, JSON schema inference, encryption-key inspection, benchmarking scans, and version reporting into an executable jar and package-manager CLI.

### Project history

The tools grew out of the need to inspect and manipulate ORC files without always launching Hive, Spark, or a full Hadoop job. The older Hive manual documented `hive --orcfiledump` for analyzing ORC files, while the Apache ORC project later documents a standalone ORC tools jar that packages utilities and Java dependencies, including Hadoop, into one artifact.

The ORC Java Tools documentation marks subcommand additions across ORC releases: `scan` since ORC 1.3, `convert` and `json-schema` since ORC 1.4, `key` since ORC 1.5, `count` and `version` since ORC 1.6, `sizes` since ORC 1.7.2, and `check` and `merge` since ORC 2.0.1.

### Adoption history

The tools inherit Apache ORC's adoption in Hadoop and analytical data lakes. ORC documentation says the format was created in January 2013 to speed up Apache Hive and improve Hadoop storage efficiency, and it names large Hadoop users such as Facebook and Yahoo in its adoption discussion.

Because ORC files are binary columnar files, command-line tools fill a package-maintenance gap: data engineers, release engineers, and distro packagers need a way to verify metadata, print data as JSON, convert CSV or JSON into ORC, count rows, inspect key metadata, and merge files during tests and migrations.

### How it is used

Users invoke the tools as `java -jar orc-tools-X.Y.Z-uber.jar <sub-command> <args>` or through a packaged launcher such as Homebrew's `orc-tools`. Common workflows include `meta` to inspect file metadata, `data` to print records, `convert` to create ORC files from CSV or JSON, `count` to recursively count rows, `sizes` to inspect per-column disk usage, and `merge` to combine ORC files with compatible schemas.

The API documentation exposes the package as Java classes such as `Driver`, `FileDump`, `JsonFileDump`, `KeyTool`, `MergeFiles`, `PrintData`, `PrintVersion`, and `RowCount`, matching the command-line utility role rather than a general application framework.

### Why package nerds care

For package nerds, `orc-tools` is the inspect-and-repair companion to a columnar storage format. It is the difference between ORC as an opaque data-lake file and ORC as something that can be validated, dumped, converted, counted, benchmarked, and scripted from a shell.

### Timeline

- 2013-01: Apache ORC documentation says ORC files were created as part of the Hive speed and Hadoop storage-efficiency initiative.
- 2013: The Hive manual documents ORC as introduced in Hive 0.11.0 and includes `hive --orcfiledump` for inspection.
- ORC 1.3 through 2.0.1: Apache ORC Java Tools documentation records the arrival of subcommands such as `scan`, `convert`, `count`, `sizes`, `check`, and `merge`.

### Related projects

- Apache ORC Tools is part of the Apache ORC repository and follows the ORC format's ecosystem: Apache Hive, Apache Spark, Hadoop file systems, HDFS, and other data-lake engines that read or write ORC.

### Sources

- <https://cwiki.apache.org/confluence/display/Hive/LanguageManual%2BORC>
- <https://formulae.brew.sh/formula/orc-tools>
- <https://orc.apache.org/api/orc-tools/org/apache/orc/tools/package-summary.html>
- <https://orc.apache.org/docs/>
- <https://orc.apache.org/docs/java-tools.html>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** orc-tools
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [openjdk](https://www.automicvault.com/pkg/brew/openjdk/) - Runtime dependency declared by Homebrew.
- [orc](https://www.automicvault.com/pkg/brew/orc/) - Package name indicates the same formula family.
- [dasel](https://www.automicvault.com/pkg/brew/dasel/) - Shares av.db curated category or tags: cli, data-processing, developer-tools.
- [gron](https://www.automicvault.com/pkg/brew/gron/) - Shares av.db curated category or tags: cli, data-processing, developer-tools.
- [jaq](https://www.automicvault.com/pkg/brew/jaq/) - Shares av.db curated category or tags: cli, data-processing, developer-tools.
- [oq](https://www.automicvault.com/pkg/brew/oq/) - Shares av.db curated category or tags: cli, data-processing, developer-tools.
- [python-yq](https://www.automicvault.com/pkg/brew/python-yq/) - Shares av.db curated category or tags: cli, data-processing, developer-tools.
- [xpipe](https://www.automicvault.com/pkg/brew/xpipe/) - Shares av.db curated category or tags: cli, data-processing, developer-tools.
- [yq](https://www.automicvault.com/pkg/brew/yq/) - Shares av.db curated category or tags: cli, data-processing, developer-tools.
- [jsawk](https://www.automicvault.com/pkg/brew/jsawk/) - Shares av.db curated category or tags: cli, data-processing, developer-tools.
- [apache-opennlp](https://www.automicvault.com/pkg/brew/apache-opennlp/) - Both packages touch the same language runtime or ecosystem. Shared terms: apache, cli, developer, developer-tools, java.
- [bundletool](https://www.automicvault.com/pkg/brew/bundletool/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, command-line, developer, developer-tools, java.

## Combined YAML source

View the package source record on GitHub. [combined/orc-tools.yml](https://github.com/automic-vault/db/blob/main/combined/orc-tools.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
