mapknitter
An open-source web tool for stitching aerial photos into georeferenced maps using a browser-based interface.
What is mapknitter?
MapKnitter is an open-source web application that allows users to upload aerial photographs—such as those from balloon or kite mapping—and align them over base maps to create georeferenced composite maps. It solves the problem of creating custom maps without expensive GIS software by providing a browser-based tool for manual image placement and export in multiple formats.
Community mappers, environmental researchers, educators, and DIY enthusiasts who need to create detailed maps from low-cost aerial imagery for local projects, advocacy, or scientific monitoring.
Developers choose MapKnitter for its fully open-source stack, ease of self-hosting, and integration with the Public Lab ecosystem. It offers a unique collaborative web interface for manual map stitching, making it ideal for grassroots mapping efforts where automated solutions are impractical.
Overview
Upload your own aerial images, position (rubbersheet) them in a web interface over existing map data, and share via web or composite and export for print.
Use Cases
Best For
- Creating community-led environmental monitoring maps from kite or balloon photos
- Teaching geospatial concepts in classrooms with hands-on mapping projects
- Producing custom base layers for web maps without proprietary software
- Stitching historical aerial imagery into georeferenced composites
- Grassroots land-use documentation and advocacy campaigns
- Generating GeoTIFF exports for further analysis in GIS tools
Not Ideal For
- High-precision surveying or legal map production requiring automated georeferencing
- Large-scale aerial survey projects needing batch processing of hundreds of images
- Teams wanting plug-and-play deployment without managing a Ruby on Rails stack and external services
Pros & Cons
Pros
Leverages Leaflet.DistortableImage for browser-based, CSS3 distortion, enabling intuitive drag-and-drop alignment without server latency.
Generates web maps, GeoTIFFs, TMS tiles, and JPEGs through a dedicated exporter service, supporting diverse downstream uses.
Integrates with Public Lab's DIY tools and emphasizes collaborative features like shared maps and annotations for grassroots advocacy.
Offers complete code access and self-hosting options, avoiding proprietary fees and allowing customization for specific needs.
Cons
Demands multiple prerequisites like MySQL, Ruby 2.4.6, and GDAL, with noted complications on Windows and macOS, hindering quick setup.
Relies on user estimation for image placement, lacking automation for precise georeferencing or handling large image sets efficiently.
Requires running a separate Sinatra app for exports, adding complexity to deployment and maintenance compared to integrated solutions.
Frequently Asked Questions
Related Projects
Ruby on RailsRuby on Rails
chatwootOpen-source live-chat, email support, omni-channel desk. An alternative to Intercom, Zendesk, Salesforce Service Cloud etc. 🔥💬
SinatraClassy web-development dressed in a DSL (official / canonical repo)
chefChef Infra, a powerful automation platform that transforms infrastructure into code automating how infrastructure is configured, deployed and managed across any environment, at any scale
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.