{ "info": { "author": "Bartlomiej Wilczynski", "author_email": "me@bwilczynski.com", "bugtrack_url": null, "classifiers": [], "description": "# Sonos command-line interface\n\nControl your Sonos players from command-line. Uses [Sonos Control API](https://developer.sonos.com/reference/control-api/) to control Sonos groups.\n\n## Installation\n\nUsing `Homebrew` on OSX:\n\n```sh\nbrew tap bwilczynski/tap\nbrew install sonos-cli\n```\n\n\nUsing `pip` (requires Python 3):\n\n```sh\npip install sonos-cli\n```\n\n## Usage\n\n```bash\n$ sonos [OPTIONS] COMMAND [ARGS]\n```\n\n### Get Started\n\n[Setup integration](https://developer.sonos.com/build/direct-control/authorize/) with Sonos API \nand run `sonos config` to provide \nyour application's Client ID and Client Secret.\n\nAlternatively set the following environment variables before running `sonos`:\n\n```bash\nexport SONOS_CLIENT_ID={YOUR_CLIENT_ID}\nexport SONOS_CLIENT_SECRET={YOUR_CLIENT_SECRET}\n```\n\nLogin to your Sonos service (opens a web browser sending user to Sonos login service):\n\n```bash\n$ sonos login\n```\n\nSet active household:\n\n```bash\n$ sonos set household\n```\n\nFor usage and help content, pass in the `--help` parameter, for example:\n\n```bash\n$ sonos --help\n$ sonos get --help\n```\n\n### Available commands\n\n#### Get information from your Sonos:\n\n```bash\n$ sonos get [groups | households | playlists | tracks]\n```\n\nFormat displayed result using `--output` option:\n\n\n```bash\n$ sonos get groups --output table\n\ncoordinatorId id name playbackState\n------------------------ ----------------------------------- ---------------- ----------------------\nRINCON_B8E937E6D36202100 RINCON_B8E937E6D36202100:23 Bedroom. PLAYBACK_STATE_PAUSED\nRINCON_B8E937E6D40E02100 RINCON_B8E937E6D40E02100:128 Bathroom PLAYBACK_STATE_IDLE\nRINCON_B8E937DA7E6802100 RINCON_B8E937DA7E6802100:17 Bathroom 2. PLAYBACK_STATE_PAUSED\nRINCON_347E5C90FA9502100 RINCON_347E5C90FA9502100:4142323492 Living Room PLAYBACK_STATE_PLAYING\n```\n\n```bash\n$ sonos get groups --output json\n\n[\n {\n \"coordinatorId\": \"RINCON_B8E937E6D36202100\",\n \"id\": \"RINCON_B8E937E6D36202100:23\",\n \"name\": \"Bedroom\",\n \"playbackState\": \"PLAYBACK_STATE_PAUSED\",\n ...\n }\n ...\n}\n```\n\n#### Control playback:\n\n```bash\n$ sonos play\n$ sonos pause\n$ sonos next\n$ sonos prev\n```\n\n#### Set active group / household:\n\n```bash\n$ sonos set [group | household]\n```\n\n#### Get playback status:\n\n```bash\n$ sonos status\n```\n\n#### Control group volume\n\n```bash\n$ sonos volume\n20\n```\n\n```bash\n$ sonos volume 25\n```\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/bwilczynski/sonos-cli", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "sonos-cli", "package_url": "https://pypi.org/project/sonos-cli/", "platform": "", "project_url": "https://pypi.org/project/sonos-cli/", "project_urls": { "Homepage": "https://github.com/bwilczynski/sonos-cli" }, "release_url": "https://pypi.org/project/sonos-cli/0.3.1/", "requires_dist": [ "click", "requests", "requests-oauthlib", "tabulate" ], "requires_python": ">=3.0", "summary": "Sonos Command-Line Tools", "version": "0.3.1" }, "last_serial": 4664197, "releases": { "0.2.0": [ { "comment_text": "", "digests": { "md5": "4f6c48a7fd343d26ff90144bbb079efc", "sha256": "3f1bb6622228a7eeddaad318716636af5100555ed420b23d7851521cc28f1af8" }, "downloads": -1, "filename": "sonos_cli-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "4f6c48a7fd343d26ff90144bbb079efc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.0", "size": 13709, "upload_time": "2019-01-04T20:52:45", "url": "https://files.pythonhosted.org/packages/a4/ac/d44b828215e296875fd00a6c2e44b57e8d8eced6f89dd9d265b227d2b113/sonos_cli-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "221ba5e924bf138456073eea03153fdc", "sha256": "db21019bafe36becb20ec4bfcaf884ad555dc796847bd90bbc752e1e4762d665" }, "downloads": -1, "filename": "sonos-cli-0.2.0.tar.gz", "has_sig": false, "md5_digest": "221ba5e924bf138456073eea03153fdc", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.0", "size": 7977, "upload_time": "2019-01-04T20:52:47", "url": "https://files.pythonhosted.org/packages/f7/31/b1fd33ced957716df571e517192f398f03fcfd9398d7240d09a4e56bc61a/sonos-cli-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "6874bb58a8193ebc8c48633062324565", "sha256": "3ab7f7bc8f2289f41382dd3c88d0dacf38f18ea342b787c801dd44087b6464fd" }, "downloads": -1, "filename": "sonos_cli-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "6874bb58a8193ebc8c48633062324565", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.0", "size": 13818, "upload_time": "2019-01-05T20:02:52", "url": "https://files.pythonhosted.org/packages/bd/67/e50e03efd19398ea0497d38171875b6fce442a3c543bfae1302092bfbbd0/sonos_cli-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c18c133fcf2f7f0c1e0749c28f562fe0", "sha256": "6294ab83b4371f6a5f824fcd3efa02a3fddeca7ba1186d04fa30fee9e142ceec" }, "downloads": -1, "filename": "sonos-cli-0.3.0.tar.gz", "has_sig": false, "md5_digest": "c18c133fcf2f7f0c1e0749c28f562fe0", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.0", "size": 8019, "upload_time": "2019-01-05T20:02:54", "url": "https://files.pythonhosted.org/packages/0d/16/6fc6d1824327972196b545458cc486fd320c62e31b205975727b3374a266/sonos-cli-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "064c742727fe1eef79e2898a863dcd7f", "sha256": "f24a750b7162edc193fd19f825de773b67d8184d3849872b9d052829c0e61bad" }, "downloads": -1, "filename": "sonos_cli-0.3.1-py3-none-any.whl", "has_sig": false, "md5_digest": "064c742727fe1eef79e2898a863dcd7f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.0", "size": 13847, "upload_time": "2019-01-05T20:07:21", "url": "https://files.pythonhosted.org/packages/03/67/5ae2ee619c731e79edd8b7ab9f99c350ff06a530e0d8f977a0b9d7631389/sonos_cli-0.3.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "01991a1b6f7ca23cdaccc082dc363e70", "sha256": "2899a69b0e16e44d2eec1c7ee7338b531f5e896262c1f7c8de4bfcd9aa16f859" }, "downloads": -1, "filename": "sonos-cli-0.3.1.tar.gz", "has_sig": false, "md5_digest": "01991a1b6f7ca23cdaccc082dc363e70", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.0", "size": 8092, "upload_time": "2019-01-05T20:07:23", "url": "https://files.pythonhosted.org/packages/6b/52/4e762500ce3ff7f9266296522540ebb628ff0024a10c0de664d0616536fe/sonos-cli-0.3.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "064c742727fe1eef79e2898a863dcd7f", "sha256": "f24a750b7162edc193fd19f825de773b67d8184d3849872b9d052829c0e61bad" }, "downloads": -1, "filename": "sonos_cli-0.3.1-py3-none-any.whl", "has_sig": false, "md5_digest": "064c742727fe1eef79e2898a863dcd7f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.0", "size": 13847, "upload_time": "2019-01-05T20:07:21", "url": "https://files.pythonhosted.org/packages/03/67/5ae2ee619c731e79edd8b7ab9f99c350ff06a530e0d8f977a0b9d7631389/sonos_cli-0.3.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "01991a1b6f7ca23cdaccc082dc363e70", "sha256": "2899a69b0e16e44d2eec1c7ee7338b531f5e896262c1f7c8de4bfcd9aa16f859" }, "downloads": -1, "filename": "sonos-cli-0.3.1.tar.gz", "has_sig": false, "md5_digest": "01991a1b6f7ca23cdaccc082dc363e70", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.0", "size": 8092, "upload_time": "2019-01-05T20:07:23", "url": "https://files.pythonhosted.org/packages/6b/52/4e762500ce3ff7f9266296522540ebb628ff0024a10c0de664d0616536fe/sonos-cli-0.3.1.tar.gz" } ] }