@gewoonjaap/ha-nintendo-switch-card

@kibibit/hass-kibibit-theme

A Home Assistant card for Nintendo Switch integrations

---

(Theme used in screenshots)

Screenshots

away \ offline state

online state

while playing a game

Installation

Prerequisites

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

Setting up the Nintendo Switch integration

• Host the NX-API http server https://community.home-assistant.io/t/new-integration-nintendo-switch/564797/3
• Login to the NX-API with an account that is friends with the account you want to track. (https://github.com/samuelthomas2774/nxapi/issues/1) Getting the NSA ID: https://github.com/samuelthomas2774/nxapi/blob/main/docs/cli.md#friends
• Add the following to your configuration.yaml:

  - platform: rest
    unique_id: nintendo_switch_activity
    name: "Nintendo Switch Activity"
    resource: http://NXAPI-ENDPOINT/api/znc/friend/NSA ID
    headers:
      Authorization: na <SESSION TOKEN, STARTS WITH ey>
    scan_interval: 30
    json_attributes_path: $.friend
    json_attributes:
      - id
      - nsaId
      - imageUri
      - name
      - isFriend
      - isFavoriteFriend
      - isServiceUser
      - friendCreatedAt
      - presence
    value_template: "{{ value_json.friend.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:

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:

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

• Author - Jaap
• Website - https://mrproper.dev

Support

Hey dude! Help me out for a couple of 🍻 or a ☕ by clicking on the sponsering link!