ryot
starsforks
How to install ryot?
berabuddies/semia/ryot
$npx -y skills add berabuddies/Semia --skill ryotComplete Ryot media tracker with progress tracking, reviews, collections, analytics, calendar, and automated daily/weekly reports. Track TV shows, movies, books, anime, games with full GraphQL API integration.
SKILL.md
| 1 | # Ryot Media Tracker - Complete Suite |
| 2 | |
| 3 | Full-featured Ryot integration with progress tracking, reviews, collections, analytics, calendar, and automated reports. |
| 4 | |
| 5 | ## Setup (Required) |
| 6 | |
| 7 | Before using this skill, you must configure your Ryot instance: |
| 8 | |
| 9 | 1. **Create config file** at `/home/node/clawd/config/ryot.json`: |
| 10 | |
| 11 | ```json |
| 12 | { |
| 13 | "url": "https://your-ryot-instance.com", |
| 14 | "api_token": "your_api_token_here" |
| 15 | } |
| 16 | ``` |
| 17 | |
| 18 | 2. **Set your Ryot instance URL** - Replace `https://your-ryot-instance.com` with your actual Ryot server address |
| 19 | 3. **Get your API token** from your Ryot instance settings |
| 20 | 4. **Save the config** - The skill will read this file automatically |
| 21 | |
| 22 | ## Usage |
| 23 | |
| 24 | Use `scripts/ryot_api.py` for all Ryot operations. |
| 25 | |
| 26 | ## 🚀 Quick Start - Automated Setup |
| 27 | |
| 28 | ```bash |
| 29 | cd /home/node/clawd/skills/ryot/scripts |
| 30 | ./setup-automation.sh |
| 31 | ``` |
| 32 | |
| 33 | This will: |
| 34 | - ✅ Set up daily upcoming episodes notification (07:30) |
| 35 | - ✅ Set up weekly stats report (Monday 08:00) |
| 36 | - ✅ Set up daily recent activity (20:00) |
| 37 | - ✅ Configure WhatsApp delivery |
| 38 | |
| 39 | ## Common Tasks |
| 40 | |
| 41 | ### 1. Progress Tracking 📊 |
| 42 | |
| 43 | ```bash |
| 44 | # Check your progress on a TV show |
| 45 | python3 scripts/ryot_api.py progress met_XXXXX |
| 46 | |
| 47 | # Example output: |
| 48 | # Galaxy Express 999 |
| 49 | # Season 1, Episode 35/113 (30%) |
| 50 | ``` |
| 51 | |
| 52 | ### 2. Reviews & Ratings ⭐ |
| 53 | |
| 54 | ```bash |
| 55 | # Add review with rating (0-100) |
| 56 | python3 scripts/ryot_reviews.py add met_XXXXX 85 "Amazing show!" |
| 57 | |
| 58 | # Rating only |
| 59 | python3 scripts/ryot_reviews.py add met_XXXXX 90 |
| 60 | ``` |
| 61 | |
| 62 | ### 3. Collections 📚 |
| 63 | |
| 64 | ```bash |
| 65 | # List your collections |
| 66 | python3 scripts/ryot_collections.py list |
| 67 | |
| 68 | # Create new collection |
| 69 | python3 scripts/ryot_collections.py create "Top Anime 2026" "My favorite anime of the year" |
| 70 | |
| 71 | # Add media to collection |
| 72 | python3 scripts/ryot_collections.py add <collection_id> met_XXXXX |
| 73 | ``` |
| 74 | |
| 75 | ### 4. Analytics & Stats 📈 |
| 76 | |
| 77 | ```bash |
| 78 | # View your statistics |
| 79 | python3 scripts/ryot_stats.py analytics |
| 80 | # Output: Total media, shows, movies, watch time |
| 81 | |
| 82 | # Recently consumed |
| 83 | python3 scripts/ryot_stats.py recent |
| 84 | # Output: Last 10 media you watched/read |
| 85 | ``` |
| 86 | |
| 87 | ### 5. Calendar & Upcoming 📅 |
| 88 | |
| 89 | ```bash |
| 90 | # Upcoming episodes this week |
| 91 | python3 scripts/ryot_calendar.py upcoming |
| 92 | |
| 93 | # Calendar for next 30 days |
| 94 | python3 scripts/ryot_calendar.py calendar 30 |
| 95 | ``` |
| 96 | |
| 97 | ### 6. Search & Details 🔍 |
| 98 | |
| 99 | ```bash |
| 100 | # Search for TV shows |
| 101 | python3 scripts/ryot_api.py search "The Wire" --type SHOW |
| 102 | |
| 103 | # Search for movies |
| 104 | python3 scripts/ryot_api.py search "Inception" --type MOVIE |
| 105 | |
| 106 | # Get details |
| 107 | python3 scripts/ryot_api.py details met_XXXXX |
| 108 | ``` |
| 109 | |
| 110 | ### 7. Mark as Completed ✅ |
| 111 | |
| 112 | ```bash |
| 113 | # Mark media as completed |
| 114 | python3 scripts/ryot_api.py complete met_XXXXX |
| 115 | ``` |
| 116 | |
| 117 | ### 8. Bulk Episode Marking 🎬 |
| 118 | |
| 119 | ```bash |
| 120 | # Search for a show to get metadata_id |
| 121 | python3 scripts/ryot-mark-episodes.py search "Galaxy Express 999" |
| 122 | # Output: Found: met_huCCEo1Pu0xM (source: TMDB, type: SHOW) |
| 123 | |
| 124 | # Mark range of episodes as watched (e.g., episodes 1-46 of season 1) |
| 125 | python3 scripts/ryot-mark-episodes.py met_huCCEo1Pu0xM 1 1 46 |
| 126 | # Marks all episodes from 1 to 46 in season 1 |
| 127 | |
| 128 | # Mark single season episodes |
| 129 | python3 scripts/ryot-mark-episodes.py met_XXXXX 2 1 24 |
| 130 | # Marks season 2, episodes 1-24 |
| 131 | ``` |
| 132 | |
| 133 | **Use cases:** |
| 134 | - Catching up on a series you've already watched elsewhere |
| 135 | - Bulk importing viewing history |
| 136 | - Marking entire seasons at once |
| 137 | |
| 138 | **Note:** Each episode is marked individually with `createNewInProgress` + `showSeasonNumber`/`showEpisodeNumber`. |
| 139 | |
| 140 | ## Workflow |
| 141 | |
| 142 | 1. **User request** → "How many episodes of Galaxy Express 999 have I watched?" |
| 143 | 2. **Search** → Find the correct metadata ID |
| 144 | 3. **Check progress** → `python3 scripts/ryot_api.py progress met_XXX` |
| 145 | 4. **Mark complete** → When finished, deploy bulk progress update |
| 146 | |
| 147 | ## Media Types |
| 148 | |
| 149 | Supported `lot` values: |
| 150 | - `SHOW` - TV series |
| 151 | - `MOVIE` - Films |
| 152 | - `BOOK` - Books |
| 153 | - `ANIME` - Anime series |
| 154 | - `GAME` - Video games |
| 155 | |
| 156 | ## Important Notes |
| 157 | |
| 158 | - **Before first use:** Check if `/home/node/clawd/config/ryot.json` exists. If not, ask the user for their Ryot instance URL and API token, then create the config file. |
| 159 | - Always search first to get the correct metadata ID |
| 160 | - Verify the year if multiple results match the title |
| 161 | - The API uses GraphQL at `/backend/graphql` |
| 162 | - Metadata IDs start with `met_` |
| 163 | |
| 164 | ## Resources |
| 165 | |
| 166 | ### scripts/ryot_api.py |
| 167 | |
| 168 | Python script for Ryot GraphQL operations. Supports: |
| 169 | - `search` - Find media by title |
| 170 | - `details` - Get metadata details |
| 171 | - `complete` - Mark as completed |
People who liked this also viewed
6 picksType
- lark-drive飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sSkillsJul 2026
- lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handlingSkillsJul 2026
- lark-whiteboard飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。SkillsJul 2026
- lark-task飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。SkillsJul 2026
- lark-attendance飞书考勤打卡：查询自己的考勤打卡记录SkillsJul 2026
- lark-apps妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要SkillsJul 2026
