Running Birdnet-Analyzer under Linux?

[HinzundKunz]

Hello everyone.
Has anybody succeeded in running Birdnet-Analyzer under Linux/Wine? It seems to be based on Mono, so might run well under wine. I tried installing it, which finished without problems, but starting it gave the following errors:

Traceback (most recent call last):
File "main.py", line 3, in
File "birdnet_analyzer\gui_init_.py", line 8, in main
File "birdnet_analyzer\gui\utils.py", line 895, in open_window
File "", line 1360, in _find_and_load
File "", line 1331, in _find_and_load_unlocked
File "", line 935, in _load_unlocked
File "pyimod02_importers.py", line 457, in exec_module
File "webview\platforms\winforms.py", line 22, in
System.BadImageFormatException: Invalid Image: Z:\app\share\wine\mono\wine-mono-10.4.1\lib\mono\4.5\System.Windows.Forms.dll

File name: 'Z:\app\share\wine\mono\wine-mono-10.4.1\lib\mono\4.5\System.Windows.Forms.dll'

at (wrapper managed-to-native) System.Reflection.Assembly.LoadFrom(string,bool,System.Threading.StackCrawlMark&)

at System.Reflection.Assembly.LoadFrom (System.String assemblyFile) [0x00002] in <60bb7eaf44204dc583390995e42e38f8>:0

at Python.Runtime.AssemblyManager.LoadAssemblyPath (System.String name) [0x0000c] in <4c57922ba7ce4753a801bba125b62f75>:0

at Python.Runtime.CLRModule.AddReference (System.String name) [0x0001b] in <4c57922ba7ce4753a801bba125b62f75>:0

at (wrapper managed-to-native) System.Reflection.RuntimeMethodInfo.InternalInvoke(System.Reflection.RuntimeMethodInfo,object,object[],System.Exception&)

at System.Reflection.RuntimeMethodInfo.Invoke (System.Object obj, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, System.Object[] parameters, System.Globalization.CultureInfo culture) [0x0006a] in <60bb7eaf44204dc583390995e42e38f8>:0

[YCistak]

You don't need Wine at all — BirdNET-Analyzer is a Python package and runs natively on Linux. The Windows installer just bundles a Windows-only GUI backend (pywebview → WinForms), which is why Wine-Mono chokes on it.

Native install (Python 3.11+):

python -m venv ~/birdnet && source ~/birdnet/bin/activate
pip install "birdnet_analyzer[all]"
birdnet-gui        # GUI
birdnet-analyze --help   # CLI

On Linux the GUI uses GTK/WebKit through pywebview, so make sure gir1.2-webkit2-4.1 (Debian/Ubuntu) or webkit2gtk (Arch/Fedora) is installed. Docs: https://birdnet-team.github.io/BirdNET-Analyzer/installation.html

[HinzundKunz]

Thank you. I tried that, but it fails with: Found CMake: NO Run-time dependency girepository-2.0 found: NO (tried pkg-config and cmake) Not looking for a fallback subproject for the dependency girepository-2.0 because: Use of fallback dependencies is disabled. ../meson.build:35:9: ERROR: Dependency 'girepository-2.0' is required but not found. A full log can be found at /tmp/pip-install-hvvb5u3y/pygobject_6425ed7b938247fda68b8ad9f61897e9/.mesonpy-l02s7kwi/meson-logs/meson-log.txt [end of output] *note*: This error originates from a subprocess, and is likely not a problem with pip. *error*: *metadata-generation-failed* I have libgirepository-2.0-0 installed on my system (KDE Neon, based on Ubuntu 24.04 I think). Am Freitag, 11. September 2026, 13:04:39 Ostafrikanische Zeit schrieb Cistak_: You don't need Wine at all — BirdNET-Analyzer is a Python package and runs natively on Linux. The Windows installer just bundles a Windows-only GUI backend (pywebview → WinForms), which is why Wine-Mono chokes on it. Native install (Python 3.11+): python -m venv ~/birdnet && source ~/birdnet/bin/activate pip install "birdnet_analyzer[all]" birdnet-gui # GUI birdnet-analyze --help # CLI On Linux the GUI uses GTK/WebKit through pywebview, so make sure gir1.2-webkit2-4.1 (Debian/Ubuntu) or webkit2gtk (Arch/Fedora) is installed. Docs: https://birdnet-team.github.io/BirdNET-Analyzer/installation.html[1] — Reply to this email directly, view it on GitHub[2], or unsubscribe[3]. Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS[4] and Android[5]. Download it today! You are receiving this because you authored the thread.[6]Message ID: ***@***.***>

