Vue 3 rewrite
MediaChips v0.13.0 is a major release: a full rewrite of the application on a modern stack while keeping the same core idea — organize local media, attach rich metadata, filter, and play files from your own library.
🌐 Website: mediachips.app
📖 Installation: INSTALLATION.md
🕰 Previous version (Vue 2): v0.12.5-beta · branch legacy/vue2
Highlights
- Vue 3 rewrite — new UI on Vue 3, Vite, Vuetify 3, and Pinia
- Modern desktop stack — Electron 39, Express 5, Sequelize + SQLite
- Local AI tools — path tag parser and optional video frame recognition (runs locally, no Python)
- Database migration — import from legacy LowDB databases (Vue 2 era)
- LAN access — browse your library from other devices on the local network
- Privacy unchanged — no telemetry, no data collection, fully open source (GPL-3.0)
Added
- Full Vue 3 + Vite + Vuetify 3 frontend rewrite
- Local path tag parser with optional ML-based semantic matching (
@xenova/transformers) - Video object recognition — suggest tags from video frames using a bundled local CLIP model
- Migration from LowDB — move data from older MediaChips databases (Vue 2)
- In-app documentation with contextual help in settings and dialogs
- Improved file moving — progress reporting, free disk space checks, cross-drive copy support
- Navigation menu visibility settings
- Metadata pinning improvements in media and tag edit dialogs
- Docker support (
Dockerfile,docker-compose.yml) - Redesigned media and tag editing dialogs with a compact hero layout
- Mobile-friendly navigation and stats cards on the home page
Changed
- Default branch
masternow contains the Vue 3 codebase (clean release history) - Build system moved from Webpack → Vite
- State management moved from Vuex → Pinia
- Backend updated to Express 5 with an improved task and WebSocket layer
- Player layout and fullscreen behavior refined
- README and installation docs rewritten in English
Fixed
- Player video wrapper height constraints in fullscreen and normal mode
- Various UI issues in mobile navigation and home page widgets
Upgrade from v0.12.x
| Topic | Details |
|---|---|
| Vue 2 users | Stay on legacy/vue2 or v0.12.5-beta |
| Database | Use the built-in LowDB → SQLite migration in Settings when upgrading from older versions |
| Backup first | Create a database backup before migrating |
| Clean install | You can also start fresh with v0.13.0 and import media again |
⚠️ This is a major rewrite, not a small patch. Test migration on a backup copy of your database before switching your main library.
Downloads
| Platform | File |
|---|---|
| macOS | MediaChips-0.13.0.dmg |
| Windows | MediaChips-0.13.0-win.exe (installer) / portable build |
| Linux | MediaChips-0.13.0.AppImage |
macOS note: the app is self-signed. If macOS blocks launch, see INSTALLATION.md.
Build from source
git clone https://github.com/fupdec/mediaChips.git
cd mediaChips
npm install
npm run download-parser-model # optional: ML models for tag suggestions
npm run build
npm run server # or: npm run electronSee README.md for full development instructions.
Legacy codebase
The Vue 2 version remains available:
git checkout legacy/vue2All previous releases and tags are preserved.
Feedback
Full Changelog: first public Vue 3 release — no prior commits on master (legacy history is on legacy/vue2)