Peregrine Planner Help & Support

Quickstart
User Guide
FAQ
Contact

Getting Started Quickly

1. Set Your Location
Tap the location button in the action bar (shows "Set Start" or your address) to use your current location or select a custom location on the map.
2. Learn About Local Birds
Visit the Learn tab to study birds common to your area. The app shows 5 birds at a time from recent eBird observations near your location. Mark each bird as learned after studying their features, habitats, and identification tips. Complete all 5 birds to take an interactive quiz - you need 80% to advance to the next set of birds. This builds your knowledge before planning trips.
3. Choose Birds
Select birds you want to see from the list by tapping on them. You can use the search bar to filter by name or the Hotspot Browser to select birds by location. In advanced mode, you can adjust the time period to see more historical data.
4. Plan Your Trip
Set your trip duration and click "Plan My Birding Trip" to generate an optimized itinerary. The app will create the most efficient route to maximize your chances of seeing all selected birds. If you have a custom start location set, you can choose to "Start route from current location" to begin your trip from where you are now instead of the search location. New birders can use the Learn tab for step-by-step guidance.
5. Go Birding!
Use the directions to navigate to each location and check off birds as you spot them. Mark birds as seen in your trip log and add notes about your observations. Take photos using the camera icon to document your sightings.
6. AI Bird Identification & AR Features
Use the ID tab for AI-powered bird identification. Bird Sounds Detection provides real-time audio identification using Cornell BirdNET AI with configurable sensitivity and regional filtering - toggle it on to automatically detect and log birds by their calls. Bird Photo Detection analyzes your photos to identify bird species with confidence scores. **ENHANCED: AR Bird Identification** now features advanced dual-mode detection, combining both visual camera detection AND real-time audio detection for comprehensive bird identification. Grant camera and microphone permissions to begin identifying birds through your camera viewfinder. The app works with both front and back cameras and automatically switches between Expo Camera and Vision Camera for optimal compatibility. The system automatically listens for bird sounds while using the camera, creating intelligent multi-modal detections. When a bird is detected through both sight and sound simultaneously, the system creates a single fused entry rather than duplicate detections. In your trip logs, birds detected through multiple methods show both "Seen" (eye icon) and "Heard" (sound icon) labels, clearly indicating how each bird was identified. Point your camera at birds to see instant identification overlays with common names, scientific names, and confidence scores. Each bird gets a floating card that can be moved around the screen by dragging. **Interactive Features:** Tap any bird thumbnail in the overlay to open a detailed species card with full-size images, habitat information, and identification features. Use the "Dismiss" button to remove incorrect detections from the screen. The "Save to Trip" button adds the bird to your current trip log and automatically dismisses the overlay. **Enhanced Photo Capture:** Use the camera button to capture AR photos with overlays. Photos can be saved with detected species to your trip log, or saved without species to your photo library. **Manual Species Addition:** If no birds are detected, tap "Add Species" to manually select multiple species from the searchable eBird taxonomy. **Settings:** Adjust confidence thresholds from very low (0.1%) to very high (80%) to control detection sensitivity. Enable or disable bounding boxes, confidence scores, and other visual elements. Toggle battery optimization for longer sessions. All AI tools create trip logs automatically. Throughout the app, bird thumbnails from iNaturalist.org appear next to species names to help with visual identification - tap any thumbnail to see a larger image with photographer credits. Remember: AI identification is experimental and should always be validated with field guides or expert birders.
7. Bird Challenges & Gamification
Access gamified Bird Challenges through Learn > Bird Challenges to encourage real-world birding activities. Daily challenges reset at midnight and include identification tasks, sound detection goals, and photo capture objectives. Weekly challenges reset every Monday and focus on species diversity, habitat exploration, and rare bird discovery. Monthly challenges reset on the 1st of each month and include migration tracking, behavior studies, and mastery goals. Challenges automatically track your progress as you use the app - when you log birds in trip logs, use AI sound/photo detection, or mark birds as seen, your challenge progress updates in real-time. Each challenge has a point value and specific target, and you'll receive completion alerts when finished. All challenges are designed to get you outside and actively birding in different habitats.
8. Research Features: Behavior Logging & Migration Tracking
Use specialized research tools found in the ID tab for detailed scientific observations. **Behavior Logging:** Record detailed bird behaviors by selecting from 14 behavior categories including Feeding, Nesting, Social Interaction, and more. Use the built-in timer to track observation duration, add location names, note weather conditions, and include detailed descriptions. **Migration Tracking:** Document migratory bird movements by recording migration status (Actively Migrating, Staging/Resting, etc.), flock size, direction of movement, flight altitude, and environmental conditions. These research observations are stored separately from regular trip logs and contribute to monthly research challenges. Access your logs through Logs > Behavior Logs and Logs > Migration Logs to review statistics and manage your research data.
9. Log Sightings
The "Add Sighting" button in Trip Logs lets you quickly log birds encountered outside planned trips - select the birds, choose their location on an interactive map, and give the location a custom name. All sightings are automatically added to your Life List and Big Month count.
10. Tell Your Story
Create comprehensive birding journals with the Tell Your Story feature. Navigate to Trips > Trip Logs and tap "Tell Your Story" to combine trip logs, photos, and personal narratives into shareable stories. Set date ranges to filter your data, select trips and research logs to include, write personal narratives, and add extra photos. The app automatically generates species lists and behavior summaries. Export complete stories as detailed text files or share simplified versions through standard sharing interfaces.
11. Save & Share
Save your trips to access them later from Trip Logs. You can import trips created by others, or export and share your own trips via email, messaging apps, or as calendar events. Your birding statistics are tallied in your Profile screen to track your progress over time. View your photos in the Photo Gallery and track progress in the Big Month feature.

