cyberes/manholer

Manholer is a native Android application designed for utility and field work, focusing on the documentation of manholes, inlet boxes, and similar structures. The tool enables users to record details about these structures, including pipe directions, invert information, simple measurements, and notes. It is intended for professionals who need to collect and organize field data related to underground infrastructure.

The application supports exporting collected data to PDF or CSV formats, facilitating reporting and documentation. In addition to its standard export options, Manholer provides an emergency export feature that allows users to trigger a complete data dump to a CSV file in the device's Downloads folder, serving as a fail-safe against data loss from app crashes or bugs. This emergency export can be triggered via a specific Android intent and runs in a separate process to ensure reliability even if the main app process is unavailable. Debug builds of Manholer also offer the ability to seed demo projects for testing purposes through a dedicated broadcast receiver.

Manholer is built primarily in Kotlin and requires Android Studio with Android SDK version 36 or higher, as well as JDK 17, for building from source. The application includes scripts for building, installing, and testing, and relies on ImageMagick for generating launcher icons. 0 license, making it open source.

This tool is positioned as a specialized solution for field workers and utility professionals who need to systematically document and manage information about manholes and related infrastructure on Android devices.