Connecting¶
When connecting to a device, the IP-address (or hostname) and its login id, e.g. HSGID, is required. These details can be specified manually or be automatically discovered if home sharing is enabled.
Code Example: Auto discovery¶
Using auto discovery makes the connection procedure simple. But do not forget to logout when you are done, otherwise you will get errors about the aiohttp session not being closed properly.
import pyatv
import asyncio
@asyncio.coroutine
def print_what_is_playing(loop):
atvs = yield from pyatv.scan_for_apple_tvs(loop)
atv = pyatv.connect_to_apple_tv(atvs[0], loop)
try:
# Do something with atv
finally:
yield from atv.logout()
loop = asyncio.get_event_loop()
loop.run_until_complete(print_what_is_playing(loop))
API Reference: pyatv.connect_to_apple_tv()
Code Example: Manual details¶
Manually specifying the required details is not that hard either (also here you need to logout):
import pyatv
import asyncio
NAME = 'My Apple TV'
ADDRESS = '10.0.10.22'
LOGIN_ID = '00000000-1111-2222-3333-444444444444' # HSGID
# LOGIN_ID = '0000000000000001' # Pairing guid
DETAILS = pyatv.AppleTVDevice(NAME, ADDRESS, LOGIN_ID)
@asyncio.coroutine
def print_what_is_playing(loop, details):
atv = pyatv.connect_to_apple_tv(details, loop)
try:
# Do something with atv
except:
# Do not forget to logout
yield from atv.logout()
loop = asyncio.get_event_loop()
loop.run_until_complete(print_what_is_playing(loop, DETAILS))
Specify LOGIN_ID
to be either HSGID or 0000000000000001
if you
have paired with your device.
API Reference: pyatv.connect_to_apple_tv()
, pyatv.AppleTVDevice