THE FIELD GUIDE / FLUXO使用说明

开始使用
FluxO

看过什么、看到哪里,换台设备也能接上。
记录同步、片源连接与 TMDB 配置,一步一步来。

01

先认识你的影视记录

FluxO 把影片资料、季集、观看进度和已看记录留在自己的影视库中。设备里有没有视频,与这些记录能否存在是两件事。

先把这三件事分清楚
  • 观看记录:看过什么、哪一集、几分几秒,通过记录同步交换。
  • 视频文件:实际播放的内容,需要当前设备能够访问。
  • TMDB 资料:作品名称、海报、简介等,通过资料服务补全。

第一次使用,在 Mac 通过“关联文件夹…”或影视片源入口添加自己的媒体目录,并授权访问。目录关联不会另复制一整份视频。有歧义的作品先确认身份,再整理。

02

让记录在设备间同步

根据设备和使用习惯选择下面一种适合的方式。第一次接通后,先确认另一台设备能显示同一作品、同一季集和同一进度,再把它用于日常接续。

Mac 与 iPhone:iCloud

  1. 在两台设备登录用于同步的同一 Apple 账户,并确保 iCloud 可用。
  2. 打开 FluxO 设置中的记录同步选项。Mac 选择 iCloud;iPhone 开启“iCloud 同步”。
  3. 让两端联网并打开 FluxO,等待记录交换。在另一端查看作品、继续观看与已看过。

不要求两端存放同一个视频。iCloud 是额外的同步方式,不影响已配对设备的同网交换。

Mac 之间:同步文件夹

  1. 先让两台 Mac 的云盘客户端同步同一个记录文件夹,例如 OneDrive 文件夹。
  2. 分别在 FluxO 记录同步中选择“同步文件夹”,指向各自电脑上对应的同一个云端文件夹。
  3. 等待外部客户端完成文件同步,再在另一台 FluxO 检查记录。

这里交换的是记录,不要求把视频一起放进去。云盘登录与文件同步由对应客户端负责。

Mac 与 iPhone 同网:设备配对

  1. 让 Mac 与 iPhone 连接同一网络,在设备同步中完成配对。
  2. 在手机端使用“同步资料与进度”,先检查作品与进度是否到达。
  3. 已信任设备在同网且两端 FluxO 运行时可自动连接交换记录,无需一直停在传输页面。

不传视频也能同步记录。媒体目录的记录交换还可与这些方式共存。

离线时会怎样?

先保留本机记录,待对应连接恢复后再交换。两边各自观看形成的不同进度会分别保留;不要把“同步”理解为无网络时也能立即互相更新。

03

继续观看,也保留看过的

打开“继续观看”,选择要接续的作品、季集和进度。多条观看进度或多个片源版本时,明确选择想接着看的那一条。

“已看过”保留过去的观看痕迹。已看完标记与每次观看进度分别保存;重新观看不会抹去原来的完成标记,取消已看完也不等于删除历史进度。仅把播放条拖到片尾不代表完整观看。

没有视频,作品没显示?

先关闭片库中的“只显示可播放”筛选。暂时不可播放的作品仍可保留影片资料和观看记录;要接着播放,再连接对应片源。

04

需要播放时,再连接片源

Mac 可从本地或外置目录播放。Mac 与 iPhone 同网配对后,可以按需传输自己的影片;iPhone 的媒体来源连接还可配置对应媒体目录的 HTTPS WebDAV 地址。

手机离线观看先完成下载;网络片源需地址、登录与网络可用。各设备分别保存自己的连接授权。视频、设备路径和登录凭据不是观看记录同步的内容。

播放时可以切换音轨、字幕、字幕偏移和倍速。资料获取暂时失败,不等于已有的本地视频不能播放。

05

一步步获得并配置 TMDB Key

下面从申请到软件内验证完整走一遍。已经有可用资料服务的用户,可以跳过申请。没有 TMDB 凭据也不影响已有本地视频的基础播放。

