Skip to content

Building

Build instructions for Android, iOS, and Windows.

Android

# Debug APK
flutter build apk --debug

# Release APK
flutter build apk --release

# App Bundle (for Play Store)
flutter build appbundle --release

The release APK is at build/app/outputs/flutter-apk/app-release.apk.

iOS

Requires macOS with Xcode 15+:

cd ios && pod install && cd ..
flutter build ios --release

Open ios/Runner.xcworkspace in Xcode for archive and distribution.

Windows

Requires Visual Studio 2022 with C++ desktop workload:

flutter build windows --release

Notes

  • The ONNX model (~152 MB) is bundled as a Flutter asset. APK/IPA sizes will be large.
  • ONNX Runtime native libraries are platform-specific and handled by the onnxruntime package.

Forking and Re-releasing

The Terms of Use prohibit re-releasing the app under the same name, package name, or branding. If you fork the project for your own distribution, you must change the app identity in the following places:

Android — android/app/build.gradle:

android {
    defaultConfig {
        applicationId = "com.yourorg.yourapp"   // replace de.tu_chemnitz.mi.kahst.birdnet_live
    }
}

iOS — update the bundle identifier in Xcode:
Open ios/Runner.xcworkspace → select the Runner target → Signing & Capabilities → change Bundle Identifier from com.birdnet.birdnetLive to your own identifier. Alternatively, edit PRODUCT_BUNDLE_IDENTIFIER directly in ios/Runner.xcodeproj/project.pbxproj.

Also update the app name shown to users:

  • Android: android/app/src/main/AndroidManifest.xml — android:label
  • iOS: ios/Runner/Info.plist — CFBundleDisplayName
  • Flutter: pubspec.yaml — name field (Dart package name, lowercase with underscores)