jbaruch/nanoclaw-media

Personal entertainment-media skills for NanoClaw: Trakt watch-history sync, TV-show and audiobook recommendations, watchlist release checks, YouTube channel-comment digests, and Audible backup — with a weekly cadence companion. NanoClaw per-chat overlay tile.

Quality

92%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Risky

Do not use without reviewing

jbaruch/nanoclaw-media

Name: jbaruch/nanoclaw-media
Rating: 73.83 (1 reviews)
Author: jbaruch

Personal entertainment-media skills for NanoClaw. Syncs Trakt watch history, recommends TV shows and audiobooks from your viewing/reading history, checks tracked shows for releases, digests new YouTube channel comments, and backs up Audible purchases — with a weekly cadence companion that drives the recurring pieces.

Per-chat overlay tile. Install via NanoClaw's containerConfig.additionalTiles mechanism.

Capabilities

Trakt watch-history sync — pulls shows/movies/ratings from the Trakt API into trakt-history.json (OAuth token auto-refresh on 401)
Show recommendations — ranks unwatched titles from Netflix history, IMDb ratings, and Trakt history; tracks upcoming shows in watchlist.json
Audiobook recommendations — filters the Audible library by genre/rating, finds series continuations and new releases from favorite authors
Watchlist release checks — nightly check of watchlist.json, Telegram notification when a tracked show is released
YouTube comment digest — weekly fetch of new comments on the owner's channel, per-video summary when anything is new (silent otherwise)
Audible backup — backs up new audiobook purchases and appends them to books-library.csv
Weekly entertainment refresh — the entertainment-sync cadence companion runs the Trakt pull + watchlist check + recommendations + Audible sync on a weekly schedule

Installation

tessl install jbaruch/nanoclaw-media

Add to a chat's overlay tile list via update_group_config:

additionalTiles: ["nanoclaw-media"]

Load the overlay at the main or trusted tier — the cadence skills materialise scheduled_tasks rows and the skills read/write owner data under /workspace/group/.

Required environment

Variable	Used by	Purpose
`TRAKT_CLIENT_ID`	trakt-watch-history, entertainment-sync	Trakt API client id
`TRAKT_ACCESS_TOKEN`	trakt-watch-history, entertainment-sync	Trakt OAuth access token
`TRAKT_REFRESH_TOKEN`	trakt-watch-history	Trakt OAuth refresh token (auto-refresh on 401)
`TRAKT_CLIENT_SECRET`	trakt-watch-history	Trakt OAuth client secret (token refresh)
`YOUTUBE_API_KEY`	youtube-comment-check	YouTube Data API v3 key

NanoClaw forwards these into main/trusted containers. The recommendation skills (recommend-shows, recommend-books) consume no secrets — they read owner-uploaded CSV/JSON data.

Runtime data

The skills read and write files under the shared /workspace/group/ mount:

File	Access	Owner
`trakt-history.json`	write (`entertainment-sync`/`trakt-watch-history`), read (`recommend-shows`)	this tile
`watchlist.json`	write (`recommend-shows`), read (`check-watchlist`)	this tile
`books-library.csv`	write (`audible-backup`), read (`recommend-books`)	this tile
`netflix-history.csv`	read	owner-uploaded
`imdb-ratings.csv`	read	owner-uploaded
`state/entertainment-sync-cursor.json`	read+write	this tile (cadence cursor)
`state/youtube-comment-check-cursor.json`	read+write	this tile (cadence cursor)

Owner-uploaded files degrade gracefully when absent (ladder-fallback). Intra-cluster reads (recommend-shows ← trakt-history.json) resolve because all producing/consuming skills ship in this tile.

Skills

Skill	Description
entertainment-sync	Weekly entertainment refresh (cron `0 10 * * 0`): pulls Trakt watch history, checks watchlist for releases, runs show + book recs, syncs Audible purchases.
recommend-shows	Ranks unwatched TV shows by predicted interest from Netflix/IMDb/Trakt history and tracks upcoming shows in `watchlist.json`. Use when asked for show recommendations or what to watch next.
recommend-books	Recommends audiobooks from the Audible library by reading history, genre/rating filters, series continuations, and new releases. Use when asked what to read/listen to next.
trakt-watch-history	Fetches Trakt.tv watch history (shows, movies, ratings) for analysis and recommendation workflows.
check-watchlist	Nightly check (cron `30 9 * * *`) of tracked shows in `watchlist.json`; Telegram notification when any have been released.
youtube-comment-check	Weekly fetch (cron `45 10 * * 0`) of new comments on the owner's YouTube channel; per-video summary when new comments appear, silent otherwise.
audible-backup	Backs up new Audible purchases, decrypts to M4B, and appends to `books-library.csv`.

Status

V1 — migrated the personal-media skill cluster from nanoclaw-admin as a standalone per-chat overlay tile (jbaruch/nanoclaw-admin#296). Three cadence skills (entertainment-sync, check-watchlist, youtube-comment-check) materialise scheduled_tasks rows in chats that load this overlay; the rest are user-driven.

See CHANGELOG.md for version history.

Workspace: jbaruch
Visibility: Public
Created: 16 days ago
Last updated: 8 days ago
Repository: https://github.com/jbaruch/nanoclaw-media
Publish Source: GitHub
Badge