{"id":13469252,"url":"https://github.com/muammar/mkchromecast","last_synced_at":"2025-05-15T04:03:16.508Z","repository":{"id":5925687,"uuid":"54263609","full_name":"muammar/mkchromecast","owner":"muammar","description":"Cast macOS and Linux Audio/Video to your Google Cast and Sonos Devices","archived":false,"fork":false,"pushed_at":"2024-07-01T19:55:37.000Z","size":333731,"stargazers_count":2249,"open_issues_count":212,"forks_count":136,"subscribers_count":47,"default_branch":"master","last_synced_at":"2025-04-03T11:07:11.126Z","etag":null,"topics":["alsa","audio","cast-audio","cast-videos","chromecast","chromecast-audio","debian","linux","macos","node","pychromecast","python","python3","sample-rate","sonos","sonos-speakers","soundflower","tray-menu","video"],"latest_commit_sha":null,"homepage":"http://mkchromecast.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/muammar.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-03-19T11:59:07.000Z","updated_at":"2025-04-01T19:59:25.000Z","dependencies_parsed_at":"2024-05-04T12:43:01.199Z","dependency_job_id":"d0dc5e57-e819-4347-9742-84daea3ba754","html_url":"https://github.com/muammar/mkchromecast","commit_stats":{"total_commits":1105,"total_committers":40,"mean_commits":27.625,"dds":0.06696832579185519,"last_synced_commit":"10b91bd4f88a2beb140a81c910c95694ca2de373"},"previous_names":[],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muammar%2Fmkchromecast","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muammar%2Fmkchromecast/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muammar%2Fmkchromecast/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muammar%2Fmkchromecast/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muammar","download_url":"https://codeload.github.com/muammar/mkchromecast/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248368816,"owners_count":21092460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alsa","audio","cast-audio","cast-videos","chromecast","chromecast-audio","debian","linux","macos","node","pychromecast","python","python3","sample-rate","sonos","sonos-speakers","soundflower","tray-menu","video"],"created_at":"2024-07-31T15:01:30.775Z","updated_at":"2025-04-11T09:38:40.613Z","avatar_url":"https://github.com/muammar.png","language":"Python","readme":"Looking for help!\n=================\n\nI don't have too much time recently to take care of the project. If you would be interested in helping, please comment on https://github.com/muammar/mkchromecast/issues/398\n\n\n\nMkchromecast\n============\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/muammar/mkchromecast/master/LICENSE)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/Django.svg)](https://github.com/muammar/mkchromecast/)\n[![node](https://img.shields.io/badge/node-9.3.0-yellow.svg)](https://github.com/muammar/mkchromecast/blob/master/nodejs/)\n[![Downloads](https://img.shields.io/github/downloads/muammar/mkchromecast/total.svg?maxAge=2592000?style=flat-square)](https://github.com/muammar/mkchromecast/releases)\n[![GitHub release](https://img.shields.io/github/release/muammar/mkchromecast.svg)](https://github.com/muammar/mkchromecast/releases/latest)\n\nThis is a program to cast your **macOS** audio, or **Linux** audio to your\nGoogle Cast devices or Sonos speakers. It can also [cast video files](#video).\n\nIt is written for Python3, and it can stream via `node.js`, `parec` (**Linux**),\nor `ffmpeg`.  **Mkchromecast** is capable of using lossy and lossless audio\nformats provided that `ffmpeg` or `parec` (**Linux**) are installed. It also\nsupports [Multi-room group\nplayback](https://support.google.com/chromecast/answer/6329016?hl=en), and\n [24-bit/96kHz high audio resolution](https://github.com/muammar/mkchromecast#high-quality-audio).\nAdditionally, a system tray menu is available.\n\nBy default, **Mkchromecast** streams with `node.js` (or `parec` in **Linux**)\ntogether with `mp3` audio coding format at a sample rate of `44100Hz` and\naverage bitrate of `192k`.  These defaults can be changed using the\n`--sample-rate` and `-b` flags. It is useful to modify these parameters when\nyour wireless router is not very powerful, or in the case you don't want to\ndegrade the sound quality. For more information visit the\n[wiki](https://github.com/muammar/mkchromecast/wiki/), and the\n[FAQ](https://github.com/muammar/mkchromecast/wiki/FAQ).\n\nYou can optionally install `ffmpeg` [more information\nhere](https://github.com/muammar/mkchromecast#using-the-ffmpeg-backend-with-mkchromecast-installed-from-sources)).\n**Linux** users also can configure [ALSA to capture\naudio](https://github.com/muammar/mkchromecast/wiki/ALSA).  Note that sometimes\nthe lag between playing a song and hearing may be up to 8 seconds for certain\nbackends.\n\n\nTell me more about it\n----------------------\nTo have an idea of using **Mkchromecast** from console [check this\ngif](https://github.com/muammar/mkchromecast#usage).\n\n**Mkchromecast** provides a **beta** system tray menu. It requires you to\ninstall `PyQt5`. For more information check the\n[Requirements](https://github.com/muammar/mkchromecast#requirements) and\n[Install](https://github.com/muammar/mkchromecast#install) sections.\n\nThis is what the system tray menu looks like:\n\n#### macOS\n\n[![Example](https://raw.githubusercontent.com/muammar/mkchromecast/master/images/screencast.png)](https://www.youtube.com/embed/d9Qn_LltOjU)\n\n#### Linux\n\nCheck these images:\n\n* [Gnome 1](https://raw.githubusercontent.com/muammar/mkchromecast/master/images/Gnome1.png)\n* [Gnome 2](https://raw.githubusercontent.com/muammar/mkchromecast/master/images/Gnome2.png)\n* [KDE5 1](https://raw.githubusercontent.com/muammar/mkchromecast/master/images/Kde5_1.png)\n* [KDE5 2](https://raw.githubusercontent.com/muammar/mkchromecast/master/images/Kde5_2.png)\n* [Awesome WM with Blue icons](https://raw.githubusercontent.com/muammar/mkchromecast/master/images/Awesome_BI.png)\n\n\nSonos support\n--------------\n\nIf you have Sonos speakers, you can play whatever you are listening to in your\ncomputer with **Mkchromecast**. To add Sonos support, install the `soco` python\nmodule:\n\n```\npip3 install soco\n```\n\nContribute\n----------\n\nIf you want to contribute, you can help by [reporting\nissues](https://github.com/muammar/mkchromecast/issues) or by [creating pull\nrequests](https://github.com/muammar/mkchromecast/pulls) with your\ndevelopments/improvements. If your case is the latter, visit\n[Development](https://github.com/muammar/mkchromecast/wiki/development) section\nin the Wiki.\n\nRequirements:\n------------\n\n#### macOS\n\nIn order to use **Mkchromecast** you need the following software to stream with\n`node.js`:\n\n* Python3.\n* pychromecast.\n* psutil.\n* mutagen.\n* [BlackHole](https://github.com/ExistentialAudio/BlackHole )\n* PyQt5 (optional if you want to use the system tray menu).\n\nFor more control, you need `ffmpeg` as backend.  In that case install the\nfollowing:\n\n* flask (optional).\n* ffmpeg (optional).\n* youtube-dl (option if you plan to cast youtube URLs or [supported\n  websites](https://rg3.github.io/youtube-dl/supportedsites.html)).\n\n#### Linux\n\n* Pulseaudio.\n* Pavucontrol.\n* Python3 (if using the official debian package).\n* pychromecast.\n* psutil.\n* mutagen.\n* flask.\n* vorbis-tools.\n* sox.\n* lame.\n* flac.\n* faac.\n* ffmpeg (optional).\n* PyQt5 (optional if you want to use the system tray menu).\n* youtube-dl (option if you plan to cast youtube URLs or [supported\n  websites](https://rg3.github.io/youtube-dl/supportedsites.html)).\n* soco (this module adds Sonos support to Mkchromecast).\n\nFor those who don't like Pulseaudio, it is possible to [cast using\nALSA](https://github.com/muammar/mkchromecast/wiki/ALSA). In that case the\nrequirements are:\n\n* alsa-base\n* alsa-utils\n* alsa-utils\n* Python3 (if using the official debian package).\n* pychromecast.\n* psutil.\n* mutagen.\n* flask.\n* vorbis-tools.\n* sox.\n* lame.\n* flac.\n* faac.\n* ffmpeg.\n* PyQt5 (optional if you want to use the system tray menu).\n* youtube-dl (option if you plan to cast youtube URLs or [supported\n  websites](https://rg3.github.io/youtube-dl/supportedsites.html)).\n* soco (this module adds Sonos support to Mkchromecast).\n\n\nInstall\n-------\n\nThere are two ways of installing this application:\n\n1. Using the [binaries](https://github.com/muammar/mkchromecast#binaries).\n2. From [sources](https://github.com/muammar/mkchromecast#from-sources).\n\n#### Binaries\n\n##### macOS\n\nThere is a standalone application for **macOS** users. You need to drag it to your\n`/Applications/` folder.\n\n[Download the latest dmg\nhere](https://github.com/muammar/mkchromecast/releases/latest/).\nYou need also to [install\nBlackHole](https://github.com/muammar/mkchromecast#BlackHole-macos-users-only).\n\n###### Homebrew Cask\n\nIf you are using homebrew,  it is possible to install the binary as follows:\n\n```\nbrew install --cask mkchromecast\n```\n\nIf you find any problem with the application, please [report it\nhere](https://github.com/muammar/mkchromecast/issues).\n\n##### Linux\n\n* Debian (.deb): [https://packages.debian.org/mkchromecast](https://packages.debian.org/mkchromecast).\n* Ubuntu (.deb): [http://packages.ubuntu.com/search?keywords=mkchromecast](http://packages.ubuntu.com/search?keywords=mkchromecast).\n\n**Mkchromecast** is available in the [official Debian\nrepositories](https://packages.debian.org/mkchromecast). To install\nit, just do:\n\n```\napt install mkchromecast\n```\n\nDownload the latest [deb package\nhere](https://github.com/muammar/mkchromecast/releases/), and install it as\nfollows:\n\n```\nsudo apt -f install ./mkchromecast_$VERSION_all.deb\n```\n\nwhere `$VERSION = X.Y.Z-Rev`, _e.g._: `0.2.6-1`.\n\nThis should work in Debian Unstable and Testing. I would appreciate Ubuntu\ntesters as well. If you find any problems, please [report it\nhere](https://github.com/muammar/mkchromecast/issues).\n\nIf you experience other problems related to dependencies, please [discuss them\nhere](https://github.com/muammar/mkchromecast/issues/9) or open a new issue.\n\nAdditionally, there are two dependency packages for pulling pulseaudio or ALSA\ndependencies:\n\n```\napt-get install mkchromecast-alsa (ALSA users)\n```\n\nor\n\n```\napt-get install mkchromecast-pulseaudio (Pulseaudio users)\n```\n\n#### From sources\n\nTo install **Mkchromecast**, clone this repository:\n\n```\ngit clone https://github.com/muammar/mkchromecast.git --depth 1\n```\n\nOr you may download one of the [stable releases\nhere](https://github.com/muammar/mkchromecast/releases), and unzip the file.\n\n##### Arch Linux\n\nMkchromecast is available at the AUR :\n- Release version: [https://aur.archlinux.org/packages/mkchromecast/](https://aur.archlinux.org/packages/mkchromecast/).\n- Development version: [https://aur.archlinux.org/packages/mkchromecast-git/](https://aur.archlinux.org/packages/mkchromecast-git/).\n\n```bash\n#install with aurman\naurman -S mkchromecast\n```\n\n```bash\n#install with aurutils\naur sync mkchromecast\n```\n\nIf you get the error `cannot import name 'DependencyWarning'` in Arch Linux,\nplease check issue [#31](https://github.com/muammar/mkchromecast/issues/31).\n\n##### Python\n\nTo install python requirements use the `requirements.txt` file shipped in\nthis repository:\n\n```\npip install -r requirements.txt\n```\n\n**Note**: if this step fails, maybe you need to run the installation with\n`sudo` as shown below. However, before installing using this method verify why\na regular user cannot install these requirements.\n\n```\nsudo pip install -r requirements.txt\n```\n\n**Linux** users can try to install these python requirements using the package\nmanagers coming with their distributions.\n\nExample for Debian based distros:\n\n```\nsudo 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\n```\n\n**Note**: if `python3-pychromecast` is not available in your repository,\nfollow instructions in [#9](https://github.com/muammar/mkchromecast/issues/9).\n\n##### BlackHole (macOS users only)\n\nFor installing BlackHole you can check\n[https://github.com/ExistentialAudio/BlackHole ](https://github.com/ExistentialAudio/BlackHole)\nand just download the [latest dmg\nfile](https://github.com/ExistentialAudio/BlackHole/releases).\n\nIf you have [Homebrew](http://brew.sh/) you can use [brew\ncask](https://caskroom.github.io/) as follows:\n\n```\nbrew install --cask blackhole\n```\n\nBy default, the sample rate in BlackHole is set to `44100Hz`. If you desire\nto stream at higher sample rates follow the [instructions in the\nwiki](https://github.com/muammar/mkchromecast/wiki/Sample-rates).\n\n**Note**: re-sampling to higher sample rates is not a good idea. It was indeed\nan issue in chromecast audio devices. See [this thread](https://goo.gl/yNVODZ).\nTherefore, if you want to go beyond `44100Hz` you have to [capture the sound at\na higher sample rate](https://github.com/muammar/mkchromecast/wiki/Sample-rates).\n\n##### ffmpeg\n\nThe easiest way of installing `ffmpeg` is using a package manager, *e.g.*: brew,\nmacports or fink. Or in the case of **Linux**, *e.g.*: apt, yum, or pacman.\n\n###### macOS\n\nI will briefly describe the case of Homebrew here. First, you will need\nHomebrew installed in your machine:\n\n```\n/usr/bin/ruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"\n```\n\nOnce Homebrew is ready, you can install `ffmpeg`.  As stated in the [ffmpeg\nwebsite](https://trac.ffmpeg.org/wiki/CompilationGuide/MacOSX), and for being\nable to use all audio coding formats in **Mkchromecast**, it is better to\ninstall `ffmpeg` with the following options enabled:\n\n```\nbrew install ffmpeg --with-fdk-aac --with-tools --with-freetype --with-libass --with-libvorbis --with-libvpx --with-x265 --with-opus\n```\n\n###### Linux\n\nAs I use Debian, the way of installing `ffmpeg` is:\n\n```\napt-get install ffmpeg\n```\n\n**Audio coding formats available with `parec` and `ffmpeg` backends**\n\n**Audio coding format** | **Description**                   | **Notes**\n------------------------| ----------------------------------|------------------\n  `mp3`                 | MPEG Audio Layer III (default)    | Lossy compression format (default bitrate: 192k)\n  `ogg`                 | Ogg Vorbis                        | Lossy compression format (default bitrate: 192k)\n  `aac`                 | Advanced Audio Coding (AAC)       | Lossy compression format (default bitrate: 192k)\n  `opus`                | Opus                              | Lossy compression format (default bitrate: 192k)\n  `wav`                 | Waveform Audio File Format        | Lossless format (HQ sound)\n  `flac`                | Free Lossless Audio Codec         | Lossless format (HQ sound)\n\n\n##### PyQt5\n\nThese Python bindings are needed if you intend to use the system tray menu.\nSometimes `pip` is able to install `PyQt5` and`pip install pyqt5` is enough.\n\nIf this does not work for you, I suggest you to install it using a package\nmanager.\n\n###### macOS\n\nExample with Homebrew:\n\n```\nbrew install pyqt5 --with-python3\n```\n\n###### Linux\n\n* **Debian**\n\n```\napt-get install python3-pyqt5\n```\n\nor if you desire it you can do it yourself from the sources.\n\n\nUpdating\n--------\n\nTo update **Mkchromecast** sources, just get into the cloned directory and:\n\n```\ngit pull\n```\n\nor if you prefer it, you can just pass the `--update` argument to\n**Mkchromecast**:\n\n```\nbin/mkchromecast --update\n```\n\nIf you are using the **macOS** application:\n\n1. Click on `Check For Updates`.\n2. If there are new versions, you will be prompted to [download the latest\n   dmg](https://github.com/muammar/mkchromecast/releases/latest).\n3. Replace the `mkchromecast.app` in your `/Applications/` directory.\n\n**Linux** users need to either perform a `apt-get upgrade` or [download the\nlatest deb here](https://github.com/muammar/mkchromecast/releases/), and `dpkg\n-i mkchromecast_$VERSION_all.deb`.\n\n\nUsage\n-----\n\n#### Audio\n\nGet into the cloned **Mkchromecast** directory and execute:\n\n```\nbin/mkchromecast\n```\n\nThis will launch **Mkchromecast** using `node.js` (or `parec` for **Linux**\nusers), and will do the streaming part together with the `mp3` audio coding\nformat.  `node.js` works decently but the server may tend to _fail_ under certain\ncircumstances. In such a case, **Mkchromecast** is able to restart the\n_streaming/casting_ process automatically. So, some hiccups are expected.\n\n**Note**: most of the steps described herein are the same for **macOS** and **Linux**\nusers. However, if you launch the command above in **Linux**, the process is\nless automatized.  In **Linux**, you need to select with `pavucontrol` the sink\ncalled `Mkchromecast` to stream unless you are using [ALSA](https://github.com/muammar/mkchromecast/wiki/ALSA).\nSee the [wiki for more information](https://github.com/muammar/mkchromecast/wiki/Linux). tl;dr?, just\ncheck the gif below.\n\n![Example of using mkchromecast](https://raw.githubusercontent.com/muammar/mkchromecast/master/images/mkchromecast_linux.gif)\n\n**Note**: the cast process is independent from the selection of the pulseaudio\nsink. This means that **Mkchromecast** will tell the cast device to listen your\ncomputer but no sound will be heard until you select the sink. For ALSA users, this\ndoes not apply.\n\n##### Using the `ffmpeg` backend with **Mkchromecast** installed from sources\n\nBelow an example using `mp3`:\n\n```\nbin/mkchromecast --encoder-backend ffmpeg\n```\n\nWith `ffmpeg` you can modify the codec:\n\n```\nbin/mkchromecast --encoder-backend ffmpeg -c aac\n```\n\nchange the bitrate and sample rate:\n\n```\nbin/mkchromecast --encoder-backend ffmpeg -c mp3 -b 128 --sample-rate 31000\n```\n\ncheck the section [BlackHole (macOS users\nonly)](https://github.com/muammar/mkchromecast#BlackHole-macos-users-only)\nfor more about sample rates.\n\nYou also can set the host ip manually which is a useful option when having more\nthan one active network connection or when the automatically ip detection fails:\n\n```\nbin/mkchromecast --host 192.168.1.1\n```\n\n##### Other examples with **Mkchromecast** installed using the debian package\n\nTo cast using `parec` and `wav` audio coding format:\n```\nmkchromecast -c wav\n```\n\nThere is also an option to change the `bitrate`, and in this case with `ffmpeg`:\n\n```\nmkchromecast --encoder-backend ffmpeg -c ogg -b 128\n```\n\nand another one to change the sampling rate:\n\n```\nmkchromecast --encoder-backend ffmpeg -c ogg -b 128 --sample-rate 48000\n```\n\n##### Using **Mkchromecast** from the system tray\n\nTo launch it:\n\n```\nbin/mkchromecast -t\n```\nor\n\n```\nmkchromecast -t\n```\n\nThe system tray application can perform all the actions from the aforementioned\ncommands. To get an idea, please check the [Youtube video\nhere](https://github.com/muammar/mkchromecast#macos).\n\n#### Playing Youtube URLs in Google Cast devices\n\nYou can play Youtube URLs (or [other\nsites](https://rg3.github.io/youtube-dl/supportedsites.html) headlessly from\nthe command line:\n\n```\nbin/mkchromecast -y https://www.youtube.com/watch\\?v\\=NVvAJhZVBT\n```\n\nTo use this function, you need to install `youtube-dl`. In macOS, this can be\ndone with homebrew: `brew install youtube-dl`. In Debian based distros:\n`apt-get install youtube-dl`.\n\n**Note**: you may need to enclose the URL between quotation marks, and only\nURLs over `https` are supported.\n\n#### Playing source URLs in Google Cast devices\n\nYou can play any source URLs headlessly from the command line:\n\n```\nbin/mkchromecast --source-url SOURCE_URL\n```\n\nThis option is useful for:\n\n1. Casting using MPD in the case you have already a `http` streaming source.\n2. Casting a radio station. A list of stations to try: https://ponyvillefm.com/servers\n\nExample:\n\n```\nbin/mkchromecast --source-url http://192.99.131.205:8000/pvfm1.ogg -c ogg --control\n\n```\n\nAs it can be seen above, **the codec has to be specified with the `-c` flag**.\n\n**Note**: `.m3u` or `.pls` are not yet supported.\n\n#### Controlling the Google Cast's volume and pause/resume options\n\nYou can control the volume of your Google Cast device by launching\n**Mkchromecast** with the option `--control`:\n\n```\nbin/mkchromecast --encoder-backend ffmpeg -c ogg -b 320 --control\n```\n\nThis will allow you to press \u003ckbd\u003eu\u003c/kbd\u003e and \u003ckbd\u003ed\u003c/kbd\u003e keys for `volume up`\nand `volume down` respectively.\n\nThe system tray has a window with a volume slider to do `volume up` and `volume down`.\n\n#### High quality audio\n\n**Mkchromecast** lets you cast using `24-bit/96kHz` high audio resolution. This\nis the *maximum chromecast audio capability*. The supported codecs are: `wav`\nand `flac`. In spite of the fact that `aac` can use `96000Hz` sample rate, the\nbitrate corresponds to that of a lossy data compression format. Therefore, the\nfollowing combinations can achieve this `24-bit/96kHz` capability:\n\n* `wav` + `96000Hz` sample rate.\n* `flac` + `96000Hz` sample rate.\n\nReferences:\n* [#11](https://github.com/muammar/mkchromecast/issues/11).\n* [Lossless formats](https://github.com/muammar/mkchromecast/wiki/Audio-Quality#lossless-formats).\n\n\n#### Video\n\nYou can now cast videos to your Google cast using **Mkchromecast**. This feature works both with `node`\nand `ffmpeg` backends and from command line. In the future, they may be a graphical interface\nfor this process. [See this project](https://github.com/muammar/mkchromecast/projects/1).\n\n* Cast a file from your computer to your chromecast:\n\n```\nbin/mkchromecast --video -i \"/path/to/file.mp4\"\n```\n\n```\nbin/mkchromecast --video -i \"/path/to/file.mp4\" --encoder-backend node\n```\n\n**Note**: the format of the file can be whatever is supported by `ffmpeg` and not exclusively mp4.\n\n* Subtitles\n\n```\nbin/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\n```\n\n* Set the resolution\n\n```\nbin/mkchromecast --video --resolution 4k -i /path/to/myvideo.something --subtitles /path/to/my.srt\n```\n\n* Cast from a source url:\n\n```\nbin/mkchromecast --source-url http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4 -c mp4 --volume --video\n```\n\n* Youtube Video\n\n```\nbin/mkchromecast -y https://www.youtube.com/watch\\?v\\=VuMBaAZn3II --video\n```\n\n\nKilling the application\n-----------------------\n\nTo kill **Mkchromecast** when you run it from console, just press\n\u003ckbd\u003eCtrl-C\u003c/kbd\u003e or \u003ckbd\u003eq\u003c/kbd\u003e key to quit (when `--control` flag is passed).\n\nWhen launching from system tray, use the `Quit` button in the system tray.\n\n\nMore help\n---------\n\nTo get more help:\n\n```\nbin/mkchromecast -h\n```\n\nor when installing the debian package:\n\n```\nmkchromecast -h\n```\n\nKnown issues\n------------\n##### General\n\n* **Mkchromecast**'s versions lower than 0.3.7 cannot operate with newer\n  versions of pychromecast.\n* When casting videos using the `node` backend, it is not possible to\n  use neither the `--subtitle` nor the `--seek` flags.\n* When casting to Sonos the only codecs supported are: `mp3`, and `aac`.\n  I won't give `wma` support. Apparently there is a way to play `wav`, and\n  `ogg` that I will try to implement later.\n\n##### macOS\n\n* **Mkchromecast** v0.3.6 cannot connect to selected chromecast when there are\n  more than one available. In that case, you need to use the application from\n  sources or build the application as shown\n  [here](https://github.com/muammar/mkchromecast/wiki/macOS-standalone-app).\n\n##### Linux\n\n* When using `parec` and `lame` encoder, the delay between audio played and\n  listened can be up to 8 seconds. I suggest you to use something different\n  than mp3.\n\nYou can also check the [FAQ](https://github.com/muammar/mkchromecast/wiki/FAQ)\nfor more information.\n\n\nTODO\n----\n\n* Verify all exceptions when the system tray menu fails.\n* **Sonos**: add support to different available flags.\n* **Sonos**: add Equalizer in the controls.\n","funding_links":[],"categories":["Python","Applications","node","Programming/Comp Sci/SE Things","Python Hacks"],"sub_categories":["Podcast","📦 Podcast (7)","Sonos on Linux"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuammar%2Fmkchromecast","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuammar%2Fmkchromecast","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuammar%2Fmkchromecast/lists"}