Logo
Project Icon

mkchromecast

跨平台音频投射工具 支持Google Cast和Sonos

Mkchromecast音频流媒体Google CastSonos开源软件Github开源项目

mkchromecast是一款开源的音频投射工具，支持将macOS和Linux设备的音频传输至Google Cast设备或Sonos音箱。该工具支持多种音频格式、高质量音频传输和多房间群组播放。mkchromecast提供命令行和系统托盘菜单两种操作方式，适合不同需求的用户。它使用简单，功能全面，是跨平台音频投射的实用选择。

访问官网访问官网GithubGithub文档文档
介绍相关项目

求助!

我最近没有太多时间照顾这个项目。如果你有兴趣提供帮助，请在 https://github.com/muammar/mkchromecast/issues/398 上留言。

Mkchromecast

[许可证] [Python版本] [node] [下载次数] [GitHub发布]

这是一个程序,可以将你的 macOS 或 Linux 音频投射到Google Cast设备或Sonos音箱。它还可以投射视频文件。

该程序使用Python3编写,可以通过 node.js、parec (Linux)或 ffmpeg 进行流媒体传输。Mkchromecast 在安装了 ffmpeg 或 parec (Linux)的情况下,可以使用有损和无损音频格式。它还支持多房间组播放和24位/96kHz高分辨率音频。此外,还提供了系统托盘菜单。

默认情况下,Mkchromecast 使用 node.js (或Linux中的 parec)以 mp3 音频编码格式,采样率为 44100Hz,平均比特率为 192k 进行流媒体传输。这些默认设置可以使用 --sample-rate 和 -b 标志进行更改。当你的无线路由器性能不是很强,或者你不想降低音质时,修改这些参数会很有用。更多信息请访问wiki和FAQ。

你可以选择安装 ffmpeg 更多信息请点击这里。Linux 用户还可以配置ALSA来捕获音频。注意,对于某些后端,播放歌曲和听到声音之间的延迟有时可能长达8秒。

告诉我更多信息

要了解如何从控制台使用 Mkchromecast,请查看这个gif。

Mkchromecast 提供了一个测试版系统托盘菜单。它需要你安装 PyQt5。更多信息请查看需求和安装部分。

系统托盘菜单看起来是这样的:

macOS

[示例]

Linux

查看这些图片:

  • [Gnome 1]
  • [Gnome 2]
  • [KDE5 1]
  • [KDE5 2]
  • [Awesome WM 蓝色图标]

Sonos 支持

如果你有Sonos音箱,你可以用 Mkchromecast 播放电脑上正在听的任何内容。要添加Sonos支持,请安装 soco Python模块:

pip3 install soco

贡献

如果你想贡献,你可以通过报告问题或创建带有你的开发/改进的拉取请求来帮助。如果你选择后者,请访问Wiki中的开发部分。

需求:

macOS

为了使用 Mkchromecast 通过 node.js 进行流媒体传输,你需要以下软件:

  • Python3
  • pychromecast
  • psutil
  • mutagen
  • [BlackHole]
  • PyQt5 (如果你想使用系统托盘菜单,则为可选)

为了获得更多控制,你需要 ffmpeg 作为后端。在这种情况下,请安装以下内容:

  • flask (可选)
  • ffmpeg (可选)
  • youtube-dl (如果你计划投射YouTube URL或支持的网站,则为可选)

Linux

  • Pulseaudio
  • Pavucontrol
  • Python3 (如果使用官方debian包)
  • pychromecast
  • psutil
  • mutagen
  • flask
  • vorbis-tools
  • sox
  • lame
  • flac
  • faac
  • ffmpeg (可选)
  • PyQt5 (如果你想使用系统托盘菜单,则为可选)
  • youtube-dl (如果你计划投射YouTube URL或支持的网站,则为可选)
  • soco (此模块为Mkchromecast添加Sonos支持)

对于不喜欢Pulseaudio的人,可以使用ALSA进行投射。在这种情况下,需求是:

  • alsa-base
  • alsa-utils
  • alsa-utils
  • Python3（如果使用官方debian软件包）
  • pychromecast
  • psutil
  • mutagen
  • flask
  • vorbis-tools
  • sox
  • lame
  • flac
  • faac
  • ffmpeg
  • PyQt5（如果希望使用系统托盘菜单，则为可选）
  • youtube-dl（如果计划投射YouTube URL或支持的网站，则为可选）
  • soco（此模块为Mkchromecast添加Sonos支持）

