OSError: [Errno 10014] Error number -10014 occurred: 'udp://@0.0.0.0:11111' when calling get_frame_read()

[HalOsI]

I encountered an OSError when trying to capture a frame using the example code below.
The drone connects and responds correctly to command and streamon, but fails at get_frame_read().

Code used:

import cv2
from djitellopy import Tello

tello = Tello()
tello.connect()

tello.streamon()
frame_read = tello.get_frame_read()

tello.takeoff()
cv2.imwrite("picture.png", frame_read.frame)

tello.land()

Error output:

[INFO] tello.py - 129 - Tello instance was initialized. Host: '192.168.10.1'. Port: '8889'.
[INFO] tello.py - 438 - Send command: 'command'
[INFO] tello.py - 462 - Response command: 'ok'
[INFO] tello.py - 438 - Send command: 'streamon'
[INFO] tello.py - 462 - Response streamon: 'ok'
Traceback (most recent call last):
  File "c:\AProjectFile\Test_Tello_ws\test_capture.py", line 8, in <module>
    frame_read = tello.get_frame_read()
                 ^^^^^^^^^^^^^^^^^^^^^^
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\enforce_types.py", line 54, in wrapper
    return func(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\tello.py", line 421, in get_frame_read
    self.background_frame_read = BackgroundFrameRead(self, address, with_queue, max_queue_len)
                                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\tello.py", line 1049, in __init__
    self.container = av.open(self.address, timeout=(Tello.FRAME_GRAB_TIMEOUT, None))
                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "av/container/core.pyx", line 482, in av.container.core.open
    return InputContainer(_cinit_sentinel, file, format, options,
  File "av/container/core.pyx", line 298, in av.container.core.Container.__cinit__
    self.err_check(res)
  File "av/container/core.pyx", line 318, in av.container.core.Container.err_check
    return err_check(value, filename=self.name)
  File "av/error.pyx", line 424, in av.error.err_check
    raise cls(code, message, filename, log)
av.error.OSError: [Errno 10014] Error number -10014 occurred: 'udp://@0.0.0.0:11111'
Exception ignored in: <function Tello.__del__ at 0x000001F6B7174040>
Traceback (most recent call last):
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\enforce_types.py", line 54, in wrapper
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\tello.py", line 1028, in __del__
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\enforce_types.py", line 54, in wrapper
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\tello.py", line 1016, in end
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\enforce_types.py", line 54, in wrapper
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\tello.py", line 601, in streamoff
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\enforce_types.py", line 54, in wrapper
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\tello.py", line 480, in send_control_command
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\enforce_types.py", line 54, in wrapper
  File "C:\AProjectFile\Test_Tello_ws\.venv\Lib\site-packages\djitellopy\tello.py", line 436, in send_command_with_return
OSError: [WinError 6]

Environment:

[project]
requires-python = ">=3.13"
dependencies = [
    "backports-ssl-match-hostname>=3.7.0.1",
    "djitellopy>=2.5.0",
    "matplotlib>=3.10.6",
    "mss>=10.1.0",
    "numpy>=2.3.3",
    "opencv-python>=4.11.0.86",
    "pillow>=11.3.0",
    "pynput>=1.8.1",
    "python-dotenv>=1.1.1",
    "pyyaml>=6.0.2",
]

[M4GNV5]

What packet manager are you using? Your dependencies list opencv and numpy but not av. The error you are getting seems to be a windows related error happening inside the av library.

According to the microsoft docs the errno 10014 is a WSAEFAULT and seems to be a very low level problem which is definitly not caused by djitellopy.
You could try installing a specific version of av such as 8.0.3.

[HalOsI]

@M4GNV5
I initially used the uv package manager with Python 3.13 and PyAV 16.0.0,
but that setup didn’t work — I suspected it was an environment configuration issue.

To rule that out, I switched to conda for environment management, downgraded to Python 3.9 and PyAV 15.0.0, and ran the same example code again.

Now I’m getting a different error called: av.error.ExitError: [Errno 1414092869] Immediate exit requested: 'udp://@0.0.0.0:11111'

raise TelloException('Failed to grab video frames from video stream') djitellopy.tello.TelloException: Failed to grab video frames from video stream

[INFO] tello.py - 129 - Tello instance was initialized. Host: '192.168.10.1'. Port: '8889'.
[INFO] tello.py - 438 - Send command: 'command'
[INFO] tello.py - 462 - Response command: 'ok'
[INFO] tello.py - 438 - Send command: 'streamon'
[INFO] tello.py - 462 - Response streamon: 'ok'
Traceback (most recent call last):
  File "C:\xxx\Roaming\Python\Python39\site-packages\djitellopy\tello.py", line 1049, in __init__
    self.container = av.open(self.address, timeout=(Tello.FRAME_GRAB_TIMEOUT, None))
  File "av/container/core.pyx", line 418, in av.container.core.open
    return InputContainer(_cinit_sentinel, file, format, options,
  File "av/container/core.pyx", line 283, in av.container.core.Container.__cinit__
    self.err_check(res)
  File "av/container/core.pyx", line 303, in av.container.core.Container.err_check
    return err_check(value, filename=self.name)
  File "av/error.pyx", line 424, in av.error.err_check
    raise cls(code, message, filename, log)
av.error.ExitError: [Errno 1414092869] Immediate exit requested: 'udp://@0.0.0.0:11111'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "C:\AProjectFile\tello_ws\test_capture.py", line 26, in <module>
    frame_read = tello.get_frame_read()
  File "C:\xxx\Roaming\Python\Python39\site-packages\djitellopy\enforce_types.py", line 54, in wrapper
    return func(*args, **kwargs)
  File "C:\xxx\Roaming\Python\Python39\site-packages\djitellopy\tello.py", line 421, in get_frame_read
    self.background_frame_read = BackgroundFrameRead(self, address, with_queue, max_queue_len)
  File "C:\xxx\Roaming\Python\Python39\site-packages\djitellopy\tello.py", line 1051, in __init__
    raise TelloException('Failed to grab video frames from video stream')
djitellopy.tello.TelloException: Failed to grab video frames from video stream
[INFO] tello.py - 438 - Send command: 'streamoff'

So far I’ve confirmed that:
The drone connects successfully and responds to command and streamon.
Wi-Fi is connected directly to the Tello network. Could you please help me with this error?

[arnav918]

@HalOsI @M4GNV5
Hi HalOsl, i’ve got the exact same problem as your first comment. i also tried switching to anaconda which didn’t help. did you find a solution to this problem? any help would be greatly appreciated

[Heimao-c]

@HalOsI @M4GNV5 Hi HalOsl, i’ve got the exact same problem as your first comment. i also tried switching to anaconda which didn’t help. did you find a solution to this problem? any help would be greatly appreciated

I think we may have the same issue, the issue I had was that the display port was occupied when receiving video streams, and I solved it with av10.0.0.

[Chang-He-End]

@HalOsI @M4GNV5 Hi HalOsl, i’ve got the exact same problem as your first comment. i also tried switching to anaconda which didn’t help. did you find a solution to this problem? any help would be greatly appreciated

I think we may have the same issue, the issue I had was that the display port was occupied when receiving video streams, and I solved it with av10.0.0.

Hi, I'm having exactly the same error. Besides the av 10.0.0 library, what other libraries did you install? What's your system version? Ubuntu 20.04 or Win 10. This would be very helpful for me. Thank you very much!