IINA浏览器扩展：一键发送网页视频到播放器

你是否也遇到这些视频播放痛点？

还在忍受浏览器播放视频时的广告骚扰？想在大屏幕上欣赏网页视频却苦于没有便捷传输方式？希望使用专业播放器的高级功能（如倍速播放、画质调整、字幕控制）却受限于浏览器功能？IINA浏览器扩展彻底解决这些问题，让你一键将网页视频无缝传输到功能强大的IINA播放器中。

读完本文你将获得：

• 3种浏览器扩展的安装与配置指南
• 4种视频发送方式的详细操作步骤
• 常见问题的解决方案与高级技巧
• 扩展工作原理的技术解析

IINA浏览器扩展概述

IINA是一款基于MPV的macOS平台媒体播放器（Media Player），以其强大的自定义功能和现代化界面深受用户喜爱。为实现网页视频与桌面播放器的无缝衔接，IINA开发团队提供了多款浏览器扩展（Browser Extension），支持Safari、Chrome及Firefox等主流浏览器。

扩展功能对比

功能特性	Safari扩展	Chrome扩展	Firefox扩展
一键发送当前页面视频	✅	✅	✅
右键菜单发送链接	✅	✅	✅
视频检测自动提示	❌	✅	✅
自定义快捷键	❌	✅	✅
播放历史记录	❌	✅	✅
扩展设置同步	❌	✅	❌

工作原理流程图

sequenceDiagram
    participant 用户
    participant 浏览器
    participant IINA扩展
    participant IINA播放器
    participant 系统

    用户->>浏览器: 浏览包含视频的网页
    IINA扩展->>浏览器: 注入内容脚本检测视频元素
    IINA扩展->>用户: 显示"在IINA中打开"按钮
    用户->>IINA扩展: 点击发送视频
    IINA扩展->>系统: 通过x-callback-url协议传递视频URL
    系统->>IINA播放器: 启动并传递参数
    IINA播放器->>系统: 请求网络视频资源
    系统->>IINA播放器: 返回视频数据流
    IINA播放器->>用户: 开始播放视频

安装与配置指南

Chrome扩展安装

1. 下载扩展文件

   git clone https://gitcode.com/gh_mirrors/iin/iina.git
   cd iina/browser/Chrome_Open_In_IINA
   

2. 开发者模式安装

   • 打开Chrome浏览器，访问chrome://extensions
   • 启用右上角"开发者模式"开关
   • 点击"加载已解压的扩展程序"
   • 选择Chrome_Open_In_IINA目录完成安装

3. 基础配置

   • 点击扩展图标，选择"选项"
   • 设置IINA路径（通常为/Applications/IINA.app）
   • 配置默认播放选项（画质、音量、播放模式）

Safari扩展安装

1. 编译扩展

   cd /data/web/disk1/git_repo/gh_mirrors/iin/iina
   xcodebuild -project iina.xcodeproj -target OpenInIINA
   

2. 系统设置

   • 打开"系统设置" → "扩展" → "Safari"
   • 启用"OpenInIINA"扩展
   • 授予"网站访问"权限（推荐"所有网站"）

Firefox扩展安装

1. 打包扩展

   cd /data/web/disk1/git_repo/gh_mirrors/iin/iina/browser/Firefox_Open_In_IINA
   zip -r open-in-iina.zip . -x "*.git*" "*.DS_Store"
   

2. 临时安装

   • 打开Firefox，访问about:debugging#/runtime/this-firefox
   • 点击"临时加载附加组件"
   • 选择打包好的open-in-iina.zip文件

四种视频发送方式详解

1. 工具栏按钮一键发送

这是最常用的方式，适用于大多数视频网站：

1. 打开包含视频的网页（如YouTube、Bilibili等）
2. 等待扩展检测到视频内容（通常1-2秒）
3. 点击浏览器工具栏中的"IINA"图标
4. 扩展自动提取主视频URL并发送到IINA
5. IINA自动启动并开始播放视频

提示：如果工具栏按钮为灰色，表示当前页面未检测到可发送的视频资源

2. 右键菜单精确发送

当页面包含多个视频或需要指定链接时使用：

flowchart TD
    A[右键点击视频/链接] --> B[选择"在IINA中打开"]
    B --> C{链接类型}
    C -->|视频直接播放| D[IINA立即播放]
    C -->|网页链接| E[提取页面视频后播放]
    C -->|播放列表| F[导入全部视频到IINA播放列表]

操作步骤：

• 右键点击视频元素或视频链接
• 在上下文菜单中选择"使用IINA打开"
• 对于包含多个视频的页面，扩展会显示选择对话框
• 选择目标视频后点击"确定"完成发送

3. 快捷键快速操作

Chrome和Firefox扩展支持自定义快捷键：

1. 配置快捷键（以Chrome为例）：

   • 访问chrome://extensions/shortcuts
   • 找到"Open In IINA"扩展
   • 设置"激活扩展"的快捷键（如Ctrl+Shift+I）

2. 使用方法：

   • 在视频页面按下配置的快捷键
   • 扩展将自动发送当前页面主视频
   • 如页面有多个视频，会显示选择面板

