BioSounds is a web application for ecoacoustics that archives and organises soundscape collections, hosts reference recording collections, generates navigable sound spectrograms, and allows annotation of animal vocalisations or other sounds.
Developed by Noemi Perez and Kevin Darras, from the University of Goettingen.
Biosounds is licensed under the GNU General Public License, v3.
The corresponding citable, updatable scientific publication will be available soon in F1000Research.
Originally based on the archived Pumilio project, it has evolved into a new, refactored project with new functionalities.
Biosounds still uses the original Python spectrogram generation code (copyright by Luis J. Villanueva), but we intend to fully use Web Audio API in the future if it can fulfill all BioSounds needs.
We will tackle the implementation of automated detection of sounds next.
BioSounds uses Docker which provides a solution based on containers where the app can run easily in your computer. That avoids having to manually install all libraries, database and other components necessary for running BioSounds.
For facilitating the process, we have added a couple of files: install.sh and run.sh with all necessary commands. There is also a Makefile with some extra helpful commands to access the docker containers.
You need to install docker and docker-compose directly in your machine. Please read the documentation and follow the instructions carefully. We don't offer support for docker installation and configuration.
Important: this setup is intended for developing and testing purposes ONLY. It is in no way ready for production. Please read the Server Installation section.
sh install.sh
sh run.sh
docker-compose stop
Log in with username: admin, password: Administrator20
Important: please change the password of this administrator user or delete it once you have BioSounds running on production and have your own admin users.
If you want to use Docker for your own server installation, please consult with a devOps engineer or someone with the necessary knowledge to manage it properly, depending on your hosting setup.
The current Docker configuration Dockerfile can be used for your preferred setup.
Like any other web app, BioSounds can be installed without Docker. Please read the dedicated documentation here.
For both cases (with and without Docker), you'll need to set the configuration values in the config.ini file, according to your server setup.
A working instance of Biosounds can be accessed here with limited functionality within the open collections.
We also wrote a guide for end users explaining the basic functionality.