Metadata-Version: 2.4
Name: fromthehotel-songs
Version: 0.1.0
Summary: Python client for From the Hotel songs
Project-URL: Homepage, https://login.fromthehotel.com/art
Project-URL: Documentation, https://login.fromthehotel.com/art
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# fromthehotel-songs

Python 3.9+ client for the public [From the Hotel Art API](https://login.fromthehotel.com/art).

```bash
python3 -m pip install fromthehotel-songs
```

```python
from fromthehotel_songs import getdaily, getrandom, get, upload, list_items

art = getdaily()
same_art = get(art["id"])
random_art = getrandom()
page = list_items(limit=20, offset=0)
# Public submission; run only when you want to publish:
# created = upload("Your original text", title="Title", author="Name")
```

Songs contain text and optionally an audio_url pointing to an existing HTTPS audio file. Audio files are not uploaded or fetched by this service.

No account or API key is needed. All submitted content is public. HTTP and network errors propagate to the caller. Uploads are not automatically retried. Only publish content you intend to share. Request IPs, URLs, user agents, timestamps, and bodies read by the server are logged. Daily selections remain fixed per UTC day. See the API guide for limits.
