无线电
- 作者仓库星标 39
- 作者仓库 awesome-omni-skill
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @diegosouzapw · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# xradio
A command-line tool for managing a local cache of Twitter/X posts. Pull tweets from your feed, read them offline, track read/unread status, and play videos.
## Prerequisites
- Browser server must be running for `pull` command: `browser server start`
- Must be logged into Twitter/X in the browser session
- `yt-dlp` and `mpv` for video playback
## Commands
### Pull Tweets from Feed
```bash
xradio pull --limit <n>
```
Fetches tweets from your Twitter home feed and saves them to local storage.
- `--limit <n>`: Number of tweets to pull (default: 10)
- Automatically scrolls to load more if needed
- **Never overwrites existing cached tweets** - skips duplicates
- Requires browser server to be running and logged into Twitter
**Example:**
```bash
xradio pull --limit 20
```
**Output:**
```
📡 Pulling up to 20 new tweets from feed...
🌐 Browser connected: https://x.com/home
🔄 Refreshing feed...
scroll 1: +8 new, 2 cached (8/20 total new)
scroll 2: +6 new, 4 cached (14/20 total new)
scroll 3: +6 new, 3 cached (20/20 total new)
✅ [a1b2c3d] User Name: Tweet text preview...
✅ [e4f5g6h] Another User: More tweet content here...
📦 Done! Saved 20 new tweets.
```
### List Cached Tweets
```bash
xradio list # Show unread tweets only
xradio list -A # Show all tweets (including read)
xradio list --all # Same as -A
```
Lists tweets in the offline cache.
- By default, only shows **unread** tweets
- Use `-A` or `--all` to include read tweets
- Shows media indicators: 🎬 (video), 🖼️ (image)
- Shows ✓ for read tweets (when using --all)
**Output:**
```
📚 4 unread tweets in cache:
a1b2c3d🎬🖼️ Man, Crimson Desert looks like the kind of game that would make me disappear...
e4f5g6h🖼️ Breaking: New development in the ongoing situation as officials announce...
Use 'xradio read <id>' to view a tweet, 'xradio mark <id>' to mark as read.
```
### Read a Tweet
```bash
xradio read <id>
```
Display the full content of a cached tweet.
- Supports **short IDs** (like git): `xradio read a1b` instead of full hash
- Shows formatted tweet with author, text, media indicators
- If ambiguous (multiple matches), asks for longer prefix
**Example:**
```bash
xradio read a1b
```
**Output:**
```
────────────────────────────────────────────────────────────
# User Name
**@handle** · 2h
This is the full tweet text content here...
---
🎬 Video | 🖼️ Image
[View on Twitter](https://x.com/handle/status/123456789)
────────────────────────────────────────────────────────────
ID: a1b2c3d (a1b2c3d4e5f6g7h8i9j0...)
Pulled: 2026-01-08T16:00:00.000Z
🎬 This tweet has a video. Use 'xradio play a1b' to play it.
```
### Mark as Read
```bash
xradio mark <id>
```
Mark a tweet as read. It will no longer appear in `xradio list` (only in `xradio list -A`).
**Example:**
```bash
xradio mark a1b
# Output: ✅ Marked a1b2c3d as read
```
### Unmark (Mark as Unread)
```bash
xradio unmark <id>
```
Remove the read status from a tweet, making it appear in the unread list again.
**Example:**
```bash
xradio unmark a1b
# Output: ↩️ Unmarked a1b2c3d (now unread)
```
### Describe Images
```bash
xradio describe <id>
xradio describe <id> "custom prompt here"
```
Describe images in a tweet using AI vision. Downloads images and generates a text description suitable for radio narration.
- Works only on tweets with images (🖼️ indicator)
- Uses AI vision model to describe the image content
- Optional custom prompt for specific questions about the image
**Example:**
```bash
xradio describe 836
```
**Output:**
```
🖼️ Describing 1 image(s) from: Visegrád 24
This is a line graph from Netblocks.org showing normalized network
connectivity in Iran from January 7 to 8, 2026...
```
### Play Video
```bash
xradio play <id>
```
Play a video from a tweet that has video content.
- Extracts video URL via yt-dlp
- Plays with mpv (video + audio)
- Interactive controls: `q` to quit, `space` to pause
**Example:**
```bash
xradio play a1b
```
**Output:**
```
🎬 Extracting video URL for: User Name
https://x.com/handle/status/123456789
📺 Playing video...
(Press 'q' to quit, 'space' to pause)
```
## Storage Format
Tweets are stored in `storage/<id>.md` where `id` is SHA1 hash of the permalink.
Each file has YAML frontmatter + Markdown content:
```markdown
---
id: a1b2c3d4e5f6...
permalink: https://x.com/handle/status/123456789
displayName: User Name
handle: "@handle"
timestamp: "2h"
hasVideo: true
hasImage: false
pulledAt: 2026-01-08T16:00:00.000Z
offline:
read: true
readAt: 2026-01-08T17:00:00.000Z
---
# User Name
**@handle** · 2h
Tweet text content...
---
🎬 Video
[View on Twitter](https://x.com/handle/status/123456789)
```
## Typical Workflow
```bash
# 1. Start browser (if not running)
browser server start
# 2. Pull fresh tweets
xradio pull --limit 10
# 3. See what's new
xradio list
# 4. Read a tweet
xradio read a1b
# 5. If it has video, play it
xradio play a1b
# 6. Mark as read when done
xradio mark a1b
# 7. Continue with next unread tweet
xradio list
```
## Notes
- Short IDs work like git refs - use just enough characters to be unique
- The `offline.*` namespace in frontmatter is for our metadata (read status, etc.)
- Tweet data is never overwritten once cached - pull is additive only
- Video playback requires working yt-dlp Twitter extraction (may have intermittent issues with Twitter API)
章节与文件索引
按说明文件中的顺序排列。
先决条件
从 Feed 中提取推文
列出缓存的推文
阅读推文
标记为已读
文件/命令 -> pull · browser server start · yt-dlp · mpv · --limit <n> · --all · xradio read a1b · xradio list
内容校验值 -> 34161b0fce0c
当前原文的自动摘译,尚未人工审校。
先决条件
浏览器服务器必须为
pull命令运行:browser server start必须在浏览器会话中登录 Twitter/Xyt-dlp和mpv才能播放视频从 Feed 中提取推文
从您的 Twitter 主源中获取推文并将其保存到本地存储。
--limit <n>:要拉取的推文数量(默认值:10) 如果需要,自动滚动以加载更多推文 从不覆盖现有的缓存推文 - 跳过重复 需要浏览器服务器正在运行并登录 Twitter列出缓存的推文
列出离线缓存中的推文。默认情况下,仅显示未读推文 使用
-A或--all包含已读推文 显示媒体指示器:🎬(视频)、🖼️(图像) 已读推文显示 ✓(使用 --all 时)阅读推文
显示缓存的推文的完整内容。支持短ID(如git):
xradio read a1b而不是完整散列显示带有作者、文本、媒体指示符的格式化推文如果不明确(多个匹配),则要求更长的前缀示例:标记为已读
将推文标记为已读。它不会再出现在
xradio list中(仅出现在xradio list -A中)。例子: