yaaat 0.1.0__tar.gz

yaaat-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+# Released under MIT License
+
+Copyright (c) 2025 Ashlae Blum'e
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

yaaat-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: yaaat
+Version: 0.1.0
+Summary: Interactive bioacoustic annotation tool for vocalizations
+Home-page: https://github.com/laelume/yaaat
+Author: laelume
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# 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. 
+
+<table>
+  <tr>
+    <td><img src="changepoint_annotator_demo.jpg" alt="Changepoint Annotator" width="400"/></td>
+    <td><img src="images/peak_annotator_screenshot.jpg" alt="Peak Annotator" width="400"/></td>
+  </tr>
+  <tr>
+    <td align="center">Changepoint Annotator</td>
+    <td align="center">Peak Annotator</td>
+  </tr>
+</table>
+
+## 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
+```bash
+git clone https://github.com/laelume/yaaat.git
+cd yaaat
+pip install -r requirements.txt
+cd yaaat
+python changepoint_annotator.py
+```
+
+## Installation As Package
+```bash
+pip install yaaat
+```
+
+## Usage
+
+### Run As Standalone Application
+```bash
+download .exe file
+```
+
+### Start From Command Line
+```bash
+yaaat
+```
+
+### Use in Python, Jupyter, &.c
+```python
+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.

yaaat-0.1.0/README.md

@@ -0,0 +1,89 @@
+# 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. 
+
+<table>
+  <tr>
+    <td><img src="changepoint_annotator_demo.jpg" alt="Changepoint Annotator" width="400"/></td>
+    <td><img src="images/peak_annotator_screenshot.jpg" alt="Peak Annotator" width="400"/></td>
+  </tr>
+  <tr>
+    <td align="center">Changepoint Annotator</td>
+    <td align="center">Peak Annotator</td>
+  </tr>
+</table>
+
+## 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
+```bash
+git clone https://github.com/laelume/yaaat.git
+cd yaaat
+pip install -r requirements.txt
+cd yaaat
+python changepoint_annotator.py
+```
+
+## Installation As Package
+```bash
+pip install yaaat
+```
+
+## Usage
+
+### Run As Standalone Application
+```bash
+download .exe file
+```
+
+### Start From Command Line
+```bash
+yaaat
+```
+
+### Use in Python, Jupyter, &.c
+```python
+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.

yaaat-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "yaaat"
+version = "0.1.0"
+description = "Interactive bioacoustic annotation tool for vocalizations"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+
+[project.scripts]
+yaaat = "yaaat.main:main"

yaaat-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

yaaat-0.1.0/setup.py

@@ -0,0 +1,44 @@
+from setuptools import setup, find_packages
+from pathlib import Path
+
+# Read README
+this_directory = Path(__file__).parent
+long_description = (this_directory / "README.md").read_text(encoding='utf-8')
+
+setup(
+    name="yaaat",
+    version="0.1.0",
+    author="laelume",
+    description="Yet Another Audio Annotation Tool - Interactive bioacoustics multitool for annotating vocalizations",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/laelume/yaaat",  
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Science/Research",
+        "Topic :: Multimedia :: Sound/Audio :: Analysis",
+        "Topic :: Scientific/Engineering",
+    ],
+    python_requires=">=3.8",
+    install_requires=[
+        "numpy",
+        "matplotlib",
+        "librosa",
+        "natsort",
+        "sounddevice",
+    ],
+    entry_points={
+        'console_scripts': [
+            'yaaat=yaaat.main:main',  # Launch tabbed interface
+        ],
+    },
+)

yaaat-0.1.0/yaaat/__init__.py

@@ -0,0 +1,13 @@
+# Copyright (c) 2025 Ashlae Blum'e | laelume
+# Licensed under the MIT License
+
+"""YAAAT - Yet Another Audio Annotation Tool"""
+
+from .changepoint_annotator import ChangepointAnnotator, main
+from .peak_annotator import PeakAnnotator
+from .main import YAATApp, main
+
+__version__ = "0.1.0"
+__author__ = "laelume"
+__license__ = "MIT"
+__all__ = ["ChangepointAnnotator", "PeakAnnotator", "YAATApp"]

yaaat-0.1.0/yaaat/__main__.py

@@ -0,0 +1,5 @@
+"""Entry point when running python -m yaaat"""
+from yaaat.main import main
+
+if __name__ == "__main__":
+    main()