Awesome

google-music-webkit

Google Music desktop client via nw.js

Deprecation notice

We have deprecated google-music-webkit in favor of focusing on google-music-electron.

https://github.com/twolfson/google-music-electron

Features:

Google Music as a standalone application
Tray for quick play/pause/quit and tooltip with information
Media key shortcuts

Screenshot

Requirements

nw.js>=0.11.0 or greater
npm, usually installed with node
Adobe Flash, see http://music.google.com/ for dependency information

Getting Started

In a shell, run the following commands:

# Clone the repository
git clone https://github.com/twolfson/google-music-webkit
cd google-music-webkit

# Install node modules
npm install
# npm http GET https://registry.npmjs.org/obj-extend
# npm http 304 https://registry.npmjs.org/obj-extend
# obj-extend@0.1.0 node_modules/obj-extend

# Start the application via `nw.js`
nw .

When the application has launched, it can be shown/hidden via its tray icon, .

Screenshot

Music won't play

If the music seems to attempt to load indefinitely, then there might be a codec issue. By default, nw.js does not come bundled with an MPEG decoder. To remedy the issue, follow the steps in the wiki:

https://github.com/nwjs/nw.js/wiki/Using-MP3-&-MP4-%28H.264%29-using-the--video--&--audio--tags.

Running without a terminal

For running google-music-webkit without a terminal, start via screen. Once it has launched, the terminal can be closed without exiting the application.

screen nw .

Gnome installation

If you are on Gnome/Cinnamon, you can use ./install-gnome.sh to add the application to your menu.

./install-gnome.sh
# Google Music Webkit successfully installed!

Documentation

Icons

Source images are kept in the resources/ folder. Icons are maintained via Inkscape and the play/pause buttons are isolated in layers.

To generate icons:

Export each of the play/pause/clean variants as a .svg file
Load the icons via GIMP as a 32x32 SVG
Export via GIMP as a .png

At the time of writing, Inkscape and Image Magick seemed to be generating non-transparent backgrounds upon converting SVG to PNG.

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint via grunt and test via npm test.

Donating

Support this project and others by twolfson via gittip.

Attribution

Headphones designed by Jake Dunham from the Noun Project

Modified google-music-mac source code from https://github.com/kbhomes/google-music-mac under MIT license.

Unlicense

As of May 02 2014, Todd Wolfson has released this repository and its contents to the public domain, excluding that which has been attributed to other sources.

It has been released under the UNLICENSE.