Manual Install

1. Go to our releases page
2. Select the version you want to download
   • Choose the Latest release unless you specifically need features that are available in a Pre-release
3. Scroll down to the assets section for your chosen release
4. Download the version of AnalysisPrograms suitable for your computer (see Choosing the asset)
5. Extract the folder
   • It can be installed in any directory
   • We typically extract to a directory named ~\AP or ~/.local/share/AP on Linux
6. Make sure any Prerequisites are installed
7. [Optional] Add the install directory to your PATH environment variable
   • Instructions in the Path document.
8. Finally, check the install by running:

Run the following command:

• Windows Check
• Linux Check
• MacOSX Check

C:\AP\AnalysisPrograms.exe CheckEnvironment

Choosing the asset

What operating system do you use?

Common choices:

Windows

Linux

Mac OSX

Expert choices:

Linux (Alpine)
(choose for a container)

Any
(choose for a run anywhere version, requires a dotnet core runtime install)

What is your CPU architecture?

Intel x86-64 (64-bit)
This is a good default choice; nearly all computers, laptops, and servers use x86

Arm (32-bit)
Choose this if you're using a Raspberry Pi

Arm (64-bit)
Choose this if you're using a Raspberry Pi with 64-bit Raspbian or any other ARM device

Note

We do not support 32-bit operating systems or CPU architectures, except for Arm devices.

Do you need to debug this?

Yes

No

Note

For expert use only. A debug version will run slower.

Asset name

AP_win-x64_vXXX.XXX.XXX.XXX.zip

Warning

A .NET Core runtime must be installed and AnalysisPrograms must be invoked with a dotnet prefix.

Prerequisites

Windows

None. Self contained download.

MacOSX

None. Self contained download.

Linux/Unix

The following additional dependencies may be required for Linux/Unix machines:

• MAYBE: ffmpeg
  • a packaged version with AP.exe should work for all platforms except ARM and ARM64
• MAYBE: wavpack
• libsox-fmt-all, sox
• libav-tools (on some distros only, not needed in Ubuntu 18)

Build Packages

There are two variants of AP.exe:

1. The Stable release is well tested used by QUT Ecoacoustics on our servers and is usually a few months old
2. The Prerelease release is automatically built weekly, every Monday. It has more features and bug fixes than the stable release but it also could have more bugs.

You should use the Stable release unless there is a recent feature implemented or bug fix in the prerelease version that you need.