Skip to content

Installation#

acoupi_batdetect2 has been designed to run on single-board computer devices like the Raspberry Pi (RPi). Users should be able to download and test acoupi_batdetect2 on any Linux-based machine with acoupi software and Python version >=3.8,<3.12 installed.

Installation Requirements#

We recommend the following hardware elements to install and run acoupi_batdetect2.

  • A Linux-based single-board computer such as the Raspberry Pi 4B.
  • A SD Card with 64-bit Lite OS version installed.
  • A USB ultrasonic Microphone such as an AudioMoth USB Microphone or an Ultramic 192K/250K.
Recommended Hardware

The software has been extensively developed and tested with the RPi 4B. We advise users to select the RPi 4B or a device featuring similar or higher specifications.

Installation Steps#

Getting started with Raspberry Pi

If you are new to RPi, we recommend you reading and following the RPi's Getting started documentation.

To install and use acoupi_batdetect2 on your embedded device follow these steps:

Step 1: Install acoupi and its dependencies.

CLI Command: install acoupi

curl -sSL https://github.com/acoupi/acoupi/raw/main/scripts/setup.sh | bash

Step 2: Install acoupi_batdetect2.

CLI Command: install acoupi_batdetect2

pip install acoupi_batdetect2

Step 3: Configure the acoupi_batdetect2 program.

acoupi_batdetect2 program includes multiple components for recording, processing, saving and deleting audio files, as well as sending detections and summary messages to a remote server. Enter the following command to configure the program according to your needs.

CLI Command: configure acoupi_batdetect program

acoupi setup --program acoupi_batdetect2.program

Step 4: To start a deployment of acoupi_batdetect2, run the command:

CLI Command: start the configured acoupi_batdetect program

acoupi deployment start