{ "info": { "author": "Denis Carriere", "author_email": "carriere.denis@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "# GoPro\n\n**A complete Python GoPro module made easy.**\n\n![GoPro](http://cdn.snowboarding.transworld.net/wp-content/blogs.dir/442/files/2014/09/gopro-hero4-new-camera-black-silver-editions-600x342.png)\n\nAt the moment this module only works with the newest GoPro Hero 4.\n\nSadly the earlier versions of GoPro are not backwards/forwards compatible.\n\n\n\n## Install\n\nEasy install with Github or PyPi\n\nInstalling the **latest version from GitHub**.\n\n```bash\n$ git clone https://github.com/DenisCarriere/gopro.git\n$ cd gopro\n$ python setup.py install\n```\n\nInstalling the **tested version from PyPi**.\n\n```bash\n$ sudo pip install gopro\n```\n\n## Quickstart\n\nOnce the installation is complete you are ready to start! :)\n\nThe default `IP` address for the GoPro is using `10.5.5.9`.\n\nYou must first be connected to the GoProApp Wifi connection.\n\nLaunch your favorite `ipython` or standard `python`\n\n```python\n>>> from gopro import GoPro\n>>> camera = GoPro()\n>>> camera.status\n{'connection': 'OK',\n 'datetime': '2014-11-12T23:53:59',\n 'ip': '10.5.5.9',\n 'ok': True,\n 'screen': 'video',\n 'storage': '31.3 GB',\n 'time_offset': 'now'}\n...\n```\n\n## Take a Photo or Video\n\nWith very simple commands you can tell your GoPro to start recording or take a photo.\n\nThe screen will automaticly change to the approriate page.\n\n```python\n>>> camera.photo()\n>>> camera.video()\n>>> camera.timelapse()\n```\n\n## Camera modes\n\nMakes it easy to cycle threw each available modes.\n\n```python\n>>> camera.mode('burst')\n>>> camera.mode('photo')\n>>> camera.mode('timelapse')\n>>> camera.mode('video')\n...\n```\n\n## Locate (Beep! Beep!)\n\nCan't find your device?? Call the locate function and it will Beep endlessly until there is no more battery.\n\nTo turn off the beeps, simply press the `mode` button on the device or use the `off` as a parameter.\n\n```python\n>>> camera.locate('on')\n>>> camera.locate('off')\n...\n```\n\n## Sleep\n\nThe camera will turn itself off, the Wi-Fi will still be active.\n\nAt the moment there is no working commands to turn the device back on.\n\nTo reactivate the device, press the `mode` button.\n\n```python\n>>> camera.sleep()\n...\n```\n\n## Delete Photos\n\nMight be useful to dump all those photos from your GoPro.\n\n**Warning** once you delete photos/videos you cannot retrieve them back.\n\nThe `erase` function does the same as the delete all.\n\n```python\n>>> camera.erase()\n>>> camera.delete_all()\n>>> camera.delete_last()\n...\n```\n\n## Settings\n\nYou can explore the different types of settings & status by getting the raw JSON response or selecting a specific pre-parsed attribute\n\n### Processed attributes\n\n**Status - Screen**\n\nThis will let you know which page your GP is currently active.\n\nThere are only 4 available outcomes.\n\n```python\n>>> camera.status_screen\n'settings'\n'video'\n'photo'\n'timelapse'\n...\n```\n\n### Raw JSON Responses\n\nThe original response from the GoPro device.\n\n```python\n>>> camera.settings_raw\n>>> camera.status_raw\n...\n```\n\n## Date & Time\n\nIt is a good idea to sync your GoPro with the same clock as your computer.\n\nAn easy way to do this is use the `datetime` & `time_offset` attribute.\n\nTry to aim your GoPro to have less than 1 second offset.\n\nThe `time_offset` is measured in (+/-) seconds.\n\n```python\n>>> camera.datetime\n'2014-11-12 21:53:09'\n>>> camera.datetime_offset\n-0.320142\n>>> camera.status['offset']\n'now'\n...\n```\n\n## File Storage\n\nHere is how you can retrieve the total file storage in (KB) or pretty human readeable format.\n\n```python\n>>> camera.status_storage\n31330144\n>>> camera.status['storage']\n'31.3 GB'\n```\n\n## Debug\n\nWant to explore & troubleshoot the device a bit, you can retrieve the following properties from your device.\n\n```python\n>>> camera.debug\n>>> camera.info\n>>> camera.commands\n...\n```\n\n## Contributors\n\nA big thanks to all the people who have helped contribute!\n\nTo be a contributor, please message me with requests on [Twitter](https://twitter.com/DenisCarriere)/[Github issues](https://github.com/DenisCarriere/gopro/issues)\n\n- @[Denis Carriere](https://github.com/DenisCarriere)\n- @[Konrad Iturbe](https://github.com/KonradIT)\n- @[Jason Moiron](https://github.com/jmoiron)\n\n## License\n\nThe MIT License (MIT)\n\nCopyright (c) 2014-2015 Denis Carriere", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/DenisCarriere/gopro/tarball/master", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/DenisCarriere/gopro", "keywords": "gopro camera hero black", "license": "The MIT License (MIT)\n\nCopyright (c) 2014-2015 Denis Carriere\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.", "maintainer": null, "maintainer_email": null, "name": "gopro", "package_url": "https://pypi.org/project/gopro/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/gopro/", "project_urls": { "Download": "https://github.com/DenisCarriere/gopro/tarball/master", "Homepage": "https://github.com/DenisCarriere/gopro" }, "release_url": "https://pypi.org/project/gopro/0.0.3/", "requires_dist": null, "requires_python": null, "summary": "GoPro Camera - Python module made easy.", "version": "0.0.3" }, "last_serial": 2636794, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "89034cb304d10b622b9bf3dffc6dfd6e", "sha256": "73159f98ec9f6ff72babfa670736d3cc2e0266bce34141f8de4deab2cabc1189" }, "downloads": -1, "filename": "gopro-0.0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "89034cb304d10b622b9bf3dffc6dfd6e", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 7390, "upload_time": "2014-11-12T01:07:27", "url": "https://files.pythonhosted.org/packages/c6/cb/2d4fdc1f142b649795e208cb33e2850cb9e97c27e6f535b7bc89082ebf0d/gopro-0.0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d5b6118f1cdb92f43195b5a69e6dfd63", "sha256": "1476fe63e4a613433c128d6859ac2b3315cfc6eb7408e6434277fcb9bed3d227" }, "downloads": -1, "filename": "gopro-0.0.1.tar.gz", "has_sig": false, "md5_digest": "d5b6118f1cdb92f43195b5a69e6dfd63", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4635, "upload_time": "2014-11-12T01:07:23", "url": "https://files.pythonhosted.org/packages/d6/3a/0a2adcbaa02f048571ba5bb2e7ee49d91e79aafed32b53b4d33f265d4b28/gopro-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "d03e639e9d19baca6e33c984880b4b0d", "sha256": "7e2ad18f682b5178a3ec6789abbbf904a23e839127925cabc5925a4ea2b4b5cd" }, "downloads": -1, "filename": "gopro-0.0.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "d03e639e9d19baca6e33c984880b4b0d", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 9403, "upload_time": "2014-11-13T04:58:25", "url": "https://files.pythonhosted.org/packages/aa/7c/652da2a56a895724e375c5cce902ee5a211aa3b503ae78af71e490f74112/gopro-0.0.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "89cde451c6f5b710971b12302d7a564f", "sha256": "a307bc1ba03bc44c724b58b87e8cc1813c134c60ae74979b93a5125f354b53e2" }, "downloads": -1, "filename": "gopro-0.0.2.tar.gz", "has_sig": false, "md5_digest": "89cde451c6f5b710971b12302d7a564f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6160, "upload_time": "2014-11-13T04:58:21", "url": "https://files.pythonhosted.org/packages/f7/57/69d09487f5bf325cab0728f761e74a8305608f26843674a9e77c509591ae/gopro-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "19d470ee65eb263a32e96f21d9bc754c", "sha256": "c7641b4e09fb0a92868534743f1efc0bf05ad219b0a597340c6f110fe15a5704" }, "downloads": -1, "filename": "gopro-0.0.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "19d470ee65eb263a32e96f21d9bc754c", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 12255, "upload_time": "2014-12-01T02:53:47", "url": "https://files.pythonhosted.org/packages/d2/e1/ffa259f5a06bab5b1c77bda5012256b984b44d833fd09bd29bd5d9aae171/gopro-0.0.3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3dfc9c39fc04f4ee1d5d512ab30fd7c3", "sha256": "ab237b4090112b51a1d626ef7e501bf37370d42ac8f6f3a4e804fd9d5bda13e7" }, "downloads": -1, "filename": "gopro-0.0.3.tar.gz", "has_sig": false, "md5_digest": "3dfc9c39fc04f4ee1d5d512ab30fd7c3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6886, "upload_time": "2014-12-01T02:53:41", "url": "https://files.pythonhosted.org/packages/c6/18/42d761bbe1cb205bc7d69e33c748eb8be04d033a6497aa17290d2e4395cf/gopro-0.0.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "19d470ee65eb263a32e96f21d9bc754c", "sha256": "c7641b4e09fb0a92868534743f1efc0bf05ad219b0a597340c6f110fe15a5704" }, "downloads": -1, "filename": "gopro-0.0.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "19d470ee65eb263a32e96f21d9bc754c", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 12255, "upload_time": "2014-12-01T02:53:47", "url": "https://files.pythonhosted.org/packages/d2/e1/ffa259f5a06bab5b1c77bda5012256b984b44d833fd09bd29bd5d9aae171/gopro-0.0.3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3dfc9c39fc04f4ee1d5d512ab30fd7c3", "sha256": "ab237b4090112b51a1d626ef7e501bf37370d42ac8f6f3a4e804fd9d5bda13e7" }, "downloads": -1, "filename": "gopro-0.0.3.tar.gz", "has_sig": false, "md5_digest": "3dfc9c39fc04f4ee1d5d512ab30fd7c3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6886, "upload_time": "2014-12-01T02:53:41", "url": "https://files.pythonhosted.org/packages/c6/18/42d761bbe1cb205bc7d69e33c748eb8be04d033a6497aa17290d2e4395cf/gopro-0.0.3.tar.gz" } ] }