https://github.com/abovecolin/stremio-py
https://github.com/abovecolin/stremio-py
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/abovecolin/stremio-py
- Owner: AboveColin
- Created: 2025-12-21T19:30:47.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-21T19:59:40.000Z (6 months ago)
- Last Synced: 2025-12-23T08:11:15.236Z (6 months ago)
- Language: Python
- Size: 8.79 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Stremio-API
A lightweight, asynchronous Python wrapper for the Stremio API.
## Features
- ✨ Async functionality using `httpx`
- 👤 User authentication and profile management
- 📚 Library and Addon collection access
- 📺 "Continue Watching" synchronization
- 🎬 Metadata fetching (via Cinemeta)
## Installation
```bash
pip install stremio-api
```
## Quick Start
You can log in directly using your Stremio credentials:
```python
import asyncio
from stremio_api import StremioAPIClient
async def main():
# Initialize without an auth key (or with None)
async with StremioAPIClient(auth_key=None) as client:
# Login with email and password
auth_key = await client.login("your.email@example.com", "your_password")
print(f"Logged in! New Auth Key: {auth_key}")
# Get user info
user = await client.get_user()
print(f"User profile: {user.email}")
# Fetch Continue Watching items
watching = await client.get_continue_watching(limit=5)
for item in watching:
print(f"Watching: {item.name}")
if __name__ == "__main__":
asyncio.run(main())
```
## Usage with Existing Auth Key
If you already have an `authKey` (e.g. from local storage), you can skip the login:
```python
client = StremioAPIClient(auth_key="YOUR_EXISTING_KEY")
user = await client.get_user()
```