安装

安装此应用程序有两种方式：

  1. 使用二进制文件。
  2. 从源代码安装。

二进制文件

macOS

对于macOS用户，有一个独立的应用程序。您需要将其拖到/Applications/文件夹中。

在此下载最新的dmg文件。 您还需要安装BlackHole。

Homebrew Cask

如果您使用homebrew，可以按以下方式安装二进制文件：

brew install --cask mkchromecast

如果您在使用应用程序时遇到任何问题，请在此报告。

Linux

Mkchromecast可在官方Debian仓库中获得。要安装它，只需执行：

apt install mkchromecast

在此处下载最新的deb包，然后按以下方式安装：

sudo apt -f install ./mkchromecast_$VERSION_all.deb

其中$VERSION = X.Y.Z-Rev，例如：0.2.6-1。

这应该适用于Debian Unstable和Testing版本。我也希望有Ubuntu测试者。如果您发现任何问题，请在此报告。

如果您遇到其他与依赖项相关的问题，请在此讨论或开启一个新的问题。

此外，还有两个依赖包用于拉取pulseaudio或ALSA依赖项：

apt-get install mkchromecast-alsa （ALSA用户）

或

apt-get install mkchromecast-pulseaudio （Pulseaudio用户）

从源代码安装

要安装Mkchromecast，请克隆此仓库：

git clone https://github.com/muammar/mkchromecast.git --depth 1

或者您可以在此处下载稳定版本，并解压文件。

Arch Linux

Mkchromecast可在AUR获得：

#使用aurman安装
aurman -S mkchromecast

#使用aurutils安装
aur sync mkchromecast

如果在Arch Linux中遇到cannot import name 'DependencyWarning'错误，请查看问题#31。

Python

要安装python依赖项，请使用此仓库中提供的requirements.txt文件：

pip install -r requirements.txt

注意：如果此步骤失败，您可能需要使用sudo运行安装，如下所示。但是，在使用此方法安装之前，请验证为什么普通用户无法安装这些依赖项。

sudo pip install -r requirements.txt

Linux用户可以尝试使用其发行版附带的包管理器安装这些python依赖项。

以Debian为基础的发行版示例：

sudo apt-get install python3.6 python3-pip python3-pychromecast python3-flask python3-psutil python3-setuptools python3-mutagen python3-gi vorbis-tools sox lame flac faac opus-tools

注意：如果您的仓库中没有python3-pychromecast，请按照#9中的说明操作。

BlackHole（仅限macOS用户）

要安装BlackHole，您可以查看https://github.com/ExistentialAudio/BlackHole，并下载最新的dmg文件。

如果您有Homebrew，可以使用brew cask，如下所示：

brew install --cask blackhole

默认情况下，BlackHole中的采样率设置为44100Hz。如果您希望以更高的采样率进行流传输，请按照wiki中的说明操作。

注意：重采样到更高的采样率并不是一个好主意。这确实是Chromecast音频设备的一个问题。请参阅此讨论。因此，如果您想超过44100Hz，您必须以更高的采样率捕获声音。

ffmpeg

安装ffmpeg最简单的方法是使用包管理器，例如：brew、macports或fink。对于Linux，例如：apt、yum或pacman。

macOS

我将简要描述Homebrew的情况。首先，您需要在计算机上安装Homebrew：

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安装Homebrew后，您可以安装ffmpeg。正如ffmpeg网站所述，为了能够在Mkchromecast中使用所有音频编码格式，最好使用以下选项启用ffmpeg：

brew install ffmpeg --with-fdk-aac --with-tools --with-freetype --with-libass --with-libvorbis --with-libvpx --with-x265 --with-opus
Linux

由于我使用Debian，安装ffmpeg的方法是：

apt-get install ffmpeg

parec和ffmpeg后端可用的音频编码格式

音频编码格式描述注意
mp3MPEG音频层III (默认)有损压缩格式 (默认比特率: 192k)
oggOgg Vorbis有损压缩格式 (默认比特率: 192k)
aac高级音频编码 (AAC)有损压缩格式 (默认比特率: 192k)
opusOpus有损压缩格式 (默认比特率: 192k)
wav波形音频文件格式无损格式 (高质量音频)
flac自由无损音频编解码器无损格式 (高质量音频)
PyQt5

