๐Ÿ“– WildDetector Guide

WildDetector is an Android app that uses on-device AI to detect wildlife โ€” by sound and by sight โ€” in real time. It works completely offline: no data is sent to any server during detection. When you are signed in, your detections can optionally be saved to the cloud and shown on a shared map.

๐Ÿพ Species

When you open the app you choose which species to monitor. Each species has its own AI models and tuned settings.

๐Ÿ

Bee

Audio CNN + Motion detector

Detects the characteristic wing-beat frequency of bees (around 200โ€“300 Hz). Works best 0.5โ€“2 m from the hive or flowers.

๐Ÿธ

Frog

Audio CNN

Identifies frog calls from a library of species. Works best at night near water sources.

๐Ÿฆœ

Bird

Audio CNN + YOLO visual

Combines audio classification with visual detection. Can identify species by song even without a visual.

๐ŸฆŽ

Reptile

YOLO visual

Primarily visual detection using a YOLO model running at 10โ€“15 FPS on-device. Point the camera at the subject.

๐Ÿ”

General

Anomaly + Motion only

No species-specific model. Uses anomaly detection and motion tracking to catch any unusual activity. Ideal for unknown species or custom field setups.

๐Ÿ”ฌ How Detection Works

WildDetector fuses three independent detection sources. Each can trigger independently or be chained in a pipeline.

๐ŸŽ™๏ธ

Audio Classification

The microphone continuously captures audio. Every ~1 second, a CNN model classifies the sound and produces a probability score. When the score exceeds the threshold for several consecutive windows, a detection is fired.

๐Ÿ“ท

Visual Detection (YOLO)

The camera runs a YOLO object detection model on every frame. When the target species appears in multiple consecutive frames (configurable), a detection is triggered. Bounding boxes are drawn live on screen.

โšก

Anomaly Detection

An autoencoder model learns what 'normal' sounds and images look like during a calibration phase (~2 minutes). Once calibrated, anything outside the normal distribution triggers an anomaly alert โ€” useful for catching rare events.

๐ŸŸก

Motion Detection

A lightweight frame-differencing algorithm detects moving objects in the camera view. Motion is a trigger-only source โ€” it wakes up other detectors but does not generate a standalone detection by itself.

๐Ÿ”— Detection Pipeline

By default every source fires independently. The pipeline lets you chain sources so that a detection is only recorded when multiple sources confirm the event in sequence. This dramatically reduces false positives.

# Example: require motion then audio

Stage 1 โ†’ Motion detected

Stage 2 โ†’ Audio confirms within 10 s

โ†’ Detection recorded โœ“

You can configure the pipeline in Settings โ†’ Pipeline Editor. Each stage has a 10-second timeout โ€” if the next stage does not fire in time, the pipeline resets.

โš™๏ธ Settings

๐ŸŽ™๏ธ Audio

Enable audio detection

Turns the audio CNN classifier on or off. Disable if you only need visual detection to save battery.

Audio device

Select the microphone to use. Useful if you connect an external USB microphone for better range.

Audio channel

Left, Right, or Mixed. Use Left or Right when using a stereo directional microphone.

Consecutive windows

How many consecutive high-probability windows are required before firing. Higher = fewer false positives. Default: 3.

๐Ÿ“ท Camera / YOLO

Enable YOLO detection

Turns on the on-device YOLO visual model. Uses more CPU/GPU and battery.

Confidence threshold

Minimum confidence (0โ€“1) for YOLO to consider a detection valid. Default: 0.4.

Consecutive frames

How many consecutive frames must contain the target before firing. Default: 3.

Burn bounding boxes

Saves an annotated JPEG snapshot with boxes drawn on it to your gallery each time YOLO fires.

โšก Anomaly Detection

Enable audio anomaly

Trains an autoencoder on ambient sound during the first ~2 minutes, then alerts on anything unusual.

Enable video anomaly

Same as audio anomaly but for the camera feed. Useful in fixed-camera setups.

Thresholds

Automatically adapts based on your feedback (thumbs up / thumbs down on each anomaly card).

๐ŸŸก Motion

Sensitivity (1โ€“10)

How easily motion is detected. High sensitivity picks up insects; low sensitivity ignores leaves and camera shake.

Max blob size (px)

Maximum size of a detected moving object. Set small to detect insects; large to detect mammals.

Min speed (px/frame)

Minimum speed a blob must travel to count as motion. Filters out slow camera drift.

Show trail

Draws the path of each moving object on screen for visual feedback.

๐ŸŽฌ Video Recording

Save video clips

Automatically records a video clip around each detection event.

Pre-roll (seconds)

How many seconds before the detection to include in the clip. Default: 5 s.

Post-roll (seconds)

How many seconds after the detection to continue recording. Default: 5 s.

๐Ÿ”‹ Battery & Screen

Keep screen on

Prevents the screen from turning off during a detection session. Recommended for field use.

Samsung: Never sleeping apps

On Samsung devices, add WildDetector to Settings โ†’ Battery โ†’ Never sleeping apps to ensure background detection keeps running with the screen off.

๐Ÿ’พ Presets

Save preset

Saves all current settings under a name so you can switch between configurations quickly.

Load preset

Restores a previously saved configuration.

๐Ÿ‘ค Account & Premium

WildDetector works fully offline without an account. Signing in unlocks cloud features.

Guest

  • โœ“ 5-min sessions
  • โœ“ All detectors
  • โœ“ Local session log
  • โœ“ Nothing saved to cloud

Signed In (Free)

  • โœ“ 5-min sessions
  • โœ“ Detections saved to cloud
  • โœ“ GPS coordinates logged
  • โœ“ Public on live map
  • โœ“ My Detections history

Premium

  • โœ“ Unlimited sessions
  • โœ“ Everything in Free
  • โœ“ Private detections option
  • โœ“ $10 / month or $80 / year

Sign in via Settings โ†’ Account โ†’ Sign in with Google. Subscriptions are managed through Google Play and can be cancelled at any time. Premium status is cached for up to 35 days offline (monthly) or 370 days (annual).

๐Ÿ“‹ My Detections

Every detection made while signed in is saved to your personal history, organized by session.

SessionsEach time you press Start, a new session is created. All detections from that run are grouped under one session header showing the date, time, and count.
Deleting detectionsSwipe any detection left or right to delete it. It is removed from both the app and the cloud immediately.
Public vs PrivateFree users always share data publicly. Premium users can toggle sharing per-account in Settings โ†’ Account โ†’ Share detections publicly.

๐Ÿ’ก Tips & Tricks

โ†’ Use an external USB microphone

A directional or parabolic microphone connected via USB OTG dramatically increases detection range. Select it in Settings โ†’ Audio device.

โ†’ Set pipeline for fewer false positives

Chain Motion โ†’ Audio or Motion โ†’ YOLO so the app only records confirmed events, not background noise.

โ†’ Calibrate anomaly detection first

Start a session and wait 2 minutes without the target species present. The anomaly detector learns the background and becomes much more accurate.

โ†’ Use pre-roll to never miss the moment

Set a 10-second pre-roll so that when a detection fires, the video clip includes the approach, not just the aftermath.

โ†’ Samsung users: add to Never Sleeping Apps

Without this, Samsung's aggressive battery manager kills the background service within minutes of the screen turning off.

โ†’ GPS must be enabled

The app requires location access to tag detections with coordinates. Make sure GPS is on before starting a session.