…

-------- [1] https://birdnet-team.github.io/BirdNET-Analyzer/installation.html [2] #1000?email_source=notifications&email_token=ABXGTWWHV45XLBU4PJ7VCUL5OPE3PA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBTHE4DSMBZUZZGKYLTN5XKMYLVORUG64VFMV3GK3TUVRTG633UMVZF6Y3MNFRWW#discussioncomment-18398909 [3] https://github.com/notifications/unsubscribe-auth/ABXGTWTTY6DJPFUSKH4LIZL5OPE3PAVCNFSNUABIKJSXA33TNF2G64TZHM2DAOJSGE3DANBRHNCGS43DOVZXG2LPNY5TCMBXHAYDANBZUF3AE [4] https://github.com/notifications/mobile/ios/ABXGTWURRE5FE7HEKU7GAF35OPE3PA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBTHE4DSMBZUZZGKYLTN5XKMYLVORUG64VFMV3GK3TUVJTG633UMVZF62LPOM [5] https://github.com/notifications/mobile/android/ABXGTWQGUQTH7ZY3YZGAC4L5OPE3PA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOBTHE4DSMBZUZZGKYLTN5XKMYLVORUG64VFMV3GK3TUVZTG633UMVZF6YLOMRZG62LE [6] https://github.com/notifications/beacon/ABXGTWTJKBP45EOTHJLVEQD5OPE3PBFCNFSM6AAAAAC7HFJDXOWGG33NNVSW45C7OR4XAZNRIRUXGY3VONZWS33OINXW23LFNZ2KUY3PNVWWK3TUL5UWJTQBDC7L3JTSMVQXG33OUZQXK5DIN5ZA.gif

[HinzundKunz]

Thank you, I'll try that. I actually already did, but the internet in the country I'm working in is very unstable at times, so I had multiple errors and timeouts in the process. But I'll get there sometime...

[HinzundKunz]

OK, I managed to download everything and started birdnet-gui, but got the following error:
birdnet-gui
Model found!
Traceback (most recent call last):
File "/home/martin/birdnet/bin/birdnet-gui", line 8, in
sys.exit(main())
^^^^^^
File "/home/martin/birdnet/lib/python3.12/site-packages/birdnet_analyzer/gui/init.py", line 8, in main
gu.open_window(
File "/home/martin/birdnet/lib/python3.12/site-packages/birdnet_analyzer/gui/utils.py", line 850, in open_window
map_plots.extend(build() for build in builder)
File "/home/martin/birdnet/lib/python3.12/site-packages/birdnet_analyzer/gui/utils.py", line 850, in
map_plots.extend(build() for build in builder)
^^^^^^^
File "/home/martin/birdnet/lib/python3.12/site-packages/birdnet_analyzer/gui/single_file.py", line 127, in build_single_analysis_tab
segment_audio = gr.Audio(autoplay=True, type="numpy", show_download_button=True, show_label=False, editable=False, visible=False)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/martin/birdnet/lib/python3.12/site-packages/gradio/component_meta.py", line 194, in wrapper
return fn(self, **kwargs)
^^^^^^^^^^^^^^^^^^
TypeError: Audio.init() got an unexpected keyword argument 'show_download_button'

So what's the problem here?