8000 GitHub - ai919/xplayer · GitHub
[go: up one dir, main page]

Skip to content
ai919Public

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

XPlayer

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.

Features

  • 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+P toggle playback, Alt+Shift+N skip
  • Chinese / English interface switching
  • Dark UI designed for the X experience
  • Runs locally; no backend, cookies, or X API required

Screenshots

Timeline playback

XPlayer playing a timeline video

Popup while playing

XPlayer popup while playing

Popup paused state

XPlayer popup paused

Installation (Chrome)

  1. Download or clone this repository.
  2. Open chrome://extensions.
  3. Enable Developer mode.
  4. Click Load unpacked.
  5. Select the project directory.
  6. Open https://x.com/home and refresh the page.

After installation, click the XPlayer toolbar icon and press Start autoplay.

Usage

  • 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.

Keyboard shortcuts

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.

Permissions and privacy

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.

Current scope

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.

Development

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.

License

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 使用虚拟列表且页面结构可能变化,后续需要持续维护兼容性。

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages

0