{"id":13797889,"url":"https://github.com/twolfson/google-music-electron","last_synced_at":"2025-10-02T14:32:01.047Z","repository":{"id":32165239,"uuid":"35738454","full_name":"twolfson/google-music-electron","owner":"twolfson","description":"Desktop app for Google Music on top of Electron","archived":true,"fork":false,"pushed_at":"2019-12-31T07:40:14.000Z","size":1839,"stargazers_count":263,"open_issues_count":10,"forks_count":40,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-09-25T00:33:11.322Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/twolfson.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"custom":"https://twolfson.com/support-me"}},"created_at":"2015-05-16T20:07:46.000Z","updated_at":"2024-09-24T22:03:21.000Z","dependencies_parsed_at":"2022-09-04T23:10:40.289Z","dependency_job_id":null,"html_url":"https://github.com/twolfson/google-music-electron","commit_stats":null,"previous_names":[],"tags_count":62,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twolfson%2Fgoogle-music-electron","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twolfson%2Fgoogle-music-electron/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twolfson%2Fgoogle-music-electron/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twolfson%2Fgoogle-music-electron/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/twolfson","download_url":"https://codeload.github.com/twolfson/google-music-electron/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219875714,"owners_count":16554705,"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":[],"created_at":"2024-08-04T00:00:35.775Z","updated_at":"2025-10-02T14:31:55.758Z","avatar_url":"https://github.com/twolfson.png","language":"JavaScript","funding_links":["https://twolfson.com/support-me"],"categories":["Apps"],"sub_categories":["Video/Music","Open Source"],"readme":"# google-music-electron [![Build status](https://travis-ci.org/twolfson/google-music-electron.png?branch=master)](https://travis-ci.org/twolfson/google-music-electron)\n\nDesktop app for [Google Music][] on top of [Electron][]\n\n**Features:**\n\n- Google Music as a standalone application\n- Tray for quick play/pause/quit and tooltip with information\n- Media key shortcuts\n- MPRIS integration (for GNU/Linux desktop environments)\n\n![Screenshot](docs/screenshot.png)\n\nThis was written as a successsor to [google-music-webkit][]. When upgrading between versions of [nw.js][], there were regressions with taskbar and shortcut bindings. We wrote this as an alternative.\n\n[Google Music]: https://play.google.com/music/listen\n[Electron]: http://electron.atom.io/\n[google-music-webkit]: https://github.com/twolfson/google-music-webkit\n[nw.js]: https://github.com/nwjs/nw.js\n\n## Requirements\n- [npm][], usually installed with [node][]\n\n[npm]: http://npmjs.org/\n[node]: http://nodejs.org/\n\n## Getting Started\n`google-music-electron` can be installed globally via `npm`:\n\n```js\n# Install google-music-electron via npm\nnpm install -g google-music-electron\n\n# Run google-music-electron\ngoogle-music-electron\n```\n\nWhen the application has launched, it will appear in your taskbar and via a tray icon, ![tray icon](lib/assets/icon.png).\n\n![Screenshot](docs/screenshot.png)\n\n## Newsletter\nInterested in hearing about updates and new releases of `google-music-electron`?\n\n[Subscribe to our newsletter!](https://groups.google.com/forum/#!forum/google-music-electron)\n\n## MPRIS integration\nIf you are on GNU/Linux and your desktop environment supports [MPRIS][], you can install our [MPRIS][] integration via:\n\n```bash\ngoogle-music-electron install-mpris\n# Once this succeeds, MRPIS will be integrated on `google-music-electron` restart\n```\n\n![MPRIS screenshot](docs/mpris-screenshot.png)\n\n[MPRIS]: http://specifications.freedesktop.org/mpris-spec/latest/\n\n## Updating\n`google-music-electron` can be updated via `npm`:\n\n```js\n# Update google-music-electron to a newer version via npm\nnpm update -g google-music-electron\n# Alternatively, the following can be used as well to specify a version\n# npm install -g google-music-electron@latest\n```\n\n## Documentation\n### CLI\nWe have a few CLI options available for you:\n\n```\n  Usage: google-music-electron [options] [command]\n\n\n  Commands:\n\n    install-mpris   Install integration with MPRIS (Linux only)\n\n  Options:\n\n    -h, --help                  output usage information\n    -V, --version               output the version number\n    -S, --skip-taskbar          Skip showing the application in the taskbar\n    --minimize-to-tray          Hide window to tray instead of minimizing\n    --hide-via-tray             Hide window to tray instead of minimizing (only for tray icon)\n    --allow-multiple-instances  Allow multiple instances of `google-music-electron` to run\n    --verbose                   Display verbose log output in stdout\n    --debug-repl                Starts a `replify` server as `google-music-electron` for debugging\n```\n\n## Development\n### Running locally\nTo get a local development copy running, you will need:\n\n- [npm][], usually installed with [node][]. Same `npm` that is used during installation\n- [git][], version control tool\n\n[git]: http://git-scm.com/\n\nFollow the steps below to get a development copy set up:\n\n```bash\n# Clone our repository\ngit clone https://github.com/twolfson/google-music-electron.git\ncd google-music-electron/\n\n# Install our dependencies and dev dependencies\nnpm install\n\n# Start up `google-music-electron`\nnpm start\n```\n\nAfter running the above steps, a copy of `google-music-electron` should begin running.\n\n![Screenshot](docs/screenshot.png)\n\n#### Adding local setup as a global installation\nAfter getting our local development set up, we can go one step further and get `google-music-electron` working on our CLI as if it were installed via `npm install -g`.\n\n```bash\n# Link local copy as a global copy\n# WARNING: Make sure that `npm install` has been run before this point\n#   or your local copy's permissions may get messed up\nnpm link\n\n# Run `google-music-electron` for local copy\ngoogle-music-electron\n```\n\nMore information on `npm link` can be found in `npm's` documentation:\n\nhttps://docs.npmjs.com/cli/link\n\n### Icons\nSource images are kept in the `resources/` folder. Icons are maintained via Inkscape and the `play/pause` buttons are isolated in layers.\n\nTo generate icons:\n\n1. Export each of the play/pause/clean variants as a `.svg` file\n2. Load the icons via GIMP as a 32x32 SVG\n3. Export via GIMP as a `.png`\n\nAt the time of writing, Inkscape and Image Magick seemed to be generating non-transparent backgrounds upon converting SVG to PNG.\n\n## Contributing\nIn lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint via `npm run lint` and test via `npm test`.\n\n## Donating\nSupport this project and [others by twolfson][twolfson-projects] via [donations][twolfson-support-me].\n\n\u003chttp://twolfson.com/support-me\u003e\n\n[twolfson-projects]: http://twolfson.com/projects\n[twolfson-support-me]: http://twolfson.com/support-me\n\n## Attribution\nHeadphones designed by Jake Dunham from [the Noun Project][headphones-icon]\n\n[headphones-icon]: http://thenounproject.com/term/headphones/16097/\n\n## Unlicense\nAs of May 16 2015, Todd Wolfson has released this repository and its contents to the public domain.\n\nIt has been released under the [UNLICENSE][].\n\n[UNLICENSE]: UNLICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwolfson%2Fgoogle-music-electron","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftwolfson%2Fgoogle-music-electron","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwolfson%2Fgoogle-music-electron/lists"}