Git Product home page Git Product logo

ecosound-web's Introduction

DOI

ecoSound-web

Description

Web application for ecoacoustics to archive and manage soundscapes, host reference recordings, navigate spectrograms, annotate and review animal vocalisations or other sounds.

Credits and license

Developed by Noemi Perez and Kevin Darras. ecoSound-web was forked from BioSounds and is licensed under the GNU General Public License, v3.

The corresponding updatable scientific publication is in F1000Research.

Quick start for end users

A working instance of ecoSound-web can be accessed here with limited functionality within the open collections.

You may learn about the basic functionality in the user guide (see Wiki).

Contact us for a collaboration.

Quick start for developers

We use Docker to run the app in your computer. We provide install.sh and run.sh files with all necessary commands, and a Makefile with extra 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.

Installation

sh install.sh

Run

sh run.sh

Using ecoSound-web

Open http://localhost:8080

Log in with username: admin, password: Administrator20

Important: please change the password of this administrator user or delete it once you have ecoSound-web running on production and have your own admin users.

Stop

docker-compose stop

Optional: clean restart (removing containers)

docker container prune

Server installation

With Docker

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.

Without Docker

Like any other web app, ecoSound-web can be installed without Docker (see Wiki).

Configuration file

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.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.