by openstreetmap

openstreetmap / OSM-binary
131 Stars 61 Forks Last release: Not found GNU Lesser General Public License v3.0 158 Commits 12 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Osmpbf is a Java/C library to read and write OpenStreetMap PBF files. PBF (Protocol buffer Binary Format) is a binary file format for OpenStreetMap data that uses Google Protocol Buffers as low-level storage.

For more information see https://wiki.openstreetmap.org/wiki/PBF_Format .

Java Version

To build the osmpbf.jar file run:


For a Java usage example, see src.java/crosby/binary/test/ReadFileExample.java

C Version

To compile:

make -C src

To install:

make -C src install

There is a tool named osmpbf-outline that shows a debug output of the contents of a PBF file. To compile it:

make -C tools

Using the C Library

To include in your program use:


and link with:

-pthread -lz -lprotobuf-lite -losmpbf

Debian/Ubuntu Packages

To build the Debian/Ubuntu packages:

debuild -I -us -uc

To install the Debian/Ubuntu packages:

sudo dpkg --install ../libosmpbf-dev_*.deb
sudo dpkg --install ../libosmpbf-java_*.deb
sudo dpkg --install ../osmpbf-bin_*.deb

To clean up after:



The .proto definition files and osmpbf.h are licensed under the MIT license. The other source code is licensed under the LGPL v3+.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.