Typing a password with a TV remote is no fun. ZiiX.TV lets a TV log in with a short code you approve on your phone or computer.
Linking an Apple TV with a code
- Open ZiiX.TV on the Apple TV and choose your server.
- The TV shows a code like
ABC-123, a QR code and the address to go to. - On your phone or computer, either scan the QR code, or open your server in the browser, log in, and choose Link a device in the user menu (the address ends in
/#/link). - Enter the code. ZiiX.TV shows which device is asking, from which address, and how long ago, so you can be sure it is your own TV.
- Choose Approve. The TV is logged in as you within a couple of seconds.
The code works for 10 minutes; the TV fetches a new one by itself. Upper or lower case and the dash do not matter.
You can also approve from the iPhone app: Settings → Log in an Apple TV.
The TV is logged in as the user who approves it, and sees everything that user sees. Approve only codes from your own devices.
To log in with a password on the Apple TV instead, choose Log in with password on the code screen.
Phones and tablets
The iPhone, iPad and Android apps log in with your username and password.
Finding your server
The apps look for ZiiX.TV servers on your home network and list them by themselves.
This works when the server can announce itself on the network. In Docker that needs
network_mode: host(on Linux) instead of theports:mapping in the standard compose file:services: ziix-tv: image: ziixeu/ziix-tv:latest network_mode: host # remove the "ports:" linesZIIX_NAMEsets the name the apps show;ZIIX_DISCOVERY=offstops the announcement.
Otherwise, type the address in the app:
- At home: the server’s name or IP address, such as
192.168.1.50ornas. Port 8470 is added by itself. - From the internet: the address of your reverse proxy, such as
tv.example.com. The apps use https for addresses on the internet, so your password never travels unencrypted.
The apps remember each server. If a known address suddenly answers with a different server, they warn you before you type your password.
Seeing and removing devices
Administrators see every logged-in device under Settings → Devices: who it belongs to, the app or browser, when it was last seen and what it is playing. Log out removes a device; it has to log in again.