申请账户与 API复制读取令牌在 FluxO 验证保存
  1. 01

    登录 TMDB 账户

    使用电脑浏览器打开 TMDB 官网。已有账户就登录;没有账户就选择注册,按页面提示完成账户和邮箱确认。官方建议在桌面浏览器申请 API,手机申请页未做完整适配。

  2. 02

    进入账户的 API 设置

    进入账户设置(Settings),在侧边栏找到 API。也可以登录后直接打开下面的官方入口。

    打开 TMDB API 设置

    如果已经能看到 API Key 或 API Read Access Token,直接跳到第 5 步,不需要重复申请。

  3. 03

    按实际用途申请

    在 API 设置页找到申请凭据的入口。阅读当前使用条款,并根据自己的真实用途选择申请类型;个人非商业用途按相应的开发者申请流程填写。

    TMDB 官方说明:非商业使用在按要求标明数据来源的条件下免费;商业用途需要联系 TMDB 获取相应许可。申请按钮、语言及表单可能调整,以登录后的页面为准。

  4. 04

    填写申请信息并提交

    如果当前表单要求应用名称、用途说明、网址或联系信息,逐项填写自己的真实情况,再检查并提交。下面只示范个人片库场景的写法,不是固定必填答案。

    应用名称(示例)
    My personal FluxO library
    用途说明(仅当符合实际)
    Retrieve movie and TV metadata and posters for my personal media library in FluxO.
    网址与联系信息
    按字段要求填写自己真实拥有或使用的信息。没有符合要求的网址时,查看字段帮助或联系 TMDB 支持;不要编造,也不要填成 FluxO 官方运营方。

    若页面要求补充信息,完成后再回到 API 设置确认凭据是否已生成。

  5. 05

    复制正确的凭据

    在 API 设置中找到 API Read Access Token,复制完整内容。建议使用这项较长的读取令牌。它不是你的 TMDB 登录密码。

    当前 FluxO 也兼容较短的 v3 API Key;两者选一个完整复制,不要拼在一起,也不要加引号。官方将这两类凭据列为应用认证方式。

    只在自己的软件里填写

    不要把 Key 放进公开截图、聊天或共享文档。本网页不收集、不保存你的 TMDB 凭据。

  6. 06

    打开 FluxO 的资料连接设置

    在 Mac 上打开 FluxO,先退出正在播放的视频。点击屏幕顶部的 FluxO 菜单 → 影片资料连接设置…,进入独立的“FluxO 管理后台”。这不是普通设置页里的同步选项。

    首次使用如果提示“影片资料连接需要初始化”,先选择同一菜单中的 初始化影片资料连接…,完成本机提示,再打开资料连接设置。

    菜单里没有这个入口?

    此步骤适用于提供个人资料服务配置入口的 Mac 版本。若所用版本已提供托管资料服务、或资料已经正常显示,不必强行申请或另填 Key。iPhone 也不需要把 Mac 的令牌当作同步信息填写。

  7. 07

    粘贴后,验证并保存

    在管理后台选择 影片资料服务,找到 TMDB 连接。把第 5 步复制的凭据粘贴到 访问令牌,点击 验证并保存。

    影片资料服务TMDB 连接访问令牌验证并保存

    以后台提示“已验证并保存”为成功依据。保存后令牌保存在本机钥匙串,不再回显。已有配置可点击“检查当前连接”,不必反复覆盖。

  8. 08

    回到片库,确认资料正常

    回到 FluxO,查看一部已关联作品的资料是否正常刷新;需要时重新尝试匹配或刷新资料。能看到正确的作品信息与海报后,即可继续整理。

    TMDB 提供影片资料,不提供视频,也不负责同步你看到了哪一集。观看记录同步仍按本指南第 02 节配置。

申请路径与认证说明核对于 2026-11-07:TMDB 官方申请说明 · 凭据说明 · 用途与许可说明。账户表单以你登录后看到的当前页面为准。

06

遇到问题,按现象检查

另一台设备的记录没有更新

先检查所选同步方式:iCloud 账户与联网状态、外部云盘是否同步完成,或同网设备是否已配对且两端软件运行。连接恢复后再检查;不要删除本机记录来尝试恢复同步。

有进度,却不能播放

记录已到达不代表视频已经到达。检查文件所在磁盘、目录授权、下载是否完成,或远程来源的网络和登录状态;无需为此重新申请 TMDB Key。

提示 TMDB 令牌无效或无访问权限

回到 TMDB 的 API 设置重新复制完整凭据,确认没有截断、拼接或额外引号,再验证。401 或 403 表示认证或访问被拒绝,需要检查凭据和账户权限。

TMDB 连接超时或无法连接

先确认当前网络可以访问 TMDB 服务,再用“检查当前连接”重试。超时不等于 Key 错误;资料服务异常也不等于已有的本地视频不能播放。

已看过的作品暂时找不到

确认查看的是正确的片库,并关闭“只显示可播放”筛选,再检查记录是否同步完成。不可播放和没有观看记录是两种状态。