26.10.09 14:52

FastMediaSorter v2 🚀

Kotlin Android License

📦 下载： Get it on IzzyOnDroid

直接安装 APK？Android 会对它未见过的安装包发出警告 - 了解警告为什么出现、该点什么。

📘 用户文档：覆盖每个功能的分步指南，支持搜索

关于项目

FastMediaSorter v2 是一款面向 Android 设备的完整外壳。它接管主屏幕、播放你的媒体、打开直播流、启动你的应用、与手表通信、监控设备状态，并管理你拥有的每一个文件 - 无论是在本地文件夹、网络驱动器（SMB、SFTP、FTP），还是云存储（Google Drive、OneDrive、Dropbox）中。

它建立在八大支柱之上：设备外壳、媒体播放器、直播流、应用启动、替代系统自带应用、手表伴侣、设备监控，以及完整的文件管理器。整理来自所有这些来源的文件正是这款应用的起点，也依然是其余一切的基石 - 但它已不再是应用的全部。

本手册目前采用与 FEATURES.md 中权威功能清单，以及 DOCS_MAP.md 中文档地图相同的公开术语体系。请以这两个页面作为应用故事、可用版本和当前功能范围的最新权威来源。

Windows 版本 🖥️

在寻找桌面解决方案？看看 Fast Media Sorter & Sharing for Windows- 一款轻量级的 Windows Forms 应用程序，用于快速整理、查看和管理图片与视频文件：

🔗 Fast Media Sorter & Sharing for Windows

📄 如何将电脑文件夹发布到 Android - 通过 SFTP 将你电脑上的文件夹与应用共享（在手机上使用伴侣导入 / 扫描二维码）。

功能包括：

目录

版本 🎯

FastMediaSorter v2 提供七个版本 - 面向日常手机和平板的五个版本（Standard、Lite、Photos、Legacy、FOSS），再加上两个头显与旁加载版本 VR 和 noLegal。权威的功能对照表由构建自动生成，见 FLAVOR_MATRIX.md：

版本 说明 备注
Standard 全功能版本 涵盖媒体、文档、OCR、翻译和云访问的最广泛功能集
Lite 轻量版本 仅支持本地文件 - 视频、音频和图片；不支持网络来源、云、文档或 Streams
Photos 以照片为核心的版本 仅支持图片，配合 SMB/FTP/SFTP 和云；不支持视频和音频
Legacy 面向兼容性的版本 功能集与 Standard 相同，包括 SMB/FTP/SFTP 和云（Google Drive、Dropbox、OneDrive）；面向 Android 6/7（API 23+）构建
FOSS F-Droid 目录版本 不含任何专有 SDK：本地媒体、文档、EPUB 以及 SMB/FTP/SFTP；不支持云、Streams、OCR、翻译、投屏和 Wear OS 伴侣
VR 商店合规的头显版本 面向头显的完整媒体功能集；不支持 Google Cast 和 Wear OS 伴侣
noLegal 旁加载版本 包含 Standard 的全部功能，外加 OpenXR 沉浸式播放器和仅限旁加载的附加功能

我该下载哪个版本？

如需查看各版本的确切功能可用性，请参阅权威文档：

🧭 首次启动： 就在语言选择器下方，应用会让你选择一个设备档案（手机、平板、电视、车载、相框、VR 等），为你定制起始默认设置 - 之后随时可在设置中更改。参见首次启动：选择你的设备档案。

下载 📥

📲 在 Google Play 上获取

编译好的 APK 文件不存放在此 GitHub 仓库中。 所有构建版本均可在 Google Drive 上获取：

🔗 从 Google Drive 下载所有构建版本

版本 文件名 说明
Standard FastMediaSorter_standard_release.zip 全部功能（云、OCR、EPUB、翻译）
Lite FastMediaSorter_lite_release.zip 仅本地媒体（视频、音频、图片；不支持网络、云、文档或 Streams）
Photos FastMediaSorter_photos_release.zip 仅图片，支持网络（SMB/FTP/SFTP）和云
Legacy FastMediaSorter_legacy_release.zip 功能与 Standard 相同，包括网络（SMB/FTP/SFTP）和云；适用于 Android 6/7（API 23+）

注意： 所有构建版本在编译成功后都会自动上传到 Google Drive。

🔐 ZIP 密码：1（APK 文件被打包为带密码保护的 ZIP 压缩包，以绕过 Google Drive 的限制）

截图 📱

Main Screen File Actions Settings
播放器界面    
   

完整尺寸图片：

核心功能

支持的媒体格式 🎞️

FastMediaSorter v2 支持广泛的格式：

使用场景 💡

