# MediaCast

**Repository Path**: yqsphp/MediaCast

## Basic Information

- **Project Name**: MediaCast
- **Description**: 媒体投屏器是一款基于 Python 和 PyQt5 开发的高性能媒体投屏工具，支持将本地音视频文件通过 DLNA/UPnP 协议投屏到智能电视、投影仪等设备。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.yqsphp.top/home
- **GVP Project**: No

## Statistics

- **Stars**: 43
- **Forks**: 11
- **Created**: 2026-01-12
- **Last Updated**: 2026-06-19

## Categories & Tags

**Categories**: multimedia

**Tags**: Python, 投屏, window应用程序

## README

# Media Caster
## Statement
   This project is open-sourced for educational purposes only. It shall not be used for any illegal activities or monetary transactions. Users shall bear all consequences arising from the use of this software. Please attribute the source if you redistribute or modify the code. We welcome forks, issues, and contributions.
## 🌟 brief introduction
   I was supposed to look for a media projection software that runs on Windows to cast the media (largely including MP3s and videos) from the computer to a projector, but I was disappointed after struggling to find and research some software that needs verification codes, point-to-point connection, and installing on both ends — while a massive number of nice software that can perform similar functions runs on Android. Therefore, I have written this program with the help of AI, and it is capable enough for my satisfaction.
   Media Cast is a high-performance media casting tool developed with Python and PyQt5. It supports streaming local audio and video files to compatible devices, such as smart TVs and projectors, via the DLNA/UPnP protocol.

##  ✨   Key Features:

        🎯 One-Click Casting: Cast any media file to your big screen in just three simple steps.

        📱 Automatic Device Discovery: Instantly find and list all available casting devices on your local network.

        ⚡ High-Performance Streaming: Its built-in HTTP server delivers a lightweight and efficient streaming experience for smooth, buffer-free playback.


 ##   Primary Functionalities

    Device Discovery: Automatically scans for DLNA/UPnP devices on the local network.

    File Browser: Supports browsing and selecting multiple audio and video formats.

    Casting Controller: Provides playback controls including Play, Pause, Stop, Volume Adjustment, and Playback Speed.

    Volume Adjustment: Features slider control and a mute toggle.

## 🖥️ System Requirements

    Operating System: Windows 10/11, macOS 10.15+, Ubuntu 18.04+

    Python Version: Python 3.7 or higher

    Memory: Minimum 4GB RAM

    Network: The casting device and computer must be on the same Local Area Network (LAN).

## 🚀 Quick Start

Installation Steps:
bash

# 1. Clone the repository
git clone https://gitee.com/yqsphp/MediaCast.git
cd MediaCast

# 2. Create a virtual environment
python -m venv venv

# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

# 3. Run the application
python main.py