https://github.com/sighmon/powerwall-tv
An AppleTV application to view the current state of your Tesla Powerwall
https://github.com/sighmon/powerwall-tv
api app appletv powerwall swiftui tesla
Last synced: 3 months ago
JSON representation
An AppleTV application to view the current state of your Tesla Powerwall
- Host: GitHub
- URL: https://github.com/sighmon/powerwall-tv
- Owner: sighmon
- License: mit
- Created: 2025-03-17T11:50:38.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-19T22:28:35.000Z (over 1 year ago)
- Last Synced: 2025-03-19T23:28:31.910Z (over 1 year ago)
- Topics: api, app, appletv, powerwall, swiftui, tesla
- Language: Swift
- Homepage: https://apps.apple.com/us/app/powerwall-tv/id6743396507
- Size: 10.9 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Powerwall for AppleTV, macOS, and iPad
[](https://apps.apple.com/us/app/powerwall-tv/id6743396507)
[](https://testflight.apple.com/join/4EFw1RBR)
[](https://github.com/sighmon/Powerwall-TV/actions/workflows/ci.yml)
An AppleTV/macOS/iPad application to view the current state of your Tesla Powerwall via your local network or Tesla Fleet API.
## Download
* Download the app from the [AppleTV App Store](https://apps.apple.com/us/app/powerwall-tv/id6743396507)
* Sign up for beta versions [TestFlight](https://testflight.apple.com/join/4EFw1RBR)
## Setup
### Local network
* [Connecting Powerwall to Wi-Fi](https://www.tesla.com/en_au/support/energy/powerwall/mobile-app/connecting-powerwall-wi-fi)
* [Local API details](https://github.com/vloschiavo/powerwall2)
* Then Visit the local network IP address of your Tesla Gateway and setup your username and password.
In this application:
* Select the "Local" tab in the Settings screen
* Enter the IP Address of your Tesla Gateway
* Enter the Username/email address you signed up with
* Enter the Password you set (it may be the default Gateway password if you didn't change it)
* Tap save
### Tesla Fleet API
* Select the "Fleet API" tab in the Settings screen
* The application will now ask you to login via your iPhone or iPad with your Tesla credentials via the Tesla website
* Once approved, an access token will be saved to your AppleTV Keychain so it can access your Powerwall via the Tesla Fleet API cloud
None of your Tesla credentials will be saved in the application or anywhere else. Only the access token, refresh token, and expiry date will be saved so that you don't need to authenticate each time you open the application.
## Grid data
If you'd like to see the carbon intensity of your grid via [electricitymaps.com](https://www.electricitymaps.com), follow these steps:
* Sign up for a [Home Assistant account/API Key](https://portal.electricitymaps.com/auth/signup/home-assistant)
* Enter your API Key and Zone (country code/state) into the Settings view of this app.
* The percentage of renewable energy in the grid, and the gCO2eq/kWh for your zone will show in the Grid label.
## CI note
CI uses a stub `Secrets` implementation so builds can run without local credentials. The stub reads `TESLA_CLIENT_ID` and `TESLA_CLIENT_SECRET` when the `CI` build flag is set.
## Local development
Create `Powerwall-TV/Secrets.swift` with your Fleet API credentials. The file is git-ignored.
```swift
// Powerwall-TV/Secrets.swift
enum Secrets {
static let clientID = ""
static let clientSecret = ""
}
```
## Privacy
This application collects no personal data, and all information entered into it is only used to connect directly to your Powerwall via your own WiFi network, or directly to official Tesla Fleet API servers to retrieve Powerwall data remotely.
All connection tokens are only stored in your AppleTV's Keychain.