以下是 FastMediaSorter v2 可以帮到你的几种方式：

1. 📸 整理相机照片

连接你的手机，或打开本地相机文件夹。设置一个 “Best Photos” 目标文件夹。打开查看器，快速滑动浏览成千上万张照片，点按目标按钮即可立即复制最满意的照片。

2. 🏠 网络备份（NAS）

通过 SMB 添加你家中的 NAS。浏览你的本地媒体文件。选择多个文件或一段范围，将它们 “Move” 到 NAS 上妥善保存，为设备腾出空间。

3. ☁️ 云端管理

连接你的 Google Drive、Dropbox 或 OneDrive 账号。无需全部下载即可浏览云端文件。直接在云端删除不需要的文件，或将它们整理到文件夹中。

4. 📺 幻灯片放映与演示

打开一个存有家庭照片或演示幻灯片的文件夹。点按 “Play” 开始幻灯片放映。使用按资源单独设置的选项，按喜好调整每张幻灯片的停留时长。

5. ⭐ 管理收藏

浏览时用星标按钮标记重要文件。之后在主菜单中点按 “Favorites” 标签页，即可在一处立即访问来自所有来源的全部收藏文件 - 非常适合打造一份精选的最佳媒体合集。

6. 🎶 带背景音乐的幻灯片放映

将你的音乐收藏添加为一个资源。在 Settings → Media → Images 中，启用 “Play music during slideshow” 并选择你的音乐资源。现在开始照片幻灯片放映时，你喜欢的曲目就会在后台播放。点按曲目名称即可跳到另一首随机歌曲，为你的照片演示营造完美氛围。

7. 🖼️ 平板上的数码相框

把任意 Android 平板变成一台常亮的精美数码相框。放在支架上，连接你家中的电脑（SMB）或云存储 - 照片直接串流播放，不占用任何本地存储空间。调整幻灯片间隔、保持屏幕常亮、加上背景音乐，尽情回味你的美好回忆。即使是又老又慢的入门级平板也能完美胜任 - 应用已针对低资源持续播放做了优化。

8. 🍿 家庭影院与 VR

直接在手机或 VR 头显上观看存储在电脑或云端的喜爱剧集。无需等待复制，也不用担心空间不够。只需按下播放，下一集就会自动开始。

VR 头显使用场景 - FastMediaSorter 可在基于 Android 的 VR 头显（Meta Quest、Pico 等）上原生运行，无需任何修改：

9. 🧹 下载整理器

下载文件夹乱糟糟？在来源面板中打开它，为 “Documents”、”Images” 和 “Installers” 设置目标按钮。快速浏览文件、预览内容，一键分类到正确的位置。你甚至可以把手机当作遥控器，直接在网络中的电脑上整理文件。

10. 🚗 车载安卓主机上的音乐

在你搭载 Android 系统的车载音响或主机上安装 FastMediaSorter。添加 U 盘或 SD 卡上的音乐文件夹 - 或直接使用内置的 All Music 虚拟资源，零配置立即访问你的全部收藏。方向盘控制、音量旋钮等硬件媒体按键通过后台音频服务无缝配合：播放/暂停、下一首/上一首，全程无需触碰屏幕。应用会记住播放位置，并在启动时自动恢复。

启用 Streams 界面后，同一台车机还能直接通过移动数据或 Wi-Fi 播放网络电台 - 无需另装电台应用。添加任意电台网址，或从 Extensions 界面导入精选电台目录。常驻迷你控制条会显示当前的 ICY 曲目名称，同时电台列表保持可见。

11. 📺 Android TV 盒子上的媒体中心

在任意 Android TV 盒子（小米盒子、Nvidia Shield、Amazon Fire TV，或普通的 Android 盒子）上安装 FastMediaSorter。通过 SMB 连接家中的 NAS、添加 Google Drive 或 Dropbox，或插入 U 盘 - 这一切都在一个应用中完成。用遥控器或蓝牙键盘操控整个流程：方向键移动焦点，OK 打开项目，Back 返回上一级，Backspace 在浏览器中上移一个文件夹。遥控器上的彩色按键映射到常用文件操作（红色 = 删除，绿色 = 复制，黄色 = 移动，蓝色 = 重命名）。在电视上开始带背景音乐的全屏幻灯片放映，或切换到带专辑封面和歌词的音频播放。全程无需触摸屏。

文档 📚

🗺️ Documentation Map / Карта документации: View all docs / Все документы

🌐 官方网站： https://serzhyale.github.io/FastMediaSorter_mob_v2/

权威来源（唯一可信来源）

以下文件应被视为面向用户内容的权威信息来源：

详细指南提供多种语言版本：

