picast 0.4.0

描述

picast是Python3在Raspberry Pi上编写的一个简单的WiFi显示接收器。当前状态为早期alpha。欢迎提交错误报告和贡献。

依赖关系

picast依赖于几个外部实用程序，其中一些仅在Raspbian上可用。

• tvservice（仅限raspbian）

• udhcpd（仅限debian/ubuntu）

• wpa_supplicant

• wpa_cli

• vlc

安装和运行

在Raspbian（buster或更高版本）/ Raspberry Pi Zero W/WH、RaPi 3B+、RaPi 4上运行apt install命令。

$ sudo apt install net-tools python3 udhcpd python-gst-1.0 libgtk-3-dev python3-gi python3-pip gir1.2-gtk-3.0
$ sudo apt install gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0
$ sudo apt install gstreamer1.0-plugins-good gstreamer1.0-gtk3 gstreamer1.0-plugins-rtp
$ sudo apt install gstreamer1.0-omx-rpi gstreamer1.0-omx-rpi-config vlc
$ sudo apt install --no-install-recommends lxde

$ python3 -m pip install picast
$ picast

自定义

当您想为您所在的环境进行自定义时，请将picast/settings.ini复制到您喜欢的位置并编辑它。

然后启动picast，例如如下

$ picast --config /home/pi/settings.ini

开发

建议使用virtualenv来部署开发环境。因为python3-gi模块是GTK++库的绑定库，所以使用python标准pip安装比较困难。

建议使用系统site-packages中的python3-gi库。

$ sudo apt install gstreamer1.0-tools
$ git clone https://github.com/miurahr/picast.git picast
$ cd picast
$ python3 -m venv --system-site-packages venv
$ source venv/bin/activate

然后以可编辑的开发环境方式安装picast。

$ pip install -e .

然后您可以以增加的调试级别启动。

$ picast --debug

调试日志

在/var/tmp/picast.log中有调试日志。它在logging.ini中配置。

IDE

建议使用PyCharm专业版，它具有远程部署和调试功能。

准备

增加GPU内存以解码全高清视频流。在/boot/config.txt中添加gpu_mem=128

使用方法

在目标设备上搜索名为“picast”的无线显示。使用“12345678”作为WPS PIN码。建议在源设备上启动接收器的终止。Pi连接到源设备后，其IP地址为192.168.173.80。

这些参数在settings.ini中配置。

自动启动

编辑/home/pi/.config/lxsessions/LXDE/autostart

@xscreensaver -no-splash
@lxterminal -l -e /home/pi/picast/bin/picast

已知问题

• 延迟：受所使用的RTP播放器实现限制。

• WiFi：Pi 3/Zero W的板载WiFi芯片仅支持2.4GHz。由于2.4GHz频段的拥挤性质和不稳定的rtp传输，您可能会遇到一些视频闪烁/音频卡顿。使用支持IEEE802.11ac 5GHz的Pi 3B+/4可能会更好。

• HDCP（内容保护）：Pi上既没有密钥也没有硬件，因此不支持。

许可证和版权

• 版权所有2019年Hiroshi Miura

• 版权所有2018年Hsun-Wei Cho

本程序是免费软件：您可以按照自由软件基金会发布的GNU通用公共许可证的条款重新分发和/或修改它，许可证版本为3，或（根据您的选择）许可证的任何后续版本。

本程序的发布旨在供公众使用，但不提供任何保证；甚至不提供适销性或适用于特定目的的隐含保证。有关详细信息，请参阅GNU通用公共许可证。

您应已收到此程序的GNU通用公共许可证副本。如果没有，请参阅<https://gnu.ac.cn/licenses/>。