Comprehensive User Guide

Plan Screen

The Plan screen shows a list of birds observed near your current or selected location. Tap on any bird to select it for your trip plan (selected birds will be highlighted). Use the search bar to filter by name and the time filter to adjust how many days of observations to include. The main navigation includes Learn, Plan, ID, Log, and More tabs.

How to use:
1. Tap the location button in the action bar to change your location
2. Use the search bar to find specific birds by name
3. Tap the filter icon to adjust observation time periods (7, 14, or 30 days)
4. Tap any bird in the list to select it for your trip
5. Use the action bar buttons to access Species Map, Hotspots, and other features

Action Bar Navigation

The action bar on the Plan screen provides quick access to key features: Location button (Set Start/current address), Species Map button, and Hotspots button for exploring birding locations and data.

Action Bar Buttons:
• Location (Set Start): Opens location picker to set your starting location
• Species Map: Opens Species Map screen showing recent eBird data
• Hotspots: Opens the Hotspot Browser to explore birding locations

Bird Identification (ID Tab)

The ID tab contains AI-powered bird identification tools that help you identify birds you encounter in the field. These tools use advanced machine learning to analyze bird sounds and images for accurate species identification. Note: The bird database supporting these features is currently incomplete, so some species may not be recognized or may have limited information.

Bird Sounds Detection:
1. Navigate to ID → Bird Sounds Detection
2. Configure detection settings:
• Choose sensitivity level: Low (conservative), Medium (balanced), or High (detects more but may include false positives)
• Enable "Regional Species Filter" to boost confidence for local birds
3. Toggle the switch to "On" to start real-time listening
4. Grant microphone and notification permissions when prompted
5. The app uses Cornell BirdNET AI with enhanced sensitivity (3-5% confidence threshold)
6. Detected species appear in a scrollable list with:
• Common name only (no scientific names for clarity)
• Confidence percentage for each detection
• Time stamp of each detection
7. Lock screen notifications appear for each detected bird
8. Only unique species are kept (no duplicates per session)
9. Toggle "Off" to end the session
10. If birds were detected and you have active trips, choose to:
• Add birds to an existing trip location (preserves all planned stops)
• Keep as separate session trip
11. Each session creates one aggregated trip log with all detected species
12. Battery Saver automatically stops after 30 minutes of no detections
Bird Image Detection:
1. Navigate to ID → Bird Photo Detection
2. Select photos from your gallery or take new ones with the camera
3. Choose multiple photos for batch analysis
4. AI analyzes each image and provides species suggestions
5. View results grouped by species or individually by photo
6. Each detection includes confidence scoring
7. Tap "Create New Trip" to begin trip integration:
• If you have active trips, choose to add birds to existing locations
• Location picker preserves all planned hotspots
• Or create a new trip with custom location settings
8. For best results, use clear, well-lit photos with prominent birds
AR Bird Identification (Enhanced Dual-Mode):
1. Navigate to ID → AR Bird Identification
2. Grant camera AND microphone permissions when prompted
3. Tap "Start Detection" to begin dual-mode identification
4. Point your camera at birds while the system automatically listens for sounds
5. Dual-mode detection features:
• Visual camera detection for birds in viewfinder
• Real-time audio detection for bird sounds
• Fused detection when birds are both seen and heard
• Smart detection labels showing "Seen" and/or "Heard" icons
6. Each bird gets a floating card showing:
• Common name and scientific name
• Confidence percentage
• Draggable floating cards that can be moved around the screen
7. Interactive features:
• Tap bird thumbnails in overlays to open detailed species cards
• Use "Dismiss" button to remove incorrect detections from screen
• Use "Save to Trip" button to add birds to trip log and dismiss overlay
• Multiple birds can be detected with independent overlay interaction
8. Photo capture options:
• Camera button to capture AR photos with overlays
• Save with detected species to trip log or without species to photo library
• Manual species addition if no birds detected in photo
• Select multiple species from searchable eBird taxonomy
9. Advanced settings:
• Adjust confidence thresholds from very low (0.1%) to very high (80%)
• Enable/disable bounding boxes, confidence scores, and visual elements
• Toggle battery optimization for longer sessions
10. Camera management:
• Works with both front and back cameras with automatic switching
• Switches between Expo Camera and Vision Camera for optimal compatibility
• Automatic camera switching and error recovery

