{"id":25636344,"url":"https://github.com/marek-jakub/monitoring","last_synced_at":"2026-06-20T04:30:16.001Z","repository":{"id":211468976,"uuid":"643951714","full_name":"marek-jakub/monitoring","owner":"marek-jakub","description":"A university project concerning field data management for bird ringers.","archived":false,"fork":false,"pushed_at":"2024-02-28T17:21:25.000Z","size":1506,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-02-28T18:36:13.092Z","etag":null,"topics":["bird","data","fieldwork","management","ringing"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marek-jakub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-05-22T13:50:05.000Z","updated_at":"2024-02-20T17:23:46.000Z","dependencies_parsed_at":"2024-02-15T18:51:36.514Z","dependency_job_id":null,"html_url":"https://github.com/marek-jakub/monitoring","commit_stats":{"total_commits":1313,"total_committers":2,"mean_commits":656.5,"dds":"0.48286367098248284","last_synced_commit":"0cf48bf3ba0c587d8150df89273a745765f2f69c"},"previous_names":["marek-jakub/monitoring"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marek-jakub%2Fmonitoring","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marek-jakub%2Fmonitoring/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marek-jakub%2Fmonitoring/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marek-jakub%2Fmonitoring/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marek-jakub","download_url":"https://codeload.github.com/marek-jakub/monitoring/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240254184,"owners_count":19772387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bird","data","fieldwork","management","ringing"],"created_at":"2025-02-23T00:41:39.477Z","updated_at":"2026-06-20T04:30:15.455Z","avatar_url":"https://github.com/marek-jakub.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MonitoRing\n\n\u003cimg src=\"assets/images/mon_ring_logo.png\" align=\"right\"\n     alt=\"MonitoRing project logo.\" width=\"100\" height=\"130\"\u003e\n\nThis is a student project, with the main goal of researching bird ringing data management practices and building a high-fidelity, horizontal prototype of a mobile application used in the management of bird ringing data in fieldwork conditions.\n\n## Table of Contents\n\n- [MonitoRing](#monitoring)\n  - [Table of Contents](#table-of-contents)\n  - [MonitoRing Description](#monitoring-description)\n    - [Continuous Development](#continuous-development)\n  - [Install and run](#install-and-run)\n  - [How to use](#how-to-use)\n  - [Testing](#testing)\n  - [Licence](#licence)\n    - [References](#references)\n\n## MonitoRing Description\n\nThe application allows bird ringers:\n\n- manage rings (or bands)\n- enter bird ringing session data\n- enter and manage bird ringing data\n- enter and manage re-catch data\n\nThe logic in the application draws heavily from EURING Exchange Code 2020 [[1]](#1). Data management relies on forms and local data persistence library [[2]](#2). The application has been developed using the Dart language and Flutter framework. The framework has been used to allow for single codebase, to be used on Android and iOS devices.\n\n### Continuous Development\n\nWARNING! Even though the prototype is in a working condition, with ability to run accross devices, there are MISSING FEATURES and dead ends. The design and codebase have been developed by one person, this effort is continuous...\n\n## Install and run\n\nThe latest version of Flutter used to run and test the application is version 3.16.9, with Dart SDK version: 3.2.6.\n\nAfter downloading the codebase and placing it at a chosen directory, the application can be run:\n\nAdd and enable a device the application to be run on, e.g.:\n\n```bash\nflutter create --platform=\u003cplatform\u003e .\nflutter config --enable-\u003cplatform\u003e-desktop\n```\n\nFor example, using linux as a platform:\n\n```bash\nflutter create --platform=linux .\nflutter config --enable-linux-desktop\n```\n\nRun the application:\n\n```bash\nflutter run -d linux\n```\n\nTo choose from available devices, run:\n\n```bash\nflutter run lib/main.dart\n```\n\nThe available and connected devices will be shown, with the ability to choose the appropriate one.\n\n## How to use\n\nTo explore the app, press the 'Explore as Guest' button:\n\n![Figure1 - Login page](assets/images/explanatory_screenshots/01_screenshot.png \"Screenshot of the login page.\")\n\nOnboarding messages can be skipped:\n\n![Figure2 - Onboarding page](assets/images/explanatory_screenshots/02_screenshot.png \"Screenshot of the onboarding page.\")\n\nIn order to start entering bird ring data, create a ringing session:\n\n![Figure3 - Home page](assets/images/explanatory_screenshots/03_screenshot.png \"Screenshot of the home page.\")\n\nFill in the form, and press the save button:\n\n![Figure4 - Session page](assets/images/explanatory_screenshots/04_screenshot.png \"Screenshot of the session page.\")\n\nNow, the session can be picked from among created and saved sessions:\n\n![Figure5 - Home page](assets/images/explanatory_screenshots/05_screenshot.png \"Screenshot of the home page.\")\n\nAny previously saved session data will be visible, to keep adding, press the 'Ring' button:\n\n![Figure6 - Home page](assets/images/explanatory_screenshots/06_screenshot.png \"Screenshot of the home page.\")\n\nFill in the form and press the save button:\n\n![Figure7 - Ring page](assets/images/explanatory_screenshots/07_screenshot.png \"Screenshot of the ring page.\")\n\nThis is an example of one of the informational loops in the application, there exist others, such as the one for adding retrap data. However, adding new features is an ongoing process, and the application in its current state cannot be considered safe for management of ringing data.\n\n## Testing\n\nUnit tests can be run by applying:\n\n```bash\nflutter test\n```\n\nor\n\n```bash\nflutter test test/unit_test.dart\n```\n\n## Licence\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n### References\n\n\u003ca id=\"1\"\u003e[1] \u003c/a\u003edu Feu, C.R. et al. (2020) ‘EURING Exchange Code 2020’. EURING. Available at: https://euring.org/files/documents/E2020ExchangeCodeV201.pdf (Accessed: 5 February 2023).\n\n\u003ca id=\"2\"\u003e[2] \u003c/a\u003eBinder, S. (2023) drift | Dart Package, Dart packages. Available at: https://pub.dev/packages/drift (Accessed: 8 August 2023).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarek-jakub%2Fmonitoring","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarek-jakub%2Fmonitoring","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarek-jakub%2Fmonitoring/lists"}