How nishantnnb/spectrolipi works
Spectrolipi is a browser-based bioacoustics tool for inspecting recordings, annotating spectrograms, managing recording and species metadata, editing audio, and exporting or sharing results. The main workflow runs from loading and visualizing sound through annotation and optional BirdNET assistance to clip or annotation export. README capabilities define several branches whose internal wiring is not visible in the supplied excerpts; those links are documented at the product level rather than inferred from imports. Processing is local in the browser, except for BirdNET model downloading and optional Xeno-canto API uploads.
Main entry points: birdnet_overlay.js BirdNET assistance · spectrogram.js Spectrogram view · birdnet_v2.4.js BirdNET inference · filters.js Audio filters and silence
Components 25
Sound visualization
- Spectrogram view
spectrogram.js - Playback and navigation
playback.js - Zoom controls
zoom_controls.js - Display settings
spectrogram_settings.js
Annotation workflow
- Create annotations
create_annotations.js - Edit annotations
edit_annotations.js - Delete annotations
delete_annotations.js - Repeat annotation
repeat_annotation.js - Pattern templates
spectral_stamp.js - Pattern detection
scc.js - BirdNET assistance
birdnet_overlay.js - BirdNET inference
birdnet_v2.4.js - BirdNET model files
models/birdnet_v2.4
Audio tools
- Audio filters and silence
filters.js - Audio normalization
normalize.js
Metadata and species
- Recording metadata
metadata.js - Species management
species_manage.js - Recent species list
recent_species.js - Browser local storage
Export and integrations
- Clip generation
generate_clips.js - Annotation import and export
download_annotations.js - Annotation upload
upload_annotations.js - Xeno-canto integration
upload_xc.js - Xeno-canto API
Other components
- Researcher or birder
Connections 27
- Researcher or birder → Spectrogram view: loads and views
README.md - Spectrogram view → Playback and navigation: plays recording
README.md - Researcher or birder → Zoom controls: adjusts view
README.md - Researcher or birder → Display settings: adjusts display
README.md - Researcher or birder → Create annotations: draws annotations
README.md - Researcher or birder → Edit annotations: edits annotations
README.md - Researcher or birder → Delete annotations: removes annotations
README.md - Researcher or birder → Repeat annotation: repeats patterns
README.md - Researcher or birder → Pattern templates: uses templates
README.md - Researcher or birder → Pattern detection: runs detection
README.md - Researcher or birder → BirdNET assistance: requests analysis
README.md - BirdNET assistance → BirdNET inference: uses inference
- BirdNET inference → BirdNET model files: loads model
- BirdNET assistance → Create annotations: inserts annotations
birdnet_overlay.js - Researcher or birder → Recording metadata: maintains metadata
README.md - Researcher or birder → Species management: manages species
README.md - Researcher or birder → Recent species list: selects species
- Recording metadata → Browser local storage: backs up locally
metadata.js - Species management → Browser local storage: persists records
species_manage.js - Researcher or birder → Audio filters and silence: edits sound
README.md - Audio filters and silence → Spectrogram view: recomputes display
filters.js - Researcher or birder → Audio normalization: normalizes audio
README.md - Researcher or birder → Clip generation: exports clips
README.md - Researcher or birder → Annotation import and export: imports or exports
README.md - Researcher or birder → Annotation upload: uploads annotations
README.md - Researcher or birder → Xeno-canto integration: shares annotation set
README.md - Xeno-canto integration → Xeno-canto API: posts API upload
upload_xc.js