安装依赖需加 --legacy-peer-deps,否则可能因 peer 依赖冲突失败;仓库代码通常领先于正式发布版,属 WIP 可能含 bug;跨架构构建 Mac 版时需手动替换 FFmpeg 和 FFprobe 可执行文件
npm install --legacy-peer-deps
npm startREADME 未说明具体硬件要求;支持 Windows、Mac、Linux,Mac 提供 M1 与 Intel 构建
本地视频库浏览与检索工具,像 YouTube 一样管理电脑里的视频文件
基于 Angular 和 Electron 的本地视频浏览与管理工具,用缩略图网格快速检索海量视频文件,支持标签筛选和 FFmpeg 提取预览。
核心能力
- 用 Angular + Electron 构建跨平台桌面应用
- 按目录扫描视频并生成可搜索的缩略图库
- 内置模糊搜索快速定位视频
- 可开启局域网服务器,用手机当遥控器播放
- 支持多语言界面与自定义图标
容易踩的坑
- v3.3.0Version 3.3.0 🎉 8.5 years 🥳最新正式版2026-09-01 · 2026-09-01 19:34 UTC
Eight and a half years since the first release 🥳
Thank you everyone for your patience; I had many house projects yet I finally found time to create another release. Massive thank you to the contributors on GitHub for adding features and fixing bugs. I hope to resume work on Video Hub App in 2027 🤞 especially the optional facial recognition feature I started working on six years ago now. Incomplete list of improvements below:
New Features
- build a playlist by clicking on icon in any video #964 / #967 / #968 / @sam9525 #903
- choose from 9 colors for manual tags @Akhileshait #911
CTRL+SHIFT+clickon thumbnail to set as default #942SHIFT+clickopens folder in explorer @aryanpal26 #876CTRL+SPACEplays random video (option in settings) #680- favorites-only view button #969
- settings to toggle visibility of specific metadata #986
- find videos where a word starts with search strig @Herty94 #832
- clear all filters button & shortcut @nallapaneni-sreehari #908
- click on number of videos found to clear all filters #944
- thumbnail of last-clicked video in top bar #963
- total selected count in batch tagging mode #965
- tag tray improvements: autocomplete based on frequency, ignore case, auto-focus, deselect button #977
- monospace font for many displayed numbers: prettier #973
Bug Fixes
- filter sliders fixed, no longer stuck or janky #953
- recently played videos remembered; sort by recently-played works #947
- scroll to top when switching tab in settings @sam9525 #892
- file size matches how your OS computes it #970 / @cmfc31
- fix broken color on notification @TudorGR #914
Maintenance
- upgrade to newer versions of FFmpeg, Angular, Electron, and Electron Builder
- modernize Angular codebase #949 / #954 / #955 / #956 / #957 / #972
- cleaning up the sorting pipe code @NabilBouazzaoui #960 / #824
- hide tray buttons from ribbon since the tray tabs are clickable #962
- making drag & drop work again after Electron removed previously-working method #984
Translations
- Traditional Chinese @ducdamchi #863 / #987
- improve Japanese @tmdsy #934
- improvements to Spanish @GeroJun #893 / #894 / #904
- v3.2.0Version 3.2.0 🎉 Fifth Anniversary 🥳2023-02-26 · 2023-02-26 23:28 UTC
查看更新说明
🥳 5th Anniversary Release 🎉
Thank you everyone for patience. Last two years were hard for me - moving to another state, working full time (still) while fixing things around the house. There is still so much to do around the house, but I intend to continue working on Video Hub App for years to come ❤️
New features:
- click on heart to make video "favorite" - thank you to @Sooyoung98, @sunnyliang6, @anitacheng19, and @joshHuang02 (#785)
- sort by last-time-played (#799)
- alphabetize input folders - thank you to @alzbuc (#703)
- compact view for filmstrip gallery - thank you to @semla (#706)
- sort auto-tags in alphabetical order option - thank you to @gabriel-kazimir (#774)
- "folder does not have" filter - thank you to @PiantaSE (#767) & @rokaicker (#772)
- folder over 1,000 shows "k" instead - thank you to @jmdagenais (#769)
- remember options from last hub creation - thank you to @23mwest (#736)
- show bitrate in details - thank you to @jozefkopcak (#714)
- year filter - thank you to @litelime (#677)
- quit menu on Mac - thank you to @martinriviere (#653)
- more Mac menu options - thank you to @flpcury (#692)
Bugfixes:
- dragging video outside of app does not cause error 😭
- magic search includes manual tags - thank you to @litelime (#742)
- avoid corrupting settings when quitting app abruptly - thank you to @CrendKing (#694)
- year visible in dark mode - thank you to @ryanleigh410 (#704)
- times played visible in dark mode - thank you to @arcadioramos (#720)
Maintenance:
- M1 version of the Mac app exists 🚀
- newer version of FFmpeg
- newest version of other libraries
- linting and minor fixes - thank you to @laurence-myers (#698)
Translations:
- Thank you @JesusMurguia for improvements to Spanish (#794)
- Thank you Glenn for improvements to Chinese (#716)
- v3.1.0Version 3.1.0 🎉2021-02-21 · 2021-02-21 02:15 UTC
查看更新说明
New features:
- remote control (browse, search, preview, and launch videos from phone or tablet)
- support MPV video player
- extract FPS and sort by it - thank you to @jleckron (#635)
- times played filter - thank you to @litelime (#612)
Bugfixes:
- scanning remote drive files should be super fast and have no error
- 720p will be correctly labeled when generating hub (thank you TripleYoThreat for catching and fixing)
- Mac copy/paste works
- no crash if settings file got corrupted somehow
Translations:
- Thank you @ciruz for improvements to German
- v3.0.0Version 3.0.0 🎉2020-12-01 · 2020-12-01 02:01 UTC
查看更新说明
New features:
- more than one source/input folder per hub 🎉
- live import of videos (no more green progress bar locking up the app during importing metadata)
- 'watch folder' live for updates
- bottom tray with Word cloud, Recently played, Details and other tabs
- you can set custom keyboard shortcuts
- regex search
- many more 😎
Bugfixes:
- too numerous to list
Thank you:
- @cal2195 for implementing the new importing process and for 'watch folder' functionality (using the
chokidarandasynclibraries) - @orkomlosh for minor UI fixes, allowing for random folder screenshots, additional extensions setting, internal code cleanup, new modal/notification system
- @CrendKing for sort by file creation date, fix bug for files with spaces, add video player launch arguments, restore correct window location when opening
- @HerrRobo for alternative alphabetical search that handles number ordering correctly (e.g. 1, 2, 10)
- @jamesd35 for 'select all' when batch tagging, portable app settings save next to executable, delete files bypassing recycling bin option
- @litelime for sort by number of videos, file size slider / filter
- @sezalmittal987 for single / double click mode
- @martincaron - for alphabetical sort case insensitive
Thank you for new translations:
- Łukasz B. - Polish
- @lighthunt - Czech & Vietnamese
- @ridvanaltun - Turkish
- @SuzannaWentzel - Dutch
🙇
There may be people I forgot to thank - please let me know if I missed you 🙇
- v2.2.3Version 2.2.32020-05-15 · 2020-05-15 20:24 UTC
查看更新说明
New features:
- Quick file rename (thanks to @byrw)
- Sort by number of tags (thanks to @Kotzlowski)
- Show default thumbnail in clip view option (thanks to @martincaron)
- Sort by aspect ratio (thanks to @martincaron)
- Batch tagging
- Details view 2
- Check for new release button in settings
Bugfixes:
- Save settings when closing via menu bar / taksbar (thanks to @martincaron)
🙇♂️🙇♂️🙇♂️ Thank you to all the financial contributors who continue to purchase the app, and to those who pay more than the minimum to encourage further development
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Video Hub App 3
Video Hub App 3 is the fastest way to browse, search, and organize videos on your computer. Think of it like YouTube for videos on your computer. Works on Windows, Mac, and Linux!
Download Now
This software is available for $10.00 through videohubapp.com
Over $16,000 donated from the sale of this software to the cost-effective charity Against Malaria Foundation. See donation history
About
Video Hub App was created by Boris Yakubchik. It uses the frameworks Angular and Electron.
License
This software was built on top of angular-electron by Belnadris. It carries an MIT license (see the LICENSE file). While the license is permissive, I ask that you do not distribute free copies of this software unless you have significantly changed it.
Contributing
I would love to see the improvements you make to this app and am happy to accept pull requests. See issues for ideas for improving this app or to add your suggestions.
Please consider improving any of the translations, or add a new translation!
Please consider improving or adding an icon to the app. It's a simple process, just follow the instructions!
Upcoming features
See issues for what is in progress.
Development
⚠ The repository is usually ahead of the publicly released version - it is 🚧 WIP and may have bugs in it.
How to start:
npm install --legacy-peer-depsto installnpm startto developnpm run electronto build
Main dependencies in use:
| Library | Version | Date | Comment |
|---|---|---|---|
| Angular | v20 | Oct 2025 | |
| Angular-CLI | v20 | Oct 2025 | |
| Electron | v42 | Jun 2026 | (internally uses Node v24.16.0 and Chromium 148) |
| Electron Builder | v26 | Oct 2025 |
-
Node: It may be best to use the same version as Electron uses internally (
v24.16.0) -
Angular CLI: not required but may be useful: Angular CLI.
-
Mac: We now have
M1andIntelbuilds, but you may need to manually update the FFmpeg and FFprobe executables if you're building for a different architecture than you are on.
To help debug a production build of VHA you can use Debugtron
Remote
👩🚀 a new feature in VHA is the option for the user to turn on a server after the app starts. This will let the user open a simpler version of the VHA user interface on their phone or tablet (if both PC and device are on the same WiFi) and use it as remote control to play videos 🚀
For details, see instructions.
Thank you
This software would not be possible without the tremendous work by other people:
- Angular
- Electron
- FFmpeg
- angular-electron
- ngx-virtual-scroller
- fdir
- async
- chokidar
- trash
- Fuse.js
- electron-window-state
This software uses libraries from the FFmpeg project under the LGPLv2.1 with binaries from here
Since becoming open source, this software was made better with the awesome contributions by cal2195