4. 批量发送与播放列表

对于包含多个视频的系列内容：

1. 在支持的视频网站（如YouTube播放列表页面）
2. 点击扩展图标并选择"全部发送"
3. IINA将打开并导入所有视频到播放列表
4. 使用IINA的播放列表控制（Cmd+L显示/隐藏）进行管理

高级技巧：在IINA中，使用Cmd+Shift+Up/Down可以调整播放列表顺序

常见问题与解决方案

扩展无法检测视频

可能原因	解决方案
视频使用加密播放技术	尝试右键视频链接使用"在IINA中打开"
扩展权限不足	检查并授予扩展对当前网站的访问权限
视频使用非标准播放器	更新IINA到最新版本（≥1.3.0）
浏览器版本过低	Chrome/Firefox需更新至最新版本

发送失败的排查步骤

1. 检查系统协议

   # 验证x-callback-url协议是否正常
   open "iina://x-callback-url/play?url=https://example.com/video.mp4"
   

2. 查看扩展日志

   • Chrome: chrome://extensions/ → 扩展"详情" → "查看日志"
   • Firefox: about:debugging → 扩展"检查" → "控制台"

3. 测试IINA直接打开

   /Applications/IINA.app/Contents/MacOS/IINA --mpv-url="https://example.com/video.mp4"
   

性能优化建议

• 缓存设置：在IINA偏好设置→网络中，增加缓存大小至512MB
• 硬件加速：启用IINA→偏好设置→视频→硬件解码
• 预加载配置：扩展选项中设置"预加载视频元数据"为开启状态
• 后台播放：在IINA中启用"退出时继续播放音频"选项

高级自定义与开发

扩展源码结构解析

browser/
├── Chrome_Open_In_IINA/
│   ├── background.js      # 后台服务脚本
│   ├── content.js         # 页面内容脚本
│   ├── manifest.json      # 扩展配置
│   ├── options.html       # 设置页面
│   └── popup.html         # 弹出窗口
└── Firefox_Open_In_IINA/
    ├── background.js
    ├── content.js
    ├── manifest.json
    └── options.html

自定义视频检测规则

修改content.js文件，添加自定义视频选择器：

// 自定义视频元素选择器
const CUSTOM_SELECTORS = [
  'video[class*="custom-video"]',
  'div[data-video-url]',
  'iframe[src*="video-player"]'
];

// 在现有检测逻辑中添加自定义规则
function findVideos() {
  let videos = [...document.querySelectorAll(DEFAULT_SELECTORS)];
  
  // 添加自定义选择器检测
  CUSTOM_SELECTORS.forEach(selector => {
    document.querySelectorAll(selector).forEach(element => {
      const videoUrl = element.dataset.videoUrl || element.src;
      if (videoUrl) {
        videos.push({
          url: videoUrl,
          title: element.title || 'Custom Video'
        });
      }
    });
  });
  
  return videos;
}

开发调试技巧

1. Chrome扩展调试

   • 背景页调试：chrome://extensions → "服务工作线程" → "检查"
   • 内容脚本调试：页面右键"检查" → "Sources" → "Content scripts"

2. 日志输出配置

   // 在background.js中添加详细日志
   const DEBUG = true;
   
   function log(message, data) {
     if (DEBUG) {
       console.log(`[IINA Extension] ${message}`, data || '');
     }
   }
   

使用场景与案例

网课学习效率提升

对于在线课程视频，使用IINA播放可获得更好的学习体验：

1. 倍速播放控制：支持0.5x-4x精确调速，使用[和]键快速调整
2. 章节标记：使用IINA的书签功能（Cmd+D）标记重点内容
3. 笔记同步：配合MPV脚本，可将时间点同步到Notion等笔记软件
4. 画中画模式：启用macOS的画中画功能，实现多任务学习

直播内容录制

通过IINA的录制功能，可以轻松保存直播内容：

1. 使用扩展发送直播链接到IINA
2. 播放时按Cmd+R开始录制，再次按Cmd+R结束
3. 录制文件默认保存在~/Movies/IINA/目录

注意：请遵守版权法规，仅录制允许保存的内容

学术视频研究

对于学术会议视频和教程，IINA提供专业工具：

• 精确跳转：使用Shift+←/→进行帧级精确控制
• 字幕导出：将视频字幕导出为文本进行分析
• 截图标注：使用Cmd+S截取关键画面，配合预览工具标注

总结与展望

IINA浏览器扩展通过简洁的设计解决了网页视频播放的诸多痛点，实现了从浏览器到专业播放器的无缝过渡。无论是普通用户的日常观影，还是专业人士的媒体处理，都能显著提升效率和体验。

随着Web技术的发展，未来版本可能会加入更多高级功能：

• AI视频内容分析与自动章节划分
• 多设备同步播放进度
• 增强的字幕识别与翻译功能
• 与笔记软件的深度集成

立即尝试IINA浏览器扩展，重新定义你的视频观看体验！

收藏本文，随时查阅扩展使用技巧。关注项目更新，获取最新功能通知。