# Install osmium-tool with Homebrew, apt, dnf, MacPorts, Nix

Libosmium-based command-line tool for processing OpenStreetMap data. Version 1.19.1 via Homebrew; verified 2026-06-25.

## Install

```sh
sudo av install brew:osmium-tool
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install osmium-tool
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install osmium-tool
```

  Evidence: MacPorts ports tree: gis/osmium-tool/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Debian apt (92%):

```sh
sudo apt install osmium-tool
```

  Evidence: Debian stable package indexes: osmium-tool from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install osmium-tool
```

  Evidence: Fedora Rawhide package metadata: osmium-tool from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#osmium-tool
```

  Evidence: nixpkgs package indexes: pkgs/by-name/os/osmium-tool/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:osmium-tool
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/osmium-tool>
- **Version:** 1.19.1
- **Source summary:** Libosmium-based command-line tool for processing OpenStreetMap data
- **Homepage:** <https://osmcode.org/osmium-tool/>
- **Repository:** <https://github.com/osmcode/osmium-tool>
- **Upstream docs:** <https://docs.osmcode.org/osmium/latest/osmium.html>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://github.com/osmcode/osmium-tool/archive/refs/tags/v1.19.1.tar.gz>
- **Last updated:** 2026-06-25T13:38:00+02:00
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- osmium (cli)
- osmium (alias)

## Dependencies

- boost
- lz4

## Build dependencies

- cmake
- libosmium
- nlohmann-json
- pandoc
- protozero

## Uses from macOS

- bzip2
- expat

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.19.1
- Package-manager updated: 2026-06-25
- Local data: ok
- Upstream repository: https://github.com/osmcode/osmium-tool
- Upstream latest detected: v1.19.1 (current)
## Project history and usage

osmium-tool is the command-line front end for the Osmium/libosmium ecosystem, providing a single `osmium` executable for inspecting, converting, filtering, extracting, sorting, diffing, and updating OpenStreetMap data files.

### Project history

The tool grew out of Jochen Topf's Osmium work. The Osmium FAQ distinguishes the old Osmium library, developed from 2010 to 2013, from the C++11-based rewrite that began in 2013; osmium-tool is built on that newer libosmium stack. The repository credits Jochen Topf as writer and maintainer and carries copyright years beginning in 2013.

Its architecture follows libosmium's file-format and data-model abstractions. The manual describes the `osmium` command as a Git-like dispatcher with subcommands, while the website emphasizes a broad feature set ranging from file info and format conversion to history-file extraction and changeset filtering.

### Adoption history

osmium-tool became a standard utility for OSM data operators because it covers many routine jobs without requiring custom C++ code. The project site lists packages for Debian/Ubuntu, Fedora, Homebrew, and conda-forge, and the manual notes support and regular testing across Linux, macOS, and Windows.

In the OSM tooling timeline, Osmium also became the recommended alternative for some Osmosis users as Osmosis moved into light maintenance. That adoption pattern reflects a broader shift from Java pipeline tooling toward libosmium-backed C++ tools for high-volume file processing.

### How it is used

Operators use osmium-tool to inspect extract metadata, convert between XML, PBF, O5M/O5C, OPL, and debug formats, build geographic extracts from bounding boxes or polygons, verify references in partial extracts, work with OSM history and change files, and chain these tasks inside shell scripts.

Its verbose mode, safety checks against overwriting output, and support for all major OSM file formats make it a pragmatic package for repeatable data jobs: download an extract, inspect headers, filter or cut the data, and feed the result into renderers, importers, or analysis systems.

### Why package nerds care

For package nerds, osmium-tool is the visible CLI layer of a carefully separated stack: protozero for PBF encoding support, libosmium as a header-only C++ OSM library, and osmium-tool as the packaged executable suite. It is a good example of a domain library being exposed through a durable multipurpose command.

### Related projects

- libosmium provides the underlying C++ OSM data handling. PyOsmium exposes parts of that ecosystem to Python. Osmosis, osmfilter, and osrm-backend occupy nearby OSM data-processing and routing roles.

### Sources

- <https://formulae.brew.sh/formula/osmium-tool>
- <https://github.com/osmcode/osmium-tool>
- <https://osmcode.org/faq.html>
- <https://osmcode.org/osmium-tool/>
- <https://osmcode.org/osmium-tool/manual.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:** osmium-tool
- **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

## Other Package-Manager Records

- Debian apt - osmium-tool - 1.18.0-1: normalized package name match | Debian stable package indexes: osmium-tool from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Command line tool for working with OpenStreetMap data | https://osmcode.org/osmium-tool/
- Nix - osmium-tool: normalized package name match | nixpkgs package indexes: pkgs/by-name/os/osmium-tool/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - osmium-tool - 1.16.0-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: osmium-tool from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Command line tool for working with OpenStreetMap data | https://osmcode.org/osmium-tool/
- dnf - osmium-tool - 1.19.1-1.fc45: normalized package name match | Fedora Rawhide package metadata: osmium-tool from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Command line tool for working with OpenStreetMap data | http://osmcode.org/osmium-tool/
- MacPorts - osmium-tool: normalized package name match | MacPorts ports tree: gis/osmium-tool/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Nix - osmium: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/os/osmium/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## 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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Database and data packages](https://www.automicvault.com/pkg/database-data-tools/) - Matched database, SQL, migration, or data-store metadata.
- [lz4](https://www.automicvault.com/pkg/brew/lz4/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [pandoc](https://www.automicvault.com/pkg/brew/pandoc/) - Build dependency declared by Homebrew.
- [osmosis](https://www.automicvault.com/pkg/brew/osmosis/) - Shares av.db curated category or tags: cli, data, data-processing, geospatial, openstreetmap.
- [imposm3](https://www.automicvault.com/pkg/brew/imposm3/) - Shares av.db curated category or tags: cli, data, geospatial, openstreetmap.
- [osm-pbf](https://www.automicvault.com/pkg/brew/osm-pbf/) - Shares av.db curated category or tags: cli, data, geospatial, openstreetmap.
- [osmcoastline](https://www.automicvault.com/pkg/brew/osmcoastline/) - Shares av.db curated category or tags: cli, data, geospatial, openstreetmap.
- [osmfilter](https://www.automicvault.com/pkg/brew/osmfilter/) - Shares av.db curated category or tags: cli, data, geospatial, openstreetmap.
- [pdal](https://www.automicvault.com/pkg/brew/pdal/) - Shares av.db curated category or tags: cli, data, data-processing, geospatial.
- [gdal](https://www.automicvault.com/pkg/brew/gdal/) - Shares av.db curated category or tags: cli, data, geospatial.
- [geoserver](https://www.automicvault.com/pkg/brew/geoserver/) - Shares av.db curated category or tags: cli, data, geospatial.

## Combined YAML source

View the package source record on GitHub. [combined/osmium-tool.yml](https://github.com/automic-vault/db/blob/main/combined/osmium-tool.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
- external package-manager database matches
- cross-ecosystem install command graph