Moove Documentation

Moove (Marking Online using Only the Onsets of Vocal Elements) is a novel tool for real-time syllable segmentation and classification of birdsong, designed to enable closed-loop experiments in vocal learning research.

Contents

• Introduction
• Installation
  • Quick start
  • Requirements
  • Installing with pip
  • Installing from source with uv (recommended for development)
  • Platform-specific notes
    • Windows
    • macOS
    • Linux (Debian / Ubuntu)
  • Enabling ASIO support (Windows)
    • Modern method (sounddevice ≥ 0.5)
    • Legacy method (manual DLL replacement)
    • Custom PortAudio path
  • Installing with conda
  • Where is Moove installed?
  • (Optional) Hardware we are currently using
• MooveTaf
  • Baseline Recordings
    • Setting the config
  • Targeting
• MooveGUI
  • Setting the config
  • Main window
  • Syllable segmentation
    • Segmenting a file
    • Create a Segmentation Training Dataset
    • Train the Segmentation Network
    • Resegment using the Trained Network
  • Label Clustering
    • Create a Cluster Training Dataset
    • Cluster Syllables
    • Dash GUI
  • Syllable classification
    • Create a Classification Training Dataset
    • Training the Classification Network
    • Relabel Data
• REC file and Feedback Information
• Loading previously recorded data
• FAQ
  • Installation & setup
    • Which Python version should I use?
    • Do I still need Tkinter?
    • I get “No module named sounddevice” or a PortAudio error
    • How do I enable ASIO on Windows?
    • PyTorch fails with WinError 1114 / WinError 126 on Windows
    • NumPy 2.x – is it supported?
    • Poetry errors during installation
  • Using MooveTaf
    • My recording starts but the threshold for recording is never triggered
    • My recording starts but my bouts are not saved
    • Where are my recorded files?
    • My recording seems to stop in the midde of a syllable/ bout
    • Why are there big red “stripes” in the middle of my recordings?
  • Using MooveGUI
    • Where is my .moove folder?
    • Why does my GUI not open anymore?
    • Why are my trained models saved as .zip?
    • My spectrogram looks wrong or is empty
    • What if my segmentation looks ugly?
• References