如果您打算使用系统托盘菜单，则需要这些Python绑定。 有时pip能够安装PyQt5，只需执行pip install pyqt5即可。

如果这对您不起作用，我建议您使用包管理器进行安装。

macOS

使用Homebrew的示例:

brew install pyqt5 --with-python3
Linux
  • Debian
apt-get install python3-pyqt5

或者如果您愿意，可以从源代码自己编译安装。

更新

要更新Mkchromecast源代码，只需进入克隆的目录并执行:

git pull

或者如果您喜欢，可以直接向Mkchromecast传递--update参数:

bin/mkchromecast --update

如果您使用的是macOS应用程序:

  1. 点击检查更新。
  2. 如果有新版本，系统会提示您下载最新的dmg文件。
  3. 替换/Applications/目录中的mkchromecast.app。

Linux用户需要执行apt-get upgrade或在此下载最新的deb包，然后执行dpkg -i mkchromecast_$VERSION_all.deb。

使用方法

音频

进入克隆的Mkchromecast目录并执行:

bin/mkchromecast

这将使用node.js（或Linux用户的parec）启动Mkchromecast，并与mp3音频编码格式一起进行流媒体传输。node.js运行良好，但在某些情况下服务器可能会_失败_。在这种情况下，Mkchromecast能够自动重启_流媒体/投射_过程。因此，可能会出现一些小问题。

注意：这里描述的大多数步骤对macOS和Linux用户都是相同的。但是，如果您在Linux上执行上述命令，该过程的自动化程度较低。在Linux中，您需要使用pavucontrol选择名为Mkchromecast的接收器进行流媒体传输，除非您使用的是ALSA。有关更多信息，请参阅wiki。太长不看？只需查看下面的GIF。

使用mkchromecast的示例

注意：投射过程与选择pulseaudio接收器无关。这意味着Mkchromecast会告诉投射设备监听您的计算机，但在您选择接收器之前不会听到声音。对于ALSA用户，这不适用。

使用从源代码安装的Mkchromecast的ffmpeg后端

以下是使用mp3的示例:

bin/mkchromecast --encoder-backend ffmpeg

使用ffmpeg，您可以修改编解码器:

bin/mkchromecast --encoder-backend ffmpeg -c aac

更改比特率和采样率:

bin/mkchromecast --encoder-backend ffmpeg -c mp3 -b 128 --sample-rate 31000

查看BlackHole（仅限macOS用户）部分，了解有关采样率的更多信息。

您还可以手动设置主机IP，这在有多个活动网络连接或自动IP检测失败时很有用:

bin/mkchromecast --host 192.168.1.1
使用debian包安装Mkchromecast的其他示例

使用parec和wav音频编码格式进行投射:

mkchromecast -c wav

还有一个选项可以更改比特率，在这种情况下使用ffmpeg:

mkchromecast --encoder-backend ffmpeg -c ogg -b 128

以及另一个更改采样率的选项:

mkchromecast --encoder-backend ffmpeg -c ogg -b 128 --sample-rate 48000
从系统托盘使用Mkchromecast

启动它:

bin/mkchromecast -t

或

mkchromecast -t

系统托盘应用程序可以执行上述命令中的所有操作。要了解具体情况，请查看此处的YouTube视频。

在Google Cast设备上播放YouTube URL

您可以从命令行无头播放YouTube URL（或其他网站）:

bin/mkchromecast -y https://www.youtube.com/watch\?v\=NVvAJhZVBT

要使用此功能，您需要安装youtube-dl。在macOS中，可以使用homebrew安装：brew install youtube-dl。在基于Debian的发行版中：apt-get install youtube-dl。

注意：您可能需要将URL用引号括起来，并且仅支持https协议的URL。

在Google Cast设备上播放源URL

您可以从命令行无头播放任何源URL:

bin/mkchromecast --source-url SOURCE_URL

此选项适用于:

  1. 在使用MPD的情况下进行投射，如果您已经有http流媒体源。
  2. 投射广播电台。可以尝试的电台列表：https://ponyvillefm.com/servers

示例:

bin/mkchromecast --source-url http://192.99.131.205:8000/pvfm1.ogg -c ogg --control

如上所示，必须使用-c标志指定编解码器。

注意：尚不支持.m3u或.pls。

控制Google Cast的音量和暂停/恢复选项

