{"id":23181224,"url":"https://github.com/joeshaw/carwings","last_synced_at":"2025-04-05T01:06:02.818Z","repository":{"id":42461783,"uuid":"99510415","full_name":"joeshaw/carwings","owner":"joeshaw","description":"Go package and CLI tool for the Nissan Leaf Carwings API","archived":false,"fork":false,"pushed_at":"2025-01-24T12:23:10.000Z","size":141,"stargazers_count":31,"open_issues_count":5,"forks_count":11,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-29T00:07:55.619Z","etag":null,"topics":["carwings","golang","leaf","nissan","nissan-connect"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joeshaw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-06T20:03:16.000Z","updated_at":"2025-01-24T12:23:14.000Z","dependencies_parsed_at":"2025-02-27T12:23:35.463Z","dependency_job_id":"4a79317c-13d5-4017-9f8f-3a9490197d0e","html_url":"https://github.com/joeshaw/carwings","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeshaw%2Fcarwings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeshaw%2Fcarwings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeshaw%2Fcarwings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joeshaw%2Fcarwings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joeshaw","download_url":"https://codeload.github.com/joeshaw/carwings/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247271528,"owners_count":20911587,"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":["carwings","golang","leaf","nissan","nissan-connect"],"created_at":"2024-12-18T08:14:56.848Z","updated_at":"2025-04-05T01:06:02.802Z","avatar_url":"https://github.com/joeshaw.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Carwings\n\n[![GoDoc](https://godoc.org/github.com/joeshaw/carwings?status.svg)](http://godoc.org/github.com/joeshaw/carwings)\n\n`carwings` is a Go package and command-line tool providing access to\nthe Nissan Leaf Carwings API.\n\nThrough the Carwings API you can ask your vehicle for the latest data,\nsee current battery and charging statuses, see the current climate\ncontrol state, start or stop climate control remotely, and remotely\nstart charging.\n\n## Command-line tool\n\nThe `carwings` tool can be installed with:\n\n    go install github.com/joeshaw/carwings/cmd/carwings@latest\n\nRun `carwings` by itself to see full usage information.\n\nTo update vehicle information:\n\n    carwings -username \u003cusername\u003e -password \u003cpassword\u003e -region \u003cregion code\u003e update\n\nTo get latest battery status:\n\n    carwings -username \u003cusername\u003e -password \u003cpassword\u003e -region \u003cregion code\u003e battery\n\nThis will print something like:\n\n    Logging into Carwings...\n    Getting latest retrieved battery status...\n    Battery status as of 2017-08-06 15:43:00 -0400 EDT:\n      Capacity: 240 / 240 (92%)\n      Crusing range: 114 miles (107 mi with AC)\n      Plug-in state: not connected\n      Charging status: not charging\n      Time to full:\n        Level 1 charge: 8h30m0s\n        Level 2 charge: 3h0m0s\n        Level 2 at 6 kW: 2h30m0s\n\nFor some people the username is an email address.  For others it's a\ndistinct username.\n\nThe regions are:\n\n| Nissan Region | Carwings Region Code |\n| ------------- | -------------------- |\n| USA           | NNA                  |\n| Europe        | NE                   |\n| Canada        | NCI                  |\n| Australia     | NMA                  |\n| Japan         | NML                  |\n\nConfig values can be provided through environment variables (such as\n`CARWINGS_USERNAME`) or in a `~/.carwings` file in the format:\n\n```\nusername \u003cusername\u003e\npassword \u003cpassword\u003e\nregion NA\n```\n\n## Server mode\n\nWhen `carwings server` is run, an HTTP server is started with endpoints\nfor retrieving battery and climate info, and for starting charging and\ntoggling the climate control system.  This can be handy for building\nhome automation workflows.  I use this with [IFTTT](https://ifttt.com)\nso that I can use the Google Assistant to start warming up my car.\n\nThe endpoints are:\n\n```\nGET /battery\nGET /climate\nPOST /charging/on\nPOST /climate/on\nPOST /climate/off\n```\n\nThe `POST` endpoints take no request body.\n\n## Carwings protocol\n\nJosh Perry's [protocol reference](https://github.com/joshperry/carwings/blob/master/protocol.markdown)\nwas incredibly helpful for the development of this library.\n\nJosh also has an implementation in Javascript:\nhttps://github.com/joshperry/carwings\n\nJason Horne has a Python implementation:\nhttps://github.com/jdhorne/pycarwings2\n\nPhil Cole has taken it, ported it to Python 3, and is carrying it\nforward: https://github.com/filcole/pycarwings2\n\nGuillaume Boudreau has a PHP implementation:\nhttps://github.com/gboudreau/nissan-connect-php\n\nScott Helme created a Javascript Alexa skill:\nhttps://github.com/ScottHelme/AlexaNissanLeaf\n\nTobias Westergaard Kjeldsen has created a [Dart library for\ncarwings](https://gitlab.com/tobiaswkjeldsen/dartcarwings) as well as\n[an Android app](https://gitlab.com/tobiaswkjeldsen/carwingsflutter).\n\nA new North America-only API is being tracked in [issue\n#3](https://github.com/joeshaw/carwings/issues/3), and more\ninformation is available there.\n\n## Contributing\n\nIssues and pull requests are welcome.  When filing a PR, please make\nsure the code has been run through `gofmt`.\n\n## License\n\nCopyright 2017-2020 Joe Shaw\n\n`carwings` is licensed under the MIT License.  See the LICENSE file\nfor details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoeshaw%2Fcarwings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoeshaw%2Fcarwings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoeshaw%2Fcarwings/lists"}