Skip to content

Commit 5cadc6f

Browse files
committed
Release 0.1.9. Now it is possible to control the volume of the Google cast
device.
1 parent c8ff104 commit 5cadc6f

File tree

2 files changed

+32
-17
lines changed

2 files changed

+32
-17
lines changed

README.md

+29-14
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ In order to use **mkchromecast** you need the following software to stream with
3636
* [Soundflower](https://github.com/mattingalls/Soundflower/).
3737
* PyQt5 (optional if you want to use the system tray menu).
3838

39-
If you want more control, you may want to use `ffmpeg` as backend. In that case
39+
For more control, you may want to use `ffmpeg` as backend. In that case
4040
you need the following:
4141

4242
* flask (optional).
@@ -62,7 +62,7 @@ this repository:
6262
pip install -r requirements.txt
6363
```
6464

65-
**Note**: if this step fails, maybe you will need to run the installation with
65+
**Note**: if this step fails, maybe you need to run the installation with
6666
`sudo` as shown below. However, before installing using this method verify why
6767
a regular user cannot install the requirements.
6868

@@ -75,7 +75,7 @@ sudo pip install -r requirements.txt
7575
For Soundflower you can check
7676
[https://github.com/mattingalls/Soundflower/](https://github.com/mattingalls/Soundflower/)
7777
or if you have [Homebrew](http://brew.sh/) you can use [brew
78-
cask](https://caskroom.github.io/) to install it as follows:
78+
cask](https://caskroom.github.io/) as follows:
7979

8080
```
8181
brew cask install soundflower
@@ -85,15 +85,20 @@ Or just download the [latest dmg
8585
file](https://github.com/mattingalls/Soundflower/releases).
8686

8787
By default, the sample rate in Soundflower is set to `44100Hz`. If you desire
88-
to stream at higher sample rates follow the [instructions in the wiki here](https://github.com/muammar/mkchromecast/wiki/Soundflower).
88+
to stream at higher sample rates follow the [instructions in the wiki](https://github.com/muammar/mkchromecast/wiki/Soundflower).
89+
90+
**Note**: resampling to higher sample rates is not a good idea. It was indeed
91+
an issue in the chromecast audio. See [this thread](https://goo.gl/yNVODZ).
92+
Therefore, if you want to go beyond `44100Hz` you have to [capture the sound at
93+
a higher sample rate](https://github.com/muammar/mkchromecast/wiki/Soundflower).
8994

9095
#### ffmpeg
9196

9297
The easiest way of installing `ffmpeg` is using a package manager, *e.g.*: brew,
9398
macports or fink.
9499

95-
I will briefly describe the case of Homebrew here. First, you will need to
96-
install Homebrew:
100+
I will briefly describe the case of Homebrew here. First, you will need
101+
Homebrew:
97102

98103
```
99104
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
@@ -124,16 +129,25 @@ Example using wav:
124129
python mkchromecast.py --encoder-backend ffmpeg -c wav
125130
```
126131

127-
There is also an option to change the `bitrate`. See example below:
132+
There is also an option to change the `bitrate`:
128133

129134
```
130135
python mkchromecast.py --encoder-backend ffmpeg -c ogg -b 128
131136
```
132137

138+
and another one to change the sampling rate:
139+
140+
```
141+
python mkchromecast.py --encoder-backend ffmpeg -c ogg -b 128 --sample-rate 48000
142+
```
143+
check [https://github.com/muammar/mkchromecast#soundflower](https://github.com/muammar/mkchromecast#soundflower).
144+
133145
#### PyQt5
134146

135-
These Python bindings are needed if you intend to use the system tray menu. As
136-
previously said, I also suggest you to install it using Homebrew:
147+
These Python bindings are needed if you intend to use the system tray menu.
148+
I also suggest you to install it using a package manager.
149+
150+
Example with Homebrew:
137151

138152
```
139153
brew install pyqt5 --with-python
@@ -179,10 +193,10 @@ modify the codec:
179193
python mkchromecast.py --encoder-backend ffmpeg -c aac
180194
```
181195

182-
You can change the bitrate:
196+
change the bitrate and sample rate:
183197

184198
```
185-
python mkchromecast.py --encoder-backend ffmpeg -c mp3 -b 128
199+
python mkchromecast.py --encoder-backend ffmpeg -c mp3 -b 128 --sample-rate 31000
186200
```
187201

188202
#### Playing Youtube URLs in Google Cast TV
@@ -193,12 +207,13 @@ You can play Youtube URLs headlessly from the command line:
193207
python mkchromecast.py -y https://www.youtube.com/watch\?v\=NVvAJhZVBT
194208
```
195209

196-
**Note**: you may need to enclose the URL between quotation marks.
210+
**Note**: you may need to enclose the URL between quotation marks. This does
211+
not work in Google Cast audio.
197212

198213
#### Controlling the Google Cast volume
199214

200-
You can control the volume of your Google Cast by launching **mkchromecast**
201-
with the option `--volume`:
215+
You can control the volume of your Google Cast device by launching
216+
**mkchromecast** with the option `--volume`:
202217

203218
```
204219
python mkchromecast.py --encoder-backend ffmpeg -c ogg -b 320 --volume

changelog.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
* mkchromecast (0.1.9) **unreleased**
1+
* mkchromecast (0.1.9) **released**: 2016/04/25
22

33
- Play headless youtube URL.
4-
- Now you can control Volume up and down from mkchromecast. So, don't need
5-
of using the Android app anymore.
4+
- Now you can control volume up and down from mkchromecast. So, no need
5+
of using the Android app for thisanymore.
66

77
* mkchromecast (0.1.8.1) **released**: 2016/04/21
88

0 commit comments

Comments
 (0)