您可以通过使用--control选项启动Mkchromecast来控制Google Cast设备的音量:

bin/mkchromecast --encoder-backend ffmpeg -c ogg -b 320 --control

这将允许您按u和d键分别进行音量增大和音量减小。

系统托盘有一个带有音量滑块的窗口，用于音量增大和音量减小。

高质量音频

Mkchromecast 允许您使用 24位/96kHz 高音频分辨率进行投射。这是 Chromecast音频的最大能力。支持的编解码器有：wav 和 flac。尽管 aac 可以使用 96000Hz 采样率，但其比特率对应于有损数据压缩格式。因此，以下组合可以实现 24位/96kHz 能力：

  • wav + 96000Hz 采样率。
  • flac + 96000Hz 采样率。

参考：

视频

现在您可以使用 Mkchromecast 将视频投射到Google Cast设备。此功能适用于 node 和 ffmpeg 后端，并可从命令行使用。将来可能会有此过程的图形界面。查看此项目。

  • 从您的电脑将文件投射到Chromecast：
bin/mkchromecast --video -i "/path/to/file.mp4"

bin/mkchromecast --video -i "/path/to/file.mp4" --encoder-backend node

注意：文件格式可以是 ffmpeg 支持的任何格式，不仅限于mp4。

  • 字幕
bin/mkchromecast --video -i "/tmp/Homeland.S06E01.Fair.Game.1080p.AMZN.WEBRip.HEVC.DD5.1.x265.mkv" --subtitles /tmp/Homeland.S06E01.Fair\ Game.HDTV.x264-BATV.en.HI.srt
  • 设置分辨率
bin/mkchromecast --video --resolution 4k -i /path/to/myvideo.something --subtitles /path/to/my.srt
  • 从源URL投射：
bin/mkchromecast --source-url http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4 -c mp4 --volume --video
  • YouTube视频
bin/mkchromecast -y https://www.youtube.com/watch\?v\=VuMBaAZn3II --video

关闭应用程序

从控制台运行 Mkchromecast 时，只需按 Ctrl-C 或 q 键即可退出（当传递 --control 标志时）。

从系统托盘启动时，使用系统托盘中的 退出 按钮。

更多帮助

获取更多帮助：

bin/mkchromecast -h

或安装debian软件包时：

mkchromecast -h

已知问题

一般
  • Mkchromecast 0.3.7以下版本无法与较新版本的pychromecast一起使用。
  • 使用 node 后端投射视频时，无法使用 --subtitle 或 --seek 标志。
  • 投射到Sonos时，唯一支持的编解码器是：mp3 和 aac。我不会提供 wma 支持。似乎有办法播放 wav 和 ogg，我将在以后尝试实现。
macOS
  • Mkchromecast v0.3.6在有多个可用Chromecast时无法连接到所选Chromecast。在这种情况下，您需要从源代码使用应用程序或按照此处所示构建应用程序。
Linux
  • 使用 parec 和 lame 编码器时，播放的音频和听到的音频之间的延迟可能长达8秒。我建议您使用mp3以外的格式。

您也可以查看FAQ获取更多信息。

待办事项

  • 验证系统托盘菜单失败时的所有异常。
  • Sonos：添加对不同可用标志的支持。
  • Sonos：在控制中添加均衡器。
相关项目
项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手，通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能，支持100+编程语言，与主流编辑器无缝集成，显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台，能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐，Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案，通过智能技术简化视频制作流程。无论是企业宣传还是个人分享，有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持，能够阅读和理解用户上传的文件内容，解析网页信息，并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题，Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术，为商家提供一键生成商品图和营销文案的服务，显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台，让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型，免费访问各种图像生成与AI训练工具，从Stable Diffusion等基础模型开始，轻松实现创新图像生成。体验前沿的AI技术，推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器，它将改变您观看视频的方式！SubCat结合了先进的人工智能技术，为您提供即时视频字幕翻译，无论是本地视频还是网络流媒体，让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台，利用前沿AI技术，为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图，再到文案生成，美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具，简化了选题、文献检索至论文撰写的整个过程。通过简单设定，平台可快速生成高质量论文大纲和全文，配合图表、参考文献等一应俱全，同时提供开题报告和答辩PPT等增值服务，保障数据安全，有效提升写作效率和论文质量。

使用协议隐私政策广告服务
投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号