A self-hosted tool that automatically searches and imports movies/TV shows from Telegram, providing instant streaming with caching and automatic episode tracking.

Stars

38

7-day growth

No data

Forks

10

Open issues

1

License

MIT

Last updated

2026-07-17

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It combines Telegram sourcing, AI-powered media matching, and multi-platform deployment (NAS, Windows, Android) into one streamlined pipeline with built-in proxy and cache streaming.

Who it is for

  • NAS owners running fnOS, Docker, or Jellyfin/Emby
  • Media enthusiasts who want to automate library building from Telegram
  • Self-hosting users comfortable with configuring Telegram and API keys
  • Android TV users seeking a simple remote-controlled media search tool

Use cases

  • Automatically download and organize movies and TV series from Telegram channels/bots
  • Stream media instantly with progressive caching and resume from where you left off
  • Set up auto-tracking for ongoing TV series to fetch new episodes as they appear
  • Use on a TV or tablet with a dedicated remote-friendly interface for browsing and playing

Strengths

  • Multi-platform support: fnOS app, Docker, Windows exe, Android APK (phone/tablet/TV)
  • AI matching via DeepSeek for accurate identification and natural language queries
  • Built-in caching and streaming with pre-fetch, LRU eviction, and local resume
  • Integrated proxy (vmess/vless/xray) for Telegram connectivity without extra tools

Considerations

  • Requires a personal Telegram account and a resource bot; using public groups risks account ban
  • Dependence on a DeepSeek API key for AI matching; falls back to regex without it
  • Pre-fetch concurrency must stay low (≤5) to avoid Telegram flood-wait rate limits

README quick start

飞影 feiying — 发个片名,自动入库秒播

输入一个片名(电影或剧名,甚至"诺兰讲原子弹那部"这种模糊描述),飞影自动帮你从 Telegram 搜到、入库,点开秒播、边看边缓存、断点续缓、剧集自动追更

一套核心,四种形态,覆盖 NAS 和随身设备:

平台形态播放
飞牛 fnOS应用中心 fpk 一键安装飞牛影视 / Emby
任意 NAS/服务器Docker Compose飞牛影视 / Emby / Jellyfin
Windows免安装 exe(Releases 下载 zip)内置 mpv 播放器
Android 手机/平板APK 直装(Releases 下载)内置 ExoPlayer,可转外部播放器
Android TV/盒子同一个 APK,装上自动进大屏遥控模式内置 ExoPlayer,遥控快进/暂停

能干什么

  • 🔎 多种资源源:TG 频道直传视频 / 搜索 bot(如极搜)/ 深链令牌 bot(如 Youxiu_bot,自动翻页收全集)/ 多源兜底
  • 🧠 AI 智能匹配(deepseek):从一堆杂乱结果里挑出正确的正片,解析集数,自然语言片名理解,排除盗名/预告/花絮等无关结果
  • 🎬 电影 & 剧集自动分类:电影进电影库、剧集进剧集库;分段电影做成上下集顺序播
  • 缓存流播:秒开、多连接预取、看过的本地秒回、滚动预取下一集、LRU 自动淘汰
  • 📺 自动追更:入库的剧自动追,定时查新集、只补新增、更新发到你的 TG 收藏夹
  • 🔒 内置网络代理:填一个 vmess/vless 链接即可连接 Telegram,内置 xray
  • 🛠 Web 配置/状态页 + 进程内自愈看门狗

你只需要准备 5 样

  1. TG 账户(手机号,用来登录/搜索/拉流)
  2. 一个资源机器人 bot(如 Youxiu_bot、极搜 bot,或你自己的影视频道)。⚠️ 务必填机器人/自有频道,不要填公开群组——往公开群反复发片名容易被 TG 反垃圾系统误判,导致账号被禁言
  3. 一种连 Telegram 的方式(三选一:vmess://或vless:// 链接→内置 xray;现成的常驻代理→填 socks5://ip:port;网络本身能直连 TG(旁路由/透明代理/海外)→什么都不填)
  4. 一个 deepseek API key(AI 匹配;留空则退化为正则匹配)
  5. 两个媒体文件夹(剧集库 + 电影库,挂进容器,媒体服务器指向它们)

部署

方式一:飞牛 fnOS 一键安装(不会 Docker 选这个)

Releases 下载 feiying_x.y.z_x86_64.fpk,飞牛应用中心 → 手动安装 → 选择文件,向导里填好剧集/电影目录即可,装完点桌面「飞影」图标进配置页。详见 fpk/README.md

注意:fpk 和下面的手动 Docker 部署二选一,不要混用(compose 项目同名,卸载会互相影响)。

方式二:Windows 桌面版(不用 NAS)

Releases 下载 feiying-desktop_x.y.z_win64.zip,解压双击 feiying.exe——窗口里配置,媒体库点集数即用内置 mpv 播放,数据在 %APPDATA%\feiying。详见 desktop/README.md

方式三:Android 版(手机 / 平板 / 电视,同一个 APK)

Releases 下载 feiying-android_x.y.z_arm64.apk 直接安装(允许未知来源)。手机开着翻墙 App 就不用配代理,内置 ExoPlayer 播放器拖动丝滑,格式不支持可一键转外部播放器(mpv-android/VLC)。国产 ROM 记得给「无限制后台」权限。

电视/盒子大屏模式:装同一个 APK(U 盘或当贝远程推送),自动识别 TV 进入遥控界面——电视上只有「搜索 + 媒体库」大按钮,方向键导航、OK 播放;全部配置在同一 WiFi 下用手机/电脑浏览器打开电视屏幕顶部显示的 http://电视IP:27125 完成,遥控零输入。详见 android/README.md

方式四:Docker Compose

镜像已发布在 Docker Hub([`mn49401

Description

飞影 feiying — 发个片名自动入库到飞牛/Emby:Telegram 多源发现 + AI 智能匹配 + 缓存流播 + 剧集自动追更,单 Docker 容器

Related repositories

Similar projects matched by category, topics, and programming language.

S40911120
Featured
S40911120 GitHub avatar

recensa

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts into a local SQLite database, enabling full-text search, replay, and audit of all past agent conversations without uploading data anywhere.

AI & Machine LearningLarge Language Models
67
uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941
0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577