Skip to content

Repository files navigation

Xolmis Mobile

Xolmis Mobile is designed for fieldwork, enabling researchers and citizen scientists to record ornithological data directly on their mobile devices. Collect ornithological data such as bird lists and counts, nest monitoring and collected specimens. Use it as your digital field notebook.

Warning

This project is in the early stages of development, so expect bugs and breaking changes.

Note

🕊️ Xolmis is a genus of Neotropical passerines. Today it is represented by two species: Xolmis irupero and Xolmis velatus.

Features

Here is a list of the main features:

  • Creation of bird lists, without repeating species. Types available:
    • Free Qualitative List.
    • Timed Qualitative List.
    • Interval Qualitative List.
    • Mackinnon List.
    • Transect Count.
    • Point Count.
    • Banding.
    • Casual observation.
  • Creation of detection (bird individuals or groups) lists, allowing to repeat species (e.g. using Distance method). Types available:
    • Detection Transect.
    • Detection Point Count.
    • Spot mapping.
  • Use the location services of the device to collect points of interest for species.
  • Collect vegetation data (Alianza del Pastizal protocols) within a list.
  • Collect weather data within a list.
  • Record nests and eggs data.
    • Record parental care on nests.
  • Record specimens collected.
  • Export data to CSV, Excel or JSON files.
  • Export geographical coordinates to KML file.
  • Field journal and notes.
  • Collect quali-quantitative data of captured birds.
  • Attach images to the data (vegetation, nests, and specimens).
  • Integration with Xolmis desktop (via text files).
  • Statistics view.
  • Backup and restore data.

Important project details

  • Local-first app: Xolmis Mobile stores user data locally in SQLite (sqflite), so core field workflows work offline.
  • Five main modules: inventories, nests, specimens, field journal, and statistics.
  • Image-aware backups: backups are ZIP-based and include both the database and attached image files.
  • Country-based species data: autocomplete/checklists are loaded from bundled JSON assets by selected country.
  • Localized interface: user-facing strings are translated and managed via localization files.

Xolmis Desktop integration

Xolmis Mobile is designed to interoperate with Xolmis Desktop by exporting/importing structured files.

  • Data can be exported from mobile (CSV, Excel, JSON, KML, and feature-specific text files) and consumed in desktop workflows.
  • JSON export/import uses a shared envelope structure to keep compatibility across modules and versions.
  • Main transferable records include inventories, nests, specimens, and related observations.
  • This interoperability allows a practical workflow: collect data in the field with mobile devices, then continue analysis and curation on desktop.

Tip

When possible, prefer JSON export/import for richer structure and better long-term compatibility between mobile and desktop projects.

Data safety and portability

  • Use backup/restore regularly to keep database records and linked images synchronized.
  • Prefer feature export before large migrations or app reinstallation.
  • Keep generated files organized per project/campaign to simplify desktop ingestion.

Technology stack

  • Flutter: Cross-platform mobile development framework for iOS and Android.
  • SQLite: Local database for structured data storage.
  • Dart: Programming language used in Flutter.
  • GitHub: Version control and collaboration platform.

How to contribute

You can create pull requests directly and give feedback using the GitHub Issues. All suggestions, bugs reported and general issues are much appreciated.

See the Developer Wiki for more details.

Acknowledgements

Xolmis is developed to support ornithological research, conservation, and citizen science.
We thank all contributors, institutions, and communities engaged in bird monitoring and ecological studies. Special thanks to our sponsors!

Platinum Sponsor

Alianza del Pastizal - Platinum Sponsor

About

Your digital field notebook. Collect ornithological data in the field.

Topics

Resources

Code of conduct

Contributing

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages