开始使用
FluxO
看过什么、看到哪里,换台设备也能接上。
记录同步、片源连接与 TMDB 配置,一步一步来。
先认识你的影视记录
FluxO 把影片资料、季集、观看进度和已看记录留在自己的影视库中。设备里有没有视频,与这些记录能否存在是两件事。
- 观看记录:看过什么、哪一集、几分几秒,通过记录同步交换。
- 视频文件:实际播放的内容,需要当前设备能够访问。
- TMDB 资料:作品名称、海报、简介等,通过资料服务补全。
第一次使用,在 Mac 通过“关联文件夹…”或影视片源入口添加自己的媒体目录,并授权访问。目录关联不会另复制一整份视频。有歧义的作品先确认身份,再整理。
让记录在设备间同步
根据设备和使用习惯选择下面一种适合的方式。第一次接通后,先确认另一台设备能显示同一作品、同一季集和同一进度,再把它用于日常接续。
Mac 与 iPhone:iCloud
- 在两台设备登录用于同步的同一 Apple 账户,并确保 iCloud 可用。
- 打开 FluxO 设置中的记录同步选项。Mac 选择 iCloud;iPhone 开启“iCloud 同步”。
- 让两端联网并打开 FluxO,等待记录交换。在另一端查看作品、继续观看与已看过。
不要求两端存放同一个视频。iCloud 是额外的同步方式,不影响已配对设备的同网交换。
Mac 之间:同步文件夹
- 先让两台 Mac 的云盘客户端同步同一个记录文件夹,例如 OneDrive 文件夹。
- 分别在 FluxO 记录同步中选择“同步文件夹”,指向各自电脑上对应的同一个云端文件夹。
- 等待外部客户端完成文件同步,再在另一台 FluxO 检查记录。
这里交换的是记录,不要求把视频一起放进去。云盘登录与文件同步由对应客户端负责。
Mac 与 iPhone 同网:设备配对
- 让 Mac 与 iPhone 连接同一网络,在设备同步中完成配对。
- 在手机端使用“同步资料与进度”,先检查作品与进度是否到达。
- 已信任设备在同网且两端 FluxO 运行时可自动连接交换记录,无需一直停在传输页面。
不传视频也能同步记录。媒体目录的记录交换还可与这些方式共存。
先保留本机记录,待对应连接恢复后再交换。两边各自观看形成的不同进度会分别保留;不要把“同步”理解为无网络时也能立即互相更新。
继续观看,也保留看过的
打开“继续观看”,选择要接续的作品、季集和进度。多条观看进度或多个片源版本时,明确选择想接着看的那一条。
“已看过”保留过去的观看痕迹。已看完标记与每次观看进度分别保存;重新观看不会抹去原来的完成标记,取消已看完也不等于删除历史进度。仅把播放条拖到片尾不代表完整观看。
先关闭片库中的“只显示可播放”筛选。暂时不可播放的作品仍可保留影片资料和观看记录;要接着播放,再连接对应片源。
需要播放时,再连接片源
Mac 可从本地或外置目录播放。Mac 与 iPhone 同网配对后,可以按需传输自己的影片;iPhone 的媒体来源连接还可配置对应媒体目录的 HTTPS WebDAV 地址。
手机离线观看先完成下载;网络片源需地址、登录与网络可用。各设备分别保存自己的连接授权。视频、设备路径和登录凭据不是观看记录同步的内容。
播放时可以切换音轨、字幕、字幕偏移和倍速。资料获取暂时失败,不等于已有的本地视频不能播放。
一步步获得并配置 TMDB Key
下面从申请到软件内验证完整走一遍。已经有可用资料服务的用户,可以跳过申请。没有 TMDB 凭据也不影响已有本地视频的基础播放。
- 01
登录 TMDB 账户
使用电脑浏览器打开 TMDB 官网。已有账户就登录;没有账户就选择注册,按页面提示完成账户和邮箱确认。官方建议在桌面浏览器申请 API,手机申请页未做完整适配。
- 02
进入账户的 API 设置
进入账户设置(Settings),在侧边栏找到 API。也可以登录后直接打开下面的官方入口。
打开 TMDB API 设置如果已经能看到 API Key 或 API Read Access Token,直接跳到第 5 步,不需要重复申请。
- 03
按实际用途申请
在 API 设置页找到申请凭据的入口。阅读当前使用条款,并根据自己的真实用途选择申请类型;个人非商业用途按相应的开发者申请流程填写。
TMDB 官方说明:非商业使用在按要求标明数据来源的条件下免费;商业用途需要联系 TMDB 获取相应许可。申请按钮、语言及表单可能调整,以登录后的页面为准。
- 04
填写申请信息并提交
如果当前表单要求应用名称、用途说明、网址或联系信息,逐项填写自己的真实情况,再检查并提交。下面只示范个人片库场景的写法,不是固定必填答案。
- 应用名称(示例)
- My personal FluxO library
- 用途说明(仅当符合实际)
- Retrieve movie and TV metadata and posters for my personal media library in FluxO.
- 网址与联系信息
- 按字段要求填写自己真实拥有或使用的信息。没有符合要求的网址时,查看字段帮助或联系 TMDB 支持;不要编造,也不要填成 FluxO 官方运营方。
若页面要求补充信息,完成后再回到 API 设置确认凭据是否已生成。
- 05
复制正确的凭据
在 API 设置中找到 API Read Access Token,复制完整内容。建议使用这项较长的读取令牌。它不是你的 TMDB 登录密码。
当前 FluxO 也兼容较短的 v3 API Key;两者选一个完整复制,不要拼在一起,也不要加引号。官方将这两类凭据列为应用认证方式。
只在自己的软件里填写不要把 Key 放进公开截图、聊天或共享文档。本网页不收集、不保存你的 TMDB 凭据。
- 06
打开 FluxO 的资料连接设置
在 Mac 上打开 FluxO,先退出正在播放的视频。点击屏幕顶部的 FluxO 菜单 → 影片资料连接设置…,进入独立的“FluxO 管理后台”。这不是普通设置页里的同步选项。
首次使用如果提示“影片资料连接需要初始化”,先选择同一菜单中的 初始化影片资料连接…,完成本机提示,再打开资料连接设置。
菜单里没有这个入口?此步骤适用于提供个人资料服务配置入口的 Mac 版本。若所用版本已提供托管资料服务、或资料已经正常显示,不必强行申请或另填 Key。iPhone 也不需要把 Mac 的令牌当作同步信息填写。
- 07
粘贴后,验证并保存
在管理后台选择 影片资料服务,找到 TMDB 连接。把第 5 步复制的凭据粘贴到 访问令牌,点击 验证并保存。
影片资料服务TMDB 连接访问令牌验证并保存以后台提示“已验证并保存”为成功依据。保存后令牌保存在本机钥匙串,不再回显。已有配置可点击“检查当前连接”,不必反复覆盖。
- 08
回到片库,确认资料正常
回到 FluxO,查看一部已关联作品的资料是否正常刷新;需要时重新尝试匹配或刷新资料。能看到正确的作品信息与海报后,即可继续整理。
TMDB 提供影片资料,不提供视频,也不负责同步你看到了哪一集。观看记录同步仍按本指南第 02 节配置。
申请路径与认证说明核对于 2026-11-07:TMDB 官方申请说明 · 凭据说明 · 用途与许可说明。账户表单以你登录后看到的当前页面为准。
遇到问题,按现象检查
另一台设备的记录没有更新
先检查所选同步方式:iCloud 账户与联网状态、外部云盘是否同步完成,或同网设备是否已配对且两端软件运行。连接恢复后再检查;不要删除本机记录来尝试恢复同步。
有进度,却不能播放
记录已到达不代表视频已经到达。检查文件所在磁盘、目录授权、下载是否完成,或远程来源的网络和登录状态;无需为此重新申请 TMDB Key。
提示 TMDB 令牌无效或无访问权限
回到 TMDB 的 API 设置重新复制完整凭据,确认没有截断、拼接或额外引号,再验证。401 或 403 表示认证或访问被拒绝,需要检查凭据和账户权限。
TMDB 连接超时或无法连接
先确认当前网络可以访问 TMDB 服务,再用“检查当前连接”重试。超时不等于 Key 错误;资料服务异常也不等于已有的本地视频不能播放。
已看过的作品暂时找不到
确认查看的是正确的片库,并关闭“只显示可播放”筛选,再检查记录是否同步完成。不可播放和没有观看记录是两种状态。
