Visualisation utility for Wildlife Acoustics and GUANO-tagged data exports
This documentation can be viewed at https://parsingphase.dev/batbox/
See (and hear) it in action: https://batbox.phase.org
Source code: https://github.com/parsingphase/batbox
Wildlife Acoustics are a manufacturer of wildlife audio tracking tools, from hobbyist to professional.
GUANO is a standardised tag format for recordings of bat echolocation calls.
This utility is designed to help sort and visualise data exported from these tools by providing a map and time-based interface to audio recordings. It works best with GUANO-tagged files, but can also WAV files from Wildlife Acoustics exports with or without these tags, so long as the related KML files are also present.
So far it's been tested with the output of an Echo Meter Touch 2 Bat Detector.
Running the code
While this is a web-based application, it's also set up to easily run on your laptop or desktop, if you're familiar with the command line - it should work as-is on MacOS or Linux.
For instructions on how to do so, read RUNNING-LOCALLY.md.
If you'd like to run the code on your own server, for public view, see RUNNING-SERVER.md
To run a development environment, see RUNNING-DEVELOPMENT.md
What you can do
- Search by time, location and species
- View a calendar of recording sessions
- View sets of recordings (by search, date, species) on a map, and play the audio files in your browser
- View and manage data in an inbuilt admin interface
The code is at an alpha state and needs a fair bit of aesthetic cleanup and refactoring, but it's usable.
Please file any issues or bug reports at https://github.com/parsingphase/batbox/issues
If you have any questions about usage, contact email@example.com.
- This is a hobby project, so time is limited and patience will be appreciated
- This is one of the first projects of any size that I've built in Python, so the code may not be very neat or idiomatic
Particular credit is due to David Riggs for both building the Guano library used in this project, and being incredibly helpful and responsive in helping to debug an issue with Guano data from the Echo Meter Touch.
Species full & common names can be loaded from the Mammal Diversity Database from the American Society of Mammalogists.
Please note that mappings from short codes to full species names are heuristic and not entirely foolproof. Any reportings of Malaysian Fruit Bats in Kent should be assumed to be a software error.
The project is currently licenced under the MIT licence, which should allow you to do what you need to with it. I reserve the right to change the licence at a later date, but any such change won't be retroactive - if you receive a MIT version, you can keep using it as such.