AI Bird ID Assistant

The AI Bird ID Assistant is an intelligent conversational AI that helps answer questions about birds, identification, behavior, habitat, and more. This advanced assistant provides detailed responses and excels at species comparisons, field mark descriptions, and complex queries about bird behavior and ecology.

How to use the AI Assistant:
1. Navigate to the Assistant tab
2. Type your question in the chat interface
3. Have natural conversations with follow-up questions
4. Ask questions like:
• "What does a Cardinal look like?"
• "What's the difference between Cooper's Hawk and Sharp-shinned Hawk?"
• "What birds are robin-sized with yellow bellies?"
• "Where do woodpeckers typically nest?"
5. Review the detailed responses with comprehensive information
6. Tap bird names in responses to see detailed species information

New Conversation Interface:
• Multiple questions and answers in a flowing conversation
• Each message appears in its own bubble for easy reading
• Bird species appear as clickable links with match percentages
• Confidence indicators show the AI's certainty level
• Full conversation history is maintained throughout your session

eBird Integration:
• When you ask about birds "near me" or "in my area" with location services enabled
• Assistant includes real-time eBird sighting data within 25km
• Shows recent observations, popular birding locations, and best places to look
• Provides information about recent birding activity in your area

Important Notes:
• AI bird identification is experimental - always verify results
• The assistant has access to comprehensive North American bird data
• Works best with specific, detailed questions
• Always cross-reference with field guides or expert birders

Trip Logs & Life List

Track your birding progress with comprehensive trip logs and automatically build your Life List as you discover new species. The "Add Sighting" button lets you quickly log birds encountered outside planned trips.

