FLUTTER ECOSYSTEM

singleton-altman/MoviePilotLite

Mobile MoviePilot, implementado com Flutter.

Ver no GitHub ↗

Stars: 437
Forks: 33
Último push (UTC): 18 de set. de 2026
Status do projeto: Ativo

GITHUB User

俊臣 ↗

Open Code. Better World.

just say hishanghai

LinguagensDartHTMLSwiftTypeScriptRubyKotlinShellObjective-C

Tópicos técnicos

# app # flutter # moviepilot # nas

Dependências usadas

Lista de dependências 49 itens

flutter{"sdk":"flutter"}
flutter_localizations{"sdk":"flutter"}
cupertino_icons^1.0.8
dio^5.7.0
dio_cookie_manager^3.1.1
get^4.7.2
freezed_annotation^2.4.4
json_annotation^4.9.0
cookie_jar^4.0.8
hive_ce^2.10.0
hive_ce_flutter^2.3.0
cached_network_image^3.4.1
flutter_cache_manager^3.4.1
flutter_svg^2.0.10+1
flutter_markdown^0.7.7+1
flutter_markdown_plus^1.0.7
talker^5.1.13
talker_flutter^5.1.13
talker_dio_logger^5.1.13
syncfusion_flutter_charts^31.1.25
intl^0.20.2
shared_preferences^2.3.2
skeletonizer^2.1.2
url_launcher^6.3.2
path_provider^2.1.5
palette_generator^0.3.3+7
webview_flutter^4.4.2
webview_flutter_android^3.12.0
webview_flutter_wkwebview^3.9.4
soft_edge_blur^0.1.3
image_picker^1.1.2
file_picker^11.0.2
share_plus^12.0.2
package_info_plus^9.0.0
jpush_flutter^3.1.8
altman_downloader_control{"git":"https://github.com/singleton-altman/altman_downloader_control.git"}
altman_totp{"path":"./altman_totp"}
lottie^3.3.3
flutter_floating_bottom_bar^2.0.2
native_glass_navbar{"path":"third_party/native_glass_navbar"}
flutter_testDesenvolvimento{"sdk":"flutter"}
flutter_lintsDesenvolvimento^5.0.0
build_runnerDesenvolvimento^2.4.9
hive_ce_generatorDesenvolvimento^1.8.0
freezedDesenvolvimento^2.4.8
json_serializableDesenvolvimento^6.8.0
flutter_gen_runnerDesenvolvimento^5.12.0
flutter_launcher_iconsDesenvolvimento^0.14.2
path_provider_androidDesenvolvimento^2.3.1

Rankings

Rising#42 Production#238

README original

Texto original em inglês. Visite o GitHub para a versão atual.

Expandir / recolher README

MoviePilot Mobile

基于 MoviePilot 的 Flutter 跨端客户端，对接 MoviePilot v2 API，在手机上完成订阅、搜索、下载、整理与系统运维等常用操作。

当前版本：1.1.8 · API 文档：api.movie-pilot.org

平台支持

平台	说明
Android	正式支持；设置页可检查 Release 并热更新 APK
iOS	正式支持；TestFlight / 自签；订阅日历 Widget
macOS	桌面端构建
Web	功能预览（非主维护目标）→ 在线体验
HarmonyOS	独立分支 `ohos`，HAP 需自签证书安装

快速开始（开发）

环境

Flutter 3.38+ / Dart 3.8+
Android SDK / Xcode（按目标平台准备）
可连接的 MoviePilot 服务端

常用命令

flutter pub get
flutter analyze
flutter test
flutter run

# 代码生成（Freezed / JSON / Hive 等）
dart run build_runner build --delete-conflicting-outputs

# 构建
flutter build apk --release --dart-define=FLUTTER_APP_ENV=release
flutter build ios
flutter build macos

依赖说明

altman_downloader_control 为 Git 依赖，CI 会在 flutter pub get 前执行 flutter pub upgrade altman_downloader_control，避免 lockfile 中的旧 commit。
本地若需同步该库最新代码，可手动执行上述 upgrade 后再 flutter pub get。
已提交的 form_block_models.freezed.dart 存在已知生成问题，勿随意全量 regenerate，除非已修复源模型。

App 推送

推送依赖 MoviePilot-Plugins 中的 APPLitePush 插件，由作者提供转发服务，无需自建推送平台。

使用前准备

前往 http://106.14.89.6/apply 申请 App Push Token
加入 Telegram 群，申请完成后 @ 管理员 确认
在 MoviePilot 中安装 APPLitePush 插件
在系统 / App 设置中 开启推送通知权限

iOS（TestFlight / 自签）

安装包 Bundle ID 必须为 com.altman.moviepilot，否则无法完成推送绑定
TestFlight 与自签用户使用同一套配置流程，均走作者转发服务，无需自行部署 JPush / APNs 转发

插件绑定步骤：

在插件配置中填写 Push Key（Telegram 群获取）与 App Push Token（步骤 1 申请）
点击保存
点击应用（App 内完成 alias 绑定）
点击 发送测试消息 — 正常情况下应收到一条推送

建议使用 Release 包安装；Debug 包可能无法正常收到推送。

Android

流程与 iOS 相同：申请 Token → Telegram @ 管理员 → 安装插件 → 按上述步骤填写 Push Key / App Push Token → 保存 → 应用 → 发送测试。当前未配置厂商通道，到达率不保证。

限制与说明

推送走作者阿里云转发服务器，单 IP 每分钟最多 10 条
服务可能因成本原因调整；TestFlight 名额有限
收不到推送时请先确认：通知权限已开、Bundle ID 正确、已点击「应用」且测试消息已发送

社区与贡献

Telegram：小白裙
Issue：AltmanTech/MoviePilotLite
Release：singleton-altman/MoviePilotLite
更新日志：CHANGELOG.md
欢迎 Pull Request

技术栈

类别	选型
框架	Flutter
状态 / 路由	GetX
网络	Dio + Cookie 管理
本地存储	Hive CE；SharedPreferences
模型	Freezed + json_serializable
UI	Material 3 + Cupertino 组件混用
日志	Talker / Talker Dio
图表	Syncfusion Charts
推送	JPush（iOS/Android）

许可证

本项目采用 Business Source License 1.1 (BSL-1.1)。

允许查看与修改源代码
生产环境使用在特定条件下可能受限
2029-01-21 起自动转为 GPL-3.0

详见 LICENSE。

免责声明

本软件仅供学习交流，不得用于商业用途或违法犯罪活动
软件对用户行为不知情，一切责任由使用者自行承担

赞赏

若本项目对你有帮助，欢迎赞赏以支持持续维护。

赞赏码