# 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**: 37
- **Forks**: 9
- **Created**: 2026-01-12
- **Last Updated**: 2026-01-24

## Categories & Tags

**Categories**: multimedia

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

## README

# 媒体投屏器 (Media Caster)
## 程序由来
 本来想着在网上找个能在window客户运行的媒体投屏软件来把电脑上的媒体投屏到投影仪上，
 但找了多款都是必须要双端安装，还需要验证码等，点对点投屏，无语。安卓端却有一堆投屏软件 :sweat_smile: 
 然后自己通过AI辅助摸索着写了这个程序。自己也足够用了！
<p align="center">
  <img src="%E9%A2%84%E8%A7%88%E5%9B%BE.png" />
  <br>
  <em>一个优雅、高效的本地媒体投屏工具</em>
</p>

<p align="center">
  <a href="#-功能特性">功能特性</a> •
  <a href="#-快速开始">快速开始</a> 

<p align="center">
  <img src="https://img.shields.io/badge/Python-3.7+-blue.svg" alt="Python版本">
  <img src="https://img.shields.io/badge/PyQt5-5.15-green.svg" alt="PyQt5">
  <img src="https://img.shields.io/badge/License-Apache-yellow.svg" alt="许可证">
  <img src="https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg" alt="平台支持">
</p>

## 声明
该项目本着学习目的开源。请勿用于非法用途，请勿用于货币交易。一切后果由使用者承担。转载请注明，欢迎fork,lssues

## 🌟 简介

媒体投屏器是一款基于 Python 和 PyQt5 开发的高性能媒体投屏工具，支持将本地音视频文件通过 DLNA/UPnP 协议投屏到智能电视、投影仪等设备。

### 主要特点
- 🎯 **一键投屏**：简单三步完成媒体投屏
- 📱 **设备自动发现**：智能扫描局域网内的投屏设备
- ⚡ **高性能传输**：内置 HTTP 服务器，流畅播放体验

## ✨ 功能特性

### 🚀 核心功能
| 功能 | 描述 | 状态 |
|------|------|------|
| **设备发现** | 自动扫描局域网内 DLNA/UPnP 设备 | ✅ |
| **文件浏览** | 支持多种音视频格式选择 | ✅ |
| **投屏控制** | 播放、暂停、停止、音量控制、播放速度 | ✅ |
| **音量调节** | 滑块控制、静音切换 | ✅ |


### 🖥️ 系统要求
- **操作系统**: Windows 10/11, macOS 10.15+, Ubuntu 18.04+
- **Python版本**: Python 3.7 或更高版本
- **内存要求**: 最少 4GB RAM
- **网络要求**: 设备与电脑需在同一局域网

## 🚀 快速开始

### 安装方法
```bash
# 1. 克隆仓库
git clone https://gitee.com/yqsphp/MediaCast.git
cd MediaCast

# 2. 创建虚拟环境
python -m venv venv

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

# 3. 运行程序
python main.py
```