adventuresinodyssey 0.1.5

Python API clients for Adventures in Odyssey.

An unofficial Python API client for the Adventures in Odyssey Club and public endpoints. This library allows you to interact with AIO content, including retrieving metadata for albums and episodes.

Note: This is an Alpha release. APIs may change.

Documentation

Github

Important: Browser Requirement

This library uses Playwright for authentication. After installing the package, you must install the required browser binaries (Chromium):

playwright install chromium

Example Program

import random
from adventuresinodyssey import AIOClient

client = AIOClient()
link_base = "https://app.adventuresinodyssey.com/content/"

print("Caching episodes...")
all_episodes = client.cache_episodes()

if not all_episodes:
    print("Error: Failed to cache episodes.")
    exit()

# Pick a random episode
episode = random.choice(all_episodes)

print(f"Random episode: {episode.get('short_name')}")
print(f"Link: {link_base}{episode.get('id')}")