🇺🇸 英语：

🇷🇺 俄语：

🇺🇦 乌克兰语：

技术 / 开发者文档：

Wear OS 伴侣 ⌚

FastMediaSorter 包含一个功能完整的 Wear OS 独立应用和手机伴侣端，专为智能手表的形态设计。

媒体播放、网络共享和文件传输功能包含在手表应用的完整版本中（直接安装的 APK）。Google Play 版本是较小的首个版本 - 提供计算器、秒表、迷你游戏和设置；各版本具体拥有哪些功能，参见 Wear OS 门户。

另有一款独立的免费表盘，适用于 Wear OS 6 及更高版本：FastMediaSorter Watch Face。它显示大号时间、日期、波浪和飘动的粒子、电量条，以及最多八个圆形按钮，可用于 FastMediaSorter 快捷方式或其他手表数据；这些按钮会随 FastMediaSorter 手表应用一起出现。请直接在手表上通过 Google Play 安装（搜索 FastMediaSorter），或在手机应用的 Wear 设置中打开它在手表上的页面。

Wear OS 文档：

构建说明

环境要求

构建步骤

  1. 克隆仓库：

     git clone https://github.com/SerZhyAle/FastMediaSorter_mob_v2.git
 cd FastMediaSorter_mob_v2
  2. 在 Android Studio 中打开该项目。
  3. 等待 Gradle 同步完成。
  4. 在模拟器或真实设备上运行该应用。

推荐构建命令（Windows / PowerShell）

.\build-debug.PS1
.\gradlew.bat :app_v2:assembleStandardDebug
.\gradlew.bat testStandardDebugUnitTest
.\gradlew.bat :app_v2:lintStandardDebug

生成的 APK 📦

每次成功构建后，生成的 APK 文件都会带着时间戳自动复制到项目根目录下的 DOWNLOADS 文件夹中。你可以在那里找到全部构建历史。

测试 🧪

FastMediaSorter v2 使用 Maestro 进行端到端测试，以确保应用的质量和可靠性。

快速运行测试

# Install Maestro - macOS/Linux (Homebrew)
brew tap mobile-dev-inc/tap
brew install maestro

# Or Linux/macOS (curl)
curl -Ls "https://get.maestro.mobile.dev" | bash

# Windows (PowerShell as Administrator) - External: install.ps1 is the Maestro installer
Invoke-WebRequest -Uri "https://get.maestro.mobile.dev/install.ps1" -OutFile install.ps1
.\install.ps1  # External: Maestro installer
Remove-Item install.ps1  # External: Maestro installer

# Run smoke tests (2-3 minutes)
./maestro/run-tests.sh smoke    # Linux/macOS
.\maestro\run-tests.ps1 smoke   # Windows

# Or use shortcut
.\scripts\utils\run-maestro-smoke.ps1  # Windows

注意： 请勿使用 npm install -g maestro-cli - 那是一个完全不同、不相关的包！

测试套件

相关文档

CI/CD 集成

每次推送都会通过 GitHub Actions 自动运行测试。参见 .github/workflows/maestro-tests.yml。

快速上手指南 🚀

  1. 添加文件夹（资源）：
    • 在主界面上，点按带有 “Plus”（+）图标的按钮以添加新资源。
    • 选择资源类型（例如 “Local Folder”）。
    • 使用扫描功能或手动添加文件夹。添加后，它会出现在主界面的列表中。
  2. 查看文件：
    • 双击（或长按）列表中已添加的资源。
    • 浏览界面会打开，你会以列表或网格形式看到该文件夹中的所有媒体文件。
    • 使用顶部面板上的按钮进行排序、筛选或切换视图。
  3. 播放与分类：
    • 点按任意文件，在全屏播放器中打开它。
    • 使用左右滑动或触控区域在文件之间导航。
    • 需要执行操作（复制、移动）时，使用控制面板上对应的触控区域或按钮。
  4. 配置目标文件夹（Destinations）：
    • 在设置的 “Destinations” 标签页中，你最多可以指定 30 个用于快速分类的文件夹。
    • 或者，在任意资源的编辑界面中启用 “Is Destination”，将其加入快速分类列表。
    • 之后，播放器界面上就会出现用于快速复制或移动文件到这些文件夹的按钮。

技术栈

构建版本号

版本号格式：Y.YM.MDDH.Hmm（例如 2.60.1102.207 对应 2026/01/10 20:07）

详细的发布说明参见 dev/CHANGELOG.md。

贡献 🤝

欢迎提交 Pull Request。如涉及较大改动，请先创建一个 issue 讨论你想做的更改。

联系方式 📧

许可证 📄

项目法律信息：