Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A cross-platform command-line tool that casts screen and media file to remote DLNA device.


dlna-cast uses ffmpeg to capture screen and audio, then convert them into HLS streams which could be served by a simple HTTP server. The HLS url will be send to the selected device via uPnP protocol and the screen will be casted to the remote device (smart TV, typically).

This tool is supposed to be cross-platform but currently I don't have a Linux or MacOS device at hand so it can only run on Windows now. It won't be hard to support other platforms though, as there is no platform specific dependencies.

HLS is chosen just because it is easy to implement. But the problem of HLS is its high latency (up to 5s or more) so it's definitely not for scenarios that require low latency (presentation for example). But as a trade-off the streaming quality exceeds a lot of software-based screen-casting solutions (Lebocast for example) that have been tested by myself, which make it pretty good to stream music or video playing on your PC to the supported TV.


pip install dlna-cast

Please ensure your Python is 3.7 or above.

Install ffmpeg

You can install ffmpeg by compiling from source code, or just download the prebuild binary from

You need to ensure the ffmpeg command can be found in the PATH environment variable, or else you need to set FFMPEG_BIN or FFMPEG_HOME to let dlna-cast know where to find the command.

dlna-cast supports reading the environment variable from .env file. You can create a .env file under the folder you are gonna run the dlna-cast command with the following content.

# or

You can also use the dotenv set command to update the .env file and use the dotenv list to check result.

dotenv set FFMPEG_HOME "D:\ffmpeg"
dotenv list

Install ScreenCapturerRecorder on Windows

Though ffmpeg is shipped with gdigrab to capture screens on Windows, its performance is terrible when frame rate is high. dlna-cast uses ScreenCapturerRecorder for the sake of performance. You need to download and install it before starting to cast.

Get Started

Before you start to stream your screen to remote devices that support DLNA protocol, you need to discover available devices in your LAN by running the following command.

dlna-cast list_dlna_devices
# You will see the output if supported devices are found

And now you can cast your screen to one of the found devices by running the following command.

dlna-cast screen --dlna_device HuaweiPro

Or you can also set DLNA_DEVICE in the .env file so that you can skip to set --dlna_device next time.

dotenv set DLNA_DEVICE HuaweiPro
dlna-cast screen

To stop casting just press Ctrl+C.


  • Support cast media file.
  • Optimize devices discover.
  • Optimize latency.
  • Cross platform support.


A cross-platform command-line tool that casts screen and media file to remote DLNA device.