L!bra

Workspace context source: /Users/home/Workspace/Apps/.code-analysis/ (AGENTS.md, monorepo-analysis.md, essential-queries.md).

██╗     ██╗██████╗ ██████╗  █████╗
██║     ██║██╔══██╗██╔══██╗██╔══██╗
██║     ██║██████╔╝██████╔╝███████║
██║     ██║██╔══██╗██╔══██╗██╔══██║
███████╗██║██████╔╝██║  ██║██║  ██║
╚══════╝╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝

Native macOS video workflow suite Drag-and-drop file/folder processing, metadata-aware sorting, and sanitizer-first rename pipelines in a gold/black L!bra UI.

---

✨ Features

• ⚡ Fast Tool Navigation - Home cards route directly to dedicated second screens
• 📂 Dual Input Modes - Every tool supports drag-and-drop files/folders plus dialog-based selection
• 🧼 Automatic Sanitization - Filename and filepath sanitization are always ON for tool runs
• 🧠 Metadata-Aware Workflows - Resolution/orientation/FPS classification with duplicate visibility
• 🖥️ Apple Silicon Native - PySide6 desktop app optimized for macOS

---

🚀 Quick Start

Fast Preview (Codex App)

Paste this in the Codex app Run box:

./run_preview.sh

Usage

1. Open a tool card from Home.
2. Drop files/folders directly into the tool panel, or click Select Folder (Auto Run) / Select Files (Auto Run).
3. Processing starts automatically with filename and filepath sanitization enabled by default.

Local Development

git clone <https://github.com/RazorBackRoar/Libra.git>
cd Libra
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --no-user -U pip pytest PySide6
pytest -q
PYTHONPATH=src python3 -m Libra.main
python3 main.py

---

🛠️ Video Tools

# Unified launcher (choose a mode)
PYTHONPATH=src python3 -m Libra.video_tools sorter
PYTHONPATH=src python3 -m Libra.video_tools duplicates
PYTHONPATH=src python3 -m Libra.video_tools apple
PYTHONPATH=src python3 -m Libra.video_tools batch /path/to/videos

Direct module entrypoints:

PYTHONPATH=src python3 -m Libra.video_tools.gui.video_sorter
PYTHONPATH=src python3 -m Libra.video_tools.gui.duplicate_finder
PYTHONPATH=src python3 -m Libra.video_tools.gui.apple_organizer
PYTHONPATH=src python3 -m Libra.video_tools.cli.batch_processor /path/to/videos

---

📦 Project Structure

L!bra/
├── main.py
├── run_preview.sh
├── src/Libra/
│   ├── main.py
│   ├── core/
│   ├── gui/
│   └── video_tools/
│       ├── core/
│       ├── gui/
│       └── cli/
├── docs/video_tools/
├── tests/
└── L!bra.spec

---

📜 License

MIT License - see LICENSE for details. Copyright © 2026 RazorBackRoar