NewPipe 视频离线下载与订阅迁移

本篇讲两件换机前后必做的事：把视频/音频存到本机离线看（保存目录怎么选才不报错），以及订阅、播放列表、设置的整体迁移。相关文档：APK安装与权限设置.md · 锁屏后台播放与悬浮窗.md

NewPipe 的订阅、播放列表和设置全部存在手机本机的数据库里，没有任何云端同步——离线下载与数据备份因此成了用它绕不开的两课。应用本身的介绍与获取见 NewPipe 介绍站。

一、离线下载：入口与格式

打开任意视频，播放页的下载按钮（向下箭头）点开即可选择：

• 下载什么：视频 / 音频 / 字幕三者可分开保存，只想听就只勾音频，体积小得多；
• 格式与分辨率：视频常见 WebM、M4A 配对，分辨率从 144p 到 4K 都有，取决于该视频本身提供哪些档位。

两点先说清：保存下来的文件用手机自带的播放器打开即可，应用内不直接播放离线文件（它定位是流媒体客户端，不是本地播放器）；应用也不内置音频转码，音频流是 M4A/WebM 格式。

二、第一次下载前：先设好保存目录

最容易卡住的一步。NewPipe 用 Android 的「存储访问框架」（SAF）选目录，目录没授权对，下载会直接失败：

• Android 11 及以上：保存位置不能选 Download 目录本身、也不能选存储根目录。新建一个单独的空文件夹专门存放，在文件选择器底部点「使用此文件夹」完成授权。
• Android 10 及以下：选 Download 下的子目录一般没问题，同样建议单独建一个。

路径在 设置 → 下载 里分别给视频和音频指定，改动时都会弹系统文件选择器。下载失败时按这个顺序查：目录是否按上面规则选的、文件选择器底部的「使用此文件夹」点了没有、应用有没有「存储/媒体」权限；SD 卡总出错就先换回内部存储对照。

三、订阅与数据迁移：导出 → 导入

换机、重装、清数据之前，先做这一步——不导出就卸载，订阅、历史、播放列表、设置全部丢失：

1. 打开 设置 → 备份与恢复，点「导出数据库」，保存到第二节允许访问的位置；
2. 新机装好 NewPipe（安装步骤见APK安装与权限设置.md），在同一位置点「导入数据库」。导入会覆盖当前全部数据且不可撤销，新机上要先装好再导。

只想搬订阅的话有更轻的办法：YouTube 订阅通过 Google Takeout 只勾选 subscriptions 导出 zip，回到订阅页「从 YouTube 导入」选中即可；SoundCloud 则复制个人主页链接，粘进订阅页的导入框。

四、升版本的一条铁律

签名不同的安装包不能覆盖安装（会提示「应用未安装」）。升级要么从原渠道拿新版同源覆盖，要么走「导出备份 → 卸载 → 装新版 → 导入」的完整流程。遇到视频大面积加载失败，通常等一个新版本就能恢复，先查升级再考虑别的。