Using Trip Logs:
1. Access active and completed trips from the Trip Logs tab
2. Mark birds as seen by tapping checkboxes in your trip itinerary
3. Add notes, counts, and photos to your sightings
4. Use the floating "Add Sighting" button for quick entries outside planned trips
5. Select birds, choose location on interactive map, and give custom location names
6. All sightings automatically added to Life List and Big Month count
7. Export trips to eBird for citizen science contributions
How to use your Life List:
1. Navigate to My Trips > Life List from the bottom navigation
2. Toggle between "Birds" and "Hotspots" views at the top
3. Use the search bar to find specific species or locations
4. Apply time filters to view:
• All Time - Your complete life list
• Year - Birds seen this year
• 6 Months - Recent sightings
• 3 Months - Most recent activity
5. Tap any bird thumbnail to view detailed species information
6. Click on any bird name to see detailed sighting information
7. View statistics including rarity scores and first sighting dates
• First sighting date and location
• Number of times spotted
• Rarity indicators for significant sightings
• Your photos (if any)
• Related species you've seen
8. Navigate to original trip logs from sighting details
9. Benefit from automatic duplicate detection and removal

Learning & Progress

The Learn tab provides structured learning activities for birders of all levels, with location-based bird selection and interactive quizzes with progress tracking.

Learning Features:
• Location-based bird selection from real eBird data (5 birds at a time)
• Interactive quizzes with multiple choice questions
• Must achieve 80% to advance to next set of birds
• Progress tracking with points and streaks
• Comprehensive bird information and identification tips
• Reset option to start fresh learning journey

Bird Challenges & Gamification

Bird Challenges are gamified activities that encourage you to go birding and use the app's features in real-world situations. Access challenges through Learn > Bird Challenges to track progress and earn points.

Challenge Types:
• Daily challenges - Reset at midnight, include identification tasks and sound detection goals
• Weekly challenges - Reset Mondays, focus on species diversity and habitat exploration
• Monthly challenges - Reset on 1st, include migration tracking and behavior studies
• Automatic progress tracking through normal app usage
• Real-time updates with completion alerts and point earning
• Field-based activities encouraging exploration of different habitats

Research Features: Behavior Logging & Migration Tracking

Advanced research tools allow you to record detailed scientific observations of bird behaviors and migration patterns, contributing to monthly research challenges and scientific understanding.

Behavior Logging:
• Access through ID > Behavior Logging
• Select from 14 behavior categories (Feeding, Nesting, Social Interaction, etc.)
• Use built-in timer to track observation duration
• Add location names, weather conditions, and detailed descriptions
• View logs through Logs > Behavior Logs with comprehensive statistics
• Standalone activity independent of trip logs

Migration Tracking:
• Access through ID > Migration Tracking
• Record migration status (Actively Migrating, Staging/Resting, etc.)
• Document flock size, direction, altitude, and environmental conditions
• Choose from migratory species including waterfowl, raptors, and songbirds
• View migration statistics by season and direction
• Contributes to understanding bird movement patterns

Tell Your Story - Birding Journals

Create comprehensive journals of your birding experiences, combining trip logs, photos, and personal narratives into shareable stories perfect for documenting memorable trips and sharing with fellow birders.

Story Creation:
• Navigate to Trips > Trip Logs and tap "Tell Your Story"
• Set date ranges to filter your birding data
• Enter descriptive story titles and personal narratives
• Select trips, behavior logs, and migration logs to include
• Add additional photos beyond those in trip logs
• Automatic generation of species lists and behavior summaries
• Export as detailed text files or share simplified versions
• Story management through accessible Stories List

Bird Thumbnails & Visual Aids

Throughout the app, bird thumbnails from iNaturalist.org appear next to species names to help with visual identification. These images are cached for offline viewing and properly credited to photographers.

Thumbnail Features:
• Appear in Plan screen, Trip Plans, Trip Logs, Life List, and State Goals screens
• Tap any thumbnail to open comprehensive bird information card
• Cards include habitat, identification features, behavior, and external links
• Advanced name matching handles various bird naming conventions
• Hybrid species support for complete eBird taxonomy coverage
• Manage image downloads in More > Settings > Image Cache Management

Contact Support

Need help with Peregrine Planner? Send us a message and we'll get back to you as soon as possible.