A Chrome extension that continuously discovers and plays videos from your X (Twitter) timeline.
XPlayer turns an X timeline into a hands-free video queue. It detects videos already loaded in the timeline, automatically scrolls to discover more, keeps the currently playing video in view, and continues playback as new posts appear.
- Continuous video playback in timeline order
- Automatic scrolling to discover lazy-loaded posts
- Precise focus on the currently playing video
- Skip and pause controls
- Sound follow mode with autoplay-policy fallback
- User-scroll detection: manual scrolling pauses auto-follow
- Keyboard shortcuts:
Alt+Shift+Ptoggle playback,Alt+Shift+Nskip - Chinese / English interface switching
- Dark UI designed for the X experience
- Runs locally; no backend, cookies, or X API required
- Download or clone this repository.
- Open
chrome://extensions. - Enable Developer mode.
- Click Load unpacked.
- Select the project directory.
- Open
https://x.com/homeand refresh the page.
After installation, click the XPlayer toolbar icon and press Start autoplay.
- Start autoplay / Stop autoplay: enable or stop the queue.
- Pause: pause the current video and queue.
- Skip: move to the next discovered video. If the queue is empty, XPlayer scans further down the timeline.
- Sound: On / Off: choose whether subsequent videos should play with sound. Chrome may require a user gesture before allowing audible autoplay.
- Language: click
EN/中in the top-right corner of the popup.
| Shortcut | Action |
|---|---|
Alt+Shift+P |
Pause or resume continuous playback |
Alt+Shift+N |
Skip the current video |
Shortcuts can be changed at chrome://extensions/shortcuts.
XPlayer only requests access to X pages and local storage for settings. It does not:
- read or transmit cookies;
- call private X APIs;
- upload posts, media, or browsing history;
- download or archive videos.
All detection, queue management, and playback control happen inside the browser.
The current release targets the X home timeline (x.com/home) and videos that X has loaded into the page. X uses virtualized lists and frequently changes its DOM, so compatibility may require maintenance when the site UI changes. Browser autoplay rules can also prevent audible playback without a user gesture.
This is a dependency-free Manifest V3 extension:
manifest.json Extension manifest
background.js Keyboard shortcut handler
content.js Timeline scanning and playback queue
popup.html Popup UI
popup.js Popup controls and localization
icons/ Extension icon assets
No build step is required. Load the project directory as an unpacked extension while developing.
No license has been selected yet. Add a license before publishing a public GitHub repository.
XPlayer 是一个 Chrome 扩展,用于识别 X(Twitter)时间线中的视频,并自动滚动寻找新内容,按照时间线顺序连续播放。
主要能力:连续播放、自动下刷加载、精确定位、暂停/跳过、声音跟随、中英文切换、快捷键控制。所有处理均在浏览器本地完成,不读取 Cookie、不调用 X 私有 API、不上传内容。
安装方式:打开 chrome://extensions,开启开发者模式,选择“加载已解压的扩展程序”,选择本项目目录,然后刷新 https://x.com/home。
当前版本主要支持 X 首页时间线。由于 X 使用虚拟列表且页面结构可能变化,后续需要持续维护兼容性。