yaaat 0.1.0

Interactive bioacoustic annotation tool for vocalizations

YAAAT: Yet Another Audio Annotation Tool

Lightweight interactive bioacoustics annotation toolkit for measuring animal vocalizations.

Features:

1. Changepoint Annotator, for marking temporal onset, offset, and changepoints in vocalizations.
2. Peak Annotator, for marking dominant frequency peaks on the power spectrum.

Changepoint Annotator	Peak Annotator

Getting Started

1. Click Load Audio Directory to select your audio files
2. Choose where to save annotations (existing directory, new directory, or default)
3. Click on the spectrogram to add annotation points
4. Click Finish Syllable when done with each syllable
5. Move between files using Next/Previous buttons
6. Annotations auto-save on file navigation or 'Finish syllable'

Navigation & Features

• Intuitive real-time interactive visualization with zoom, pan, and keycommand + mousewheel navigation
• Visualize harmonics with adjustable multipliers and draggable bounding boxes
• JSON annotations saved per-file to minimize corruption
• Mark and track unusable files
• Adjust spectrogram resolution for accuracy comparison
• TODO: implement ranking system for annotation quality; add PSD views; inject as learning feedback mechanism

Installation From Command Line

git clone https://github.com/laelume/yaaat.git
cd yaaat
pip install -r requirements.txt
cd yaaat
python changepoint_annotator.py

Installation As Package

pip install yaaat

Usage

Run As Standalone Application

download .exe file

Start From Command Line

yaaat

Use in Python, Jupyter, &.c

from yaaat import ChangepointAnnotator
import tkinter as tk

root = tk.Tk()
app = ChangepointAnnotator(root)
root.mainloop()

Requirements

• Python ≥3.8
• numpy
• matplotlib
• librosa
• natsort
• sounddevice

License

MIT License - Copyright (c) 2025 laelume

Contributing

Contributions welcome! Please open an issue or submit a pull request.