Skip to content

SagerRamon/Anisca_DecoderApp_README

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 

Repository files navigation

πŸ¦‰ Anisca Decoder App

https://aniscadecoder.streamlit.app/

The Anisca Decoder App is a web tool designed to decode and interpret logs from Anisca devices in the Field β€” especially useful when working in areas without Sigfox coverage.


πŸ“Œ 1. When & Why to Use This App

Use this app whenever you're at an Anisca system in the field and:

  • βœ… You want to check if the device is working correctly (e.g. about the same amount of Status and Offset logs)
  • βœ… You need to know if a male barn owl is known to us, especially ahead of a planned capture night
  • βœ… You are not receiving data over Sigfox and must manually assess system status at the moment of being on site.
  • βœ… Just out of curiosity.

After downloading logs from the Anisca device using the Anisca App, the .txt log file is stored locally on your device (phone or tablet). Please still upload the Files in the Anisca App as usual. The .txt can be read on site and directly give you information about the System and the Logs. The Data uploaded via the Anisca App are not available before the next 5 p.m., which is often too late.

Also, if the Files are not uploaded to the Barn Owl Database yet, you can read High Resolution JSON Files with this decoder. Those are available on the Anisca Hub > Account.

You can then use this app to decode the file and get:

  • πŸ“Š A summary of all logs
  • βš–οΈ All weight detections
  • 🧬 Overview of RFID and ring associations
  • πŸ› οΈ Diagnostic indicators of system performance

πŸ”— 2. Accessing the App

πŸ‘‰ Web Link:

https://aniscadecoder.streamlit.app/

πŸ“± Recommended Usage on Phone/Tablet:

  • Open the link in your browser (Chrome, Safari, etc.)
  • Bookmark the page so you can quickly find it again
  • On your mobile device or tablet:
    • Android: Tap the three dots β†’ β€œAdd to Home screen”
    • iOS (Safari): Tap the Share button β†’ β€œAdd to Home Screen”

You can now launch the app like a native app with one tap.


πŸ› οΈ 3. How to Use the App

  1. Open the Anisca Decoder in your browser or from your home screen shortcut
  2. Click β€œUpload Anisca Log File” and select the .txt or .json file you downloaded from the Anisca system
  3. The app will:
    • βœ… Automatically parse the file
    • πŸ”„ Match RFID detections with birds from the RingLookup
    • ✨ Highlight detections where birds are known
    • πŸ“Š Show a summary of system behavior
    • ⚠️ Display warnings if system diagnostics look suspicious
  4. Use the filters to focus on specific log types or time periods
  5. Download either the full decoded log or the filtered view using the download buttons

πŸ’¬ Need Help?

If the app shows a warning (e.g. if offset or status messages are skewed), follow these steps:

  • πŸ” Inspect the RFID antenna (copper wire)
  • βš™οΈ Run diagnostics using the Anisca Android app
  • πŸ“¨ Report issues to the #anisca-bird channel on Pumble

πŸ“ This app is developed and maintained as part of the Barn Owl Project of the Swiss Ornithological Institute and the University of Lausanne.

About

README for Anisca_DecoderApp

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published