Settings reference
Check every OcuTrap setting, including ranges, defaults, locations, and what each option controls.
On this page
Use this reference to check every configurable OcuTrap setting, including ranges and defaults.
Note: After changing settings, a reboot of the trap is recommended to ensure all changes are applied correctly.
Capture & Detection Settings
| Setting | Range | Default | Description |
|---|---|---|---|
| Capture Distance | 6 to 18 in (app presets) | 8 in | How far inside the trap an animal must be before the door closes. The trap ignores a distance outside 6 to 18 in. See Values the trap cannot use. |
| Target detected | On/Off | On | Sends an alert when an animal is detected, before the door closes. Includes a 60-second cooldown between alerts. This is the pre-capture alert. It is in the Alerts section of the trap's settings. |
Detection Zones Explained
OcuTrap uses two steps to verify captures and reduce false triggers:
- Detection area (out to ~34 in / 875 mm from the sensor): The animal is approaching; you may get a pre-capture alert
- Capture zone (your set distance, default ~8 in): The door closes when the animal reaches this point
This two-step check prevents false triggers from rain, debris, or quick movements.
Camera Settings
| Setting | Range | Default | Description |
|---|---|---|---|
| Time-lapse Interval | Disabled, 30 minutes, 1, 2, 4, 6, 12, or 24 hours | 6 hours | How often the camera takes periodic photos in every mode (unarmed, armed, scouting, and after a capture). Choose Disabled to turn time-lapse photos off. The web app and the mobile app offer the same list. |
| Image Size | Small (320×240), Medium (640×480), or Large (800×600) | Medium (640×480) | The camera quality (resolution) of capture photos. A larger size shows more detail but takes longer to send and uses more data and power. |
| Rotate Image | 0°, 90°, 180°, 270° | 0° | Rotates captured images. Useful if trap is mounted in non-standard orientation. |
| Dark Lux Threshold | 1 to 100 lux | 25 lux | Light level below which the environment is considered "dark" and IR lighting activates. |
| Min IR Brightness | 0 to 100%, in steps of 5 | 10% | Minimum infrared LED brightness in dark conditions. It cannot be higher than Max IR Brightness. |
| Max IR Brightness | 0 to 100%, in steps of 5 | 80% | Maximum infrared LED brightness. Lower values reduce glare and save power. |
| Scout Image Quality | QQVGA (160×120) to HD (1280×720) | QVGA (320×240) | Resolution of photos taken in Scouting mode. It is separate from the quality of armed-mode capture photos. Higher values mean sharper photos but slower sending and more battery use per photo. |
| Scout Photo Interval | Off, every 15 seconds, 30 seconds, 1 minute, 2 minutes, or 5 minutes | Off | In Scouting mode, how often the trap sends a new photo while an animal stays in view. Off sends one photo when an animal is detected and no repeat photos. A trap that has never received its settings from the app uses its built-in 15 seconds, even though the app shows Off (default). Saving any setting for the trap sends them. |
Defaults are the values a newly added trap starts with. A trap that is already set up keeps the values it has.
Image sizes
The option names show the real size of the photo in pixels. Image Size sets capture photos. Scout Image Quality, in the Scout section, sets photos taken in Scouting mode. Both use the same names.
| Option | Image Size | Scout Image Quality | Best For |
|---|---|---|---|
| Small (320×240) | Yes | Yes | Fastest transfer, lowest data usage |
| Medium (640×480) | Yes (default) | Yes (marked "default") | Good balance of quality and speed |
| Large (800×600) | Yes | Yes | Better detail |
| 1024×768 | No | Yes | High detail |
| 1280×1024 | No | Yes | Very high detail |
| 1600×1200 (slowest, most data) | No | Yes | Maximum detail, highest data usage |
If a trap was set to a size that the list does not offer, the app shows that size with "(current)" after it, so the picker is never blank.
Battery & Power Settings
| Setting | Range | Default | Description |
|---|---|---|---|
| Battery Type | KBT 5,200 mAh (56 Wh), standard / KBT 10,000 mAh (111 Wh) / Not specified (defaults to 56 Wh) | Not specified (defaults to 56 Wh) | Must match installed battery for accurate level estimation. The web app and the mobile app show the same three choices. There is no AA battery option. A trap that was set to the old AA option shows Not specified. |
| Battery Alerts | On/Off | On | Enables low battery notifications at 20% and 10% levels. |
| Power-Off Voltage | Set by Battery Type (9.6 V for both packs) | 9.6V | Voltage threshold below which the trap automatically hibernates. |
Battery Alert Thresholds
| Alert Level | Default Voltage | Description |
|---|---|---|
| 20% Warning | 10.4V | Low battery warning sent |
| 10% Critical | 10.2V | Critical battery warning sent |
| Auto Power-Off | 9.6V | Trap enters hibernation to protect battery |
| Reset Threshold | 11.0V | Battery must reach this level to clear low-battery flags |
Voltages shown are for the 5,200 mAh pack. The 10,000 mAh pack uses 10.2 V (20%) and 10.0 V (10%).
Temperature Alert Settings
These alerts watch the outdoor weather at the trap's location, not the trap's own internal sensor. The trap's location can come from its GPS fix or from a location you set manually. See Temperature alerts below.
| Setting | Range | Default | Description |
|---|---|---|---|
| Temperature Alerts | On/Off | Off | Enables alerts when the outdoor temperature at the trap passes a limit below. |
| High Temperature Limit | Configurable | 45°C (113°F) | Alert sent if the outdoor temperature rises above this. |
| Low Temperature Limit | Configurable | -10°C (14°F) | Alert sent if the outdoor temperature falls below this. |
| Temperature Alert Interval | 1 to 24 hours | 6 hours | Minimum time between repeat temperature alerts. |
GPS & Location Settings
| Setting | Range | Default | Description |
|---|---|---|---|
| GPS Update Interval | Disabled / 3 / 6 / 12 / 24 hours | 6 hours | Requires firmware v1073 or later and the updated app. Startup behavior depends on firmware; see below. Later attempts follow the selected interval. Manual Location requests remain available when disabled. Firmware through v1072 uses a fixed 8-hour interval when enabled. |
For timing, compatibility, and manual requests, see GPS.
GPS Behavior Details
Firmware v1101 and later: With GPS enabled, startup searching becomes eligible after 30 seconds when other work permits. A fixed 15-minute window starts at first receiver power-on; the first valid fix is sent promptly, with better estimates at most once per minute. Camera pauses use that same deadline.
Later manual and scheduled requests send the first acceptable fix, then refine for two additional minutes. Improvements must reduce estimated horizontal error by at least 10% and are sent at most once per 30 seconds. Photos or captures end later refinement after a successful fix; sleep and shutdown also take priority. Armed offline sleep does not guarantee a full startup window.
Firmware v1073-v1077 waits 15 minutes before the initial automatic attempt. Outside the startup window, search limits remain three minutes for the first attempt and two minutes for later attempts, before refinement. Valid fixes require fresh position data and at least five satellites; satellite count alone is not an accuracy guarantee. Failed searches preserve the last known location.
Battery choice: Six hours is the default, not a measured optimum. Choose a longer interval or Disabled for a trap that stays in one known location. Manual Location remains available when disabled. There is no four-hour option.
Accessory Port Settings
| Setting | Range | Default | Description |
|---|---|---|---|
| Accessory Duration | 0 to 30 seconds, in steps of 0.1 second | 0 (off) | How long the 12V accessory port stays powered when activated. The app shows the time in seconds, for example 3.0 s. 0 means off. The Accessory quick action appears in Controls only when the duration is above 0. |
The 12V accessory port can power external devices like dispensers, pumps, or other add-on hardware.
Capture Reminder Settings
| Setting | Options | Default | Description |
|---|---|---|---|
| Capture reminder | Off, 1, 2, 4, 8, 12, 24, or 48 hours | 8 hours | Repeats the capture alert at this interval while an animal is in the trap. Choose Off to stop the reminders. |
The capture reminder is an interval in hours. It is not a mode.
Off is a valid choice. It means the trap will not remind you again after a capture. While Capture reminder reads Off, the app shows a notice under the setting: "Capture reminders are off. This trap will not remind you again after a capture." The notice appears as soon as you choose Off, before you save, and clears when you choose a number of hours.
The trap's detail screen shows the same notice with a View trap settings button while the saved setting is Off. See Trap control.
Hardware & Feedback Settings
| Setting | Options | Default | Description |
|---|---|---|---|
| Enhanced Door Closing | On/Off | On | Re-seats the door under the locking rod after every close, captures included. Improves the chance the door locks. Does not confirm it. |
| Door re-seat time | 30 to 130 ms (10 ms steps) | 50 ms | Advanced per-trap setting. Leave it at 50 ms if the door consistently finishes under the fixed bar. An incorrect value can prevent EDC recovery or leave the door effectively unlocked. If calibration is needed, use an empty trap and change one 10 ms step at a time. Needs firmware v2.3.2-1010+. |
| Actuator Inverse | On/Off | Off | Reverses the door motor drive direction. Turn On if your motor is going the wrong way and the door opens when it should close. |
| Metric units in trap alerts | On/Off | Off | Alert messages from this trap use metric units. It does not change the units you see in the app. Set those with Units in your account settings. See Units. |
Image Cropping Settings
These settings remove portions of the image before processing. Values are percentages of the image dimension.
| Setting | Range | Default | Description |
|---|---|---|---|
| Left Crop | 0 to 50% | 0% | Removes left portion of image |
| Right Crop | 0 to 50% | 0% | Removes right portion of image |
| Top Crop | 0 to 50% | 0% | Removes top portion of image |
| Bottom Crop | 0 to 50% | 0% | Removes bottom portion of image |
Enhanced door closing and Door re-seat time
Enhanced Door Closing re-seats the door after every close, including closes on a capture. The door backs off slightly, then drives closed again to seat under the locking rod. This improves the chance the door locks. It does not confirm the lock. Enabled by default. Turn it off only if support asks. See Enhanced door closing.
Door re-seat time sets how long the door reverses during Enhanced Door Closing. A higher time reverses farther; a lower time reverses less. Options run from 30 to 130 ms in 10 ms steps. Default is 50 ms, and most traps calibrate between about 40 and 120 ms.
Advanced setting: Leave Door re-seat time at its 50 ms default if the door consistently finishes underneath the locking bar. An incorrect value can prevent EDC recovery or reverse the door too far and leave it effectively unlocked. Adjust only while calibrating an empty trap.
Every trap door is slightly different, and a fully charged battery can move the motor faster. Both too little and too much reverse can leave the door on top of the fixed locking bar:
- Door does not retract enough to re-seat: raise the value by 10 ms.
- Door retracts so far that it begins to lift and lands on top of the bar again: lower the value by 10 ms.
Start at 40 ms and change one step at a time, testing with a fully charged battery. Pass only when repeated cycles finish underneath the bar every time. See Enhanced door closing for the complete calibration and optional recovery test.
Requires trap firmware v2.3.2-1010 or newer. Older firmware ignores this setting. Only applies while Enhanced Door Closing is On. If adjusting it does not fix the door, the mechanism needs physical inspection. Contact support.
Offline alerts
| Setting | Range | Description |
|---|---|---|
| Offline alerts | On/Off | Notifies you when this trap goes offline and when it reconnects. It applies only to this trap and only to you. |
This is a notification choice, not a device setting, so it is not sent to the trap. Each person with access to the trap sets their own. The switch is labeled Offline alerts on the web app and Send offline alerts in the mobile app.
The app shows a trap as offline when it has not checked in for 30 minutes. Traps check in about every 20 minutes.
Temperature alerts
Only a trap that has neither, one that has never reported a location and never had one set, cannot check the weather. If that happens, set the location yourself and the checks begin at the next interval.
The selected interval determines how often the weather is checked.
Until the first check comes back, the card shows Not checked yet and no temperature. Checks run on a schedule rather than the moment you switch them on, so give it up to an hour to fill in.
Temperature limits use the selected unit system, shown as Imperial in the interface. Above Upper Limit sets the maximum temperature; an alert is sent if the outdoor temperature at the trap rises above this value. Below Lower Limit sets the minimum temperature; an alert is sent if the outdoor temperature at the trap falls below this value.
The high threshold, the low threshold and the check interval are trap settings, so they follow the settings lock. If the trap's owner has locked its settings, a manager cannot change them. The owner still can. A manager can still turn their own outdoor temperature alerts on or off on a locked trap, because that switch is a personal notification choice and not a trap setting.
Image cropping
Cropping adjusts how images are cropped before being processed or uploaded. Use it to remove unnecessary areas of the image, reduce file size, or focus on a specific region inside the trap.
Settings Locations
Settings are accessible in different locations:
| Location | Settings Available |
|---|---|
| Web: open a trap → Settings tab | All trap settings on one page, grouped into sections such as Offline Alerts, Battery Alerts, Weather Alerts, Camera, Image Cropping, Door, and Accessory Port. Select Save & Sync to send changes to the trap. |
| Mobile: open a trap → Settings tab → Trap settings | The same trap settings, grouped into the same kind of sections. GPS Update Interval is under General and Capture reminder is under Alerts. Tap Save & Sync to send changes to the trap. |
| Settings (account) | Notification preferences, Units, and appearance. These apply to all your traps. |
Sync status
A status line on the trap's settings shows whether the trap has your latest settings. The web app and the mobile app use the same wording.
| Status | Meaning |
|---|---|
| Synced with trap | The settings were sent, and the trap has checked in since then. |
| Sent to the trap. Not confirmed | The settings were sent. The trap applies them on its next check-in. |
| Not sent to the trap yet | No settings have been sent to this trap. |
| Syncing... | A send is in progress. |
| Sync failed | The last send did not go through. Send the settings again. |
| Never connected. Settings sync on first contact | The trap has never checked in. It gets the settings the first time it connects. |
To send the saved settings again without changing anything, select Sync now. The button is hidden while a send is in progress and while you have changes you have not saved. Use Save & Sync for those.
Values the trap cannot use
The app only offers values the trap accepts. If a change would send a value outside the trap's range, the app does not save it and tells you the range in plain words. For example: "Capture Distance must be between 6 and 18 in (150 to 460 mm)." Pick a listed value and save again.
A trap that was set up before these limits can still hold a value that is no longer on the list. The app shows that value as its own option so the picker is never blank:
- A value the trap can use is marked "(current)", or "(custom)" for a time-lapse interval. Example: "Every 45 min (custom)".
- A value the trap ignores is marked "Out of range".
If Capture Distance is out of range, a notice under the setting reads: "The trap ignores a distance outside 6 to 18 in and keeps its last setting. Pick a listed distance."
Units
There are two unit settings, and they do different things.
- Units is an account setting. It sets the distance and temperature units you see in the app. On the web app, open Settings and find Units in the Display card. In the mobile app, open Settings and turn Use metric on or off under Units & location.
- Metric units in trap alerts is a trap setting, in the General section. It only changes the units in that trap's own alert messages.
Tips for Optimal Settings
For Maximum Battery Life
- Set GPS Update Interval to Disabled if you do not need automatic location tracking
- Set Image Size to Small or Medium
- Set Camera Time Lapse to 6+ hours or disable
- Reduce Max IR Brightness if images are overexposed
For Best Image Quality
- Set Image Size to Large
- Adjust Dark Lux Threshold based on your deployment (lower = earlier IR activation)
- Fine-tune IR brightness settings for your environment
For Fastest Response
- Choose an enabled GPS Update Interval to keep the map current
- Enable Pre-Capture Alerts to see animals approaching
- Choose a shorter Capture reminder interval if monitoring actively