Installation Guide¶

# Download and extract the archive
wget https://github.com/allfab/garmin-img-forge/releases/download/mpforge-v0.9.0/mpforge-linux-amd64.tar.gz
tar xzf mpforge-linux-amd64.tar.gz

# Make executable
chmod +x mpforge

# Install
sudo mv mpforge /usr/local/bin/

# Verify
mpforge --version
# → mpforge 0.9.0

# Download and extract the archive
wget https://github.com/allfab/garmin-img-forge/releases/download/imgforge-v0.9.0/imgforge-linux-amd64.tar.gz
tar xzf imgforge-linux-amd64.tar.gz

# Make executable
chmod +x imgforge

# Install
sudo mv imgforge /usr/local/bin/

# Verify
imgforge --version
# → imgforge v0.9.0

git clone https://github.com/allfab/garmin-img-forge.git
cd garmin-img-forge

sudo dnf install gdal-devel gdal cmake g++ rust cargo

sudo apt-get install -y libgdal-dev gdal-bin cmake g++
# Rust via rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

cd tools/ogr-polishmap
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)

# Install as a GDAL plugin
sudo cp ogr_PolishMap.so $(gdal-config --plugindir)/

# Verify
ogrinfo --formats | grep -i polish
# → PolishMap -vector- (rw+v): Polish Map Format (*.mp)

cd ../..

cd tools/mpforge
cargo build --release

# Verify
./target/release/mpforge --version

cd ../..

cd tools/imgforge
cargo build --release

# Verify
./target/release/imgforge --version

cd ../..

# Verify everything is in place
which mpforge || echo "mpforge: use ./tools/mpforge/target/release/mpforge"
which imgforge || echo "imgforge: use ./tools/imgforge/target/release/imgforge"
ogrinfo --formats | grep -i polish

# 1. Download a department (Isère)
./scripts/download-data.sh --zones D038 --data-root ./data/bdtopo

# 2. Run tiling
mpforge build --config configs/test-isere.yaml --jobs 4

# 3. Compile
imgforge build output/tiles/ --output output/gmapsupp.img --jobs 4 --latin1

# 4. Verify
ls -lh output/gmapsupp.img