leolionart/media-library-manager

Profil leolionart

Dernière activité source enregistrée: 5 avril 2026 à 09:59

Catalogue SkillsMP mis à jour: 17 octobre 2026 à 00:09

skills collectés: 5

Étoiles GitHub: 1
Forks GitHub: 0

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

# Media Library Manager `media-library-manager` là ứng dụng local để quản lý thư viện media nằm trên: - ổ đĩa local - SMB shares - thư viện đã được Radarr hoặc Sonarr quản lý Trọng tâm hiện tại của dự án là: 1. kết nối nhiều root SMB hoặc local vào app 2. duyệt folder theo dạng inventory và tree để thao tác 3. scan tìm duplicate 4. build plan và preview/apply thay đổi 5. move folder vào đúng path mà Radarr hoặc Sonarr đang quản lý 6. dọn duplicate trong provider-managed folders 7. sửa các item provider bị hỏng path Ứng dụng không thay Radarr hoặc Sonarr. Nó là lớp điều phối filesystem và vận hành library. ## Documentation Nếu cần nắm dự án nhanh mà chưa muốn đọc code, bắt đầu từ: 1. [docs/ai-project-map.md](/Volumes/DATA/Coding Projects/media-library-manager/docs/ai-project-map.md) 2. [docs/current-features.md](/Volumes/DATA/Coding Projects/media-library-manager/docs/current-features.md) 3. [docs/architecture.md](/Volumes/DATA/Coding Projects/media-library-manager/docs/architecture.md) ## Current Product Shape Frontend hiện tại là React + Ant Design, được build vào: - [src/media_library_manager/static/app.js](/Volumes/DATA/Coding Projects/media-library-manager/src/media_library_manager/static/app.js) - [src/media_library_manager/static/styles.css](/Volumes/DATA/Coding Projects/media-library-manager/src/media_library_manager/static/styles.css) Backend là Python HTTP server, vừa serve static frontend vừa expose API nội bộ. App hiện có 5 màn chính: - `Overview` - `Library Finder` - `Library Cleanup` - `Library Path Repair` - `Settings` ### Overview Màn tổng quan để xem: - trạng thái runtime - tóm tắt root đã connect - duplicate summary - cleanup summary - path repair summary - trạng thái provider - current job - activity gần đây ### Library Finder Màn vận hành chính: - xem danh sách folder đã discover từ các root - xem tree thư mục theo root - chọn folder làm source hoặc destination - move folder - move vào Radarr hoặc Sonarr - scan duplicate - build plan - preview changes - apply changes - xem current job logs - cancel job đang chạy ### Library Cleanup Màn cleanup riêng cho duplicate files trong thư viện Radarr/Sonarr: - `Provider Duplicate Files`: scan folder từ Radarr hoặc Sonarr, nhóm các folder có nhiều candidate video file, rồi chọn file cần xóa - refresh report sau khi delete - xem cleanup logs ### Library Path Repair Màn sửa các item provider có path lỗi: - scan item path bị thiếu hoặc không hợp lệ - tìm folder phù hợp trong connected roots - cập nhật path trong provider - remove item khỏi provider mà không xóa media file - xem repair logs và search progress ### Settings Màn cấu hình: - quản lý connected roots - quản lý SMB profiles - cấu hình Radarr - cấu hình Sonarr - cấu hình sync options - manual sync Các khối `Canonical Targets` và `Managed SMB Folders` đã bị bỏ khỏi UI mới. ## SMB-Native Workflow Luồng hiện tại không yêu cầu mount share vào OS như luồng chính. Nguyên tắc: - SMB profile lưu host, share, username, password - root SMB được lưu bằng `storage_uri` - backend truy cập trực tiếp qua `smbclient` - `path` local pseudo chỉ dùng làm identity dễ đọc trong state/UI Ví dụ root SMB: ```text storage_uri = smb://Download/?connection_id=smb-1775287593611315000 path = /smb/smb-1775287593611315000/Download ``` App hiện hỗ trợ: - nhiều SMB profiles - nhiều roots trên cùng một profile - nhiều shares trên cùng một host - inventory phẳng và tree cho SMB roots ## Radarr / Sonarr App vẫn tích hợp Radarr và Sonarr như provider layer. Use case chính: - lấy danh sách movie hoặc series đang được provider quản lý - move folder download vào path đã có sẵn của provider - refresh lại provider sau khi move - sync lại provider sau `apply execute` Hiện tại app đã được xác nhận chạy với: - `https://movie.naai.studio/` - `https://tv.naai.studio/` Backend provider client gửi `User-Agent` browser-like để tránh reverse proxy / Cloudflare chặn request API. ## Current Backend APIs Các API chính đang dùng: - `GET /api/state` - `GET /api/process` - `GET /api/system/mounts` - `POST /api/process/cancel` - `GET /api/operations/folders` - `GET /api/operations/folders/children` - `GET /api/operations/folders/tree?depth=...` - `GET /api/smb/browse` - `POST /api/roots` - `POST /api/roots/bulk` - `DELETE /api/roots?path=...` - `POST /api/scan` - `POST /api/plan` - `POST /api/apply` - `POST /api/cleanup/scan` - `POST /api/cleanup/empty-folders/scan` - `POST /api/path-repair/scan` - `POST /api/path-repair/search` - `POST /api/path-repair/update` - `POST /api/path-repair/delete` - `GET /api/integrations/radarr/items` - `GET /api/integrations/sonarr/items` - `POST /api/integrations` - `POST /api/integrations/test` - `POST /api/sync` ## Current Job Model `current_job` được persist trong state, nên refresh vẫn thấy job đang chạy hoặc job vừa xong. Mỗi job hiện có: - `id` - `kind` - `status` - `message` - `summary` - `details` - `logs` - `cancel_requested` - `started_at` - `updated_at` - `finished_at` Các job dài như `scan`, `plan`, `apply` đều ghi log vào state. Ngoài ra còn có các job như: - `cleanup-scan` - `path-repair` `cleanup-scan` hiện bao gồm cả provider duplicate cleanup và empty duplicate folder cleanup. Cancel hiện là cooperative: - `POST /api/process/cancel` - state chuyển `cancel_requested = true` - job dừng ở safe point tiếp theo ## Local Run Chạy backend local: ```bash HOST=127.0.0.1 PORT=8766 ./run-dashboard.sh ``` Trong môi trường macOS hiện tại, cổng nên dùng là: ```text http://127.0.0.1:8766 ``` Không nên dùng `8765` nếu máy đang có app khác chiếm cổng. ## Frontend Development Source frontend nằm trong: - [frontend/](/Volumes/DATA/Coding Projects/media-library-manager/frontend) Chạy dev frontend: ```bash cd frontend npm install npm run dev ``` Khi chạy bằng Vite dev server, các request `/api/*` được proxy mặc định sang backend local: ```text http://127.0.0.1:8766 ``` Nếu backend chạy ở host hoặc port khác, có thể override trước khi chạy frontend: ```bash cd frontend MLM_DEV_API_TARGET=http://127.0.0.1:9988 npm run dev ``` Build frontend vào static bundle của backend: ```bash cd frontend npm run build ``` ## SMB Runtime Requirement Local runtime cần có `smbclient`. Ví dụ: ```bash # macOS brew install samba # Debian/Ubuntu sudo apt-get update && sudo apt-get install -y smbclient ``` ## Docker Project vẫn có thể chạy bằng Docker Compose. Chuẩn bị: ```bash cp .env.example .env mkdir -p data ``` Chạy: ```bash docker compose up -d ``` Mặc định mở: ```text http://localhost:9988 ``` ## Verification Kiểm tra backend: ```bash PYTHONPATH=src python3 -m unittest discover -s tests -p 'test_*.py' python3 -m py_compile src/media_library_manager/*.py src/media_library_manager/providers/*.py src/media_library_manager/storage/*.py ``` Kiểm tra frontend: ```bash cd frontend npm run build ```

Chargement du README du dépôt…

Skills dans ce dépôt

Développeurs de logiciels Administrateurs de réseaux et de systèmes informatiques Manutentionnaires à la main

3 catégories métier · 100% classifié

skill

métier

description

mis à jour

bulk-refresh

Développeurs de logiciels

Run controlled bulk provider path rewrites and refreshes with batching, progress checks, and failure tracking. Use when the user explicitly wants to rewrite many Radarr or Sonarr items with known paths, rerun provider refreshes in bulk, or measure whether…