1.0.0 • Published 1 year ago

@gewoonjaap/ha-nintendo-switch-card v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

(Theme used in screenshots)

Screenshots

away \ offline state

away \ offline state

online state

online state

while playing a game

now playing

Installation

Prerequisites

You need at least one Nintendo Switch integration to use with this card.

Setting up the Nintendo Switch integration

  - platform: rest
    unique_id: nintendo_switch_activity
    name: "Nintendo Switch Activity"
    resource: http://NXAPI-ENDPOINT/api/znc/user
    headers:
      Authorization: na <SESSION TOKEN, STARTS WITH ey>
    scan_interval: 30
    json_attributes_path: $.user
    json_attributes:
      - id
      - nsaId
      - imageUri
      - name
      - supportId
      - isChildRestricted
      - etag
      - links
      - friendCode
      - permissions
      - presence
    value_template: "{{ value_json.presence.state }}"

HACS (recommended)

  1. Go to the Community Store.
  2. Search for Nintendo Switch Card or add this repo to the custom HACS repositories (lovelace).
  3. Press Install.

Manual Installation

resources:
  url: '<url-to-card.js>'
  type: module

Usage

for a single user card, use entity:

entity: sensor.nintendo_switch_activity
type: 'custom:ha-nintendo-switch-card'

you can change the username using the following:

entity: sensor.nintendo_switch_activity
friendly_name: Myself
type: 'custom:ha-nintendo-switch-card'

for multiple users, use the entities attribute: npm.io

entities:
  - sensor.nintendo_switch_activity
  - sensor.nintendo_switch_activity
  - sensor.nintendo_switch_activity
type: 'custom:ha-nintendo-switch-card'

you can also use a prefix selector to select all Nintendo Switch sensors:

type: 'custom:ha-nintendo-switch-card'
entities: sensor.nintendo_switch_activity_

to show only online users, add the online_only attribute:

type: 'custom:ha-nintendo-switch-card'
entities: sensor.nintendo_switch_activity_
online_only: true

you can also show the game header image as background with game_background: true: npm.io

entities:
  - sensor.nintendo_switch_activity
  - sensor.nintendo_switch_activity
  - sensor.nintendo_switch_activity
friendly_name: hello
game_background: true
type: 'custom:ha-nintendo-switch-card'

Stay in touch

Support

Hey dude! Help me out for a couple of :beers: or a :coffee: by clicking on the sponsering link!