L!bra

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

Native macOS video workflow suite. Drag-and-drop file and folder processing with metadata-aware sorting, deduplication, and sanitizer-first rename pipelines.

---

Features

• Fast Tool Navigation — home cards route directly to dedicated tool screens
• Dual Input Modes — every tool supports drag-and-drop and dialog-based selection
• Automatic Sanitization — filename and filepath sanitization always on during tool runs
• Metadata-Aware Workflows — resolution, orientation, and FPS classification with duplicate visibility
• Apple Silicon Native — arm64 build optimized for M1/M2/M3/M4 chips

---

Installation

1. Download the latest L!bra.dmg from Releases
2. Open the DMG and drag L!bra.app to /Applications
3. First launch — right-click the app → Open to bypass Gatekeeper on the ad-hoc signed build

---

Usage

1. Open a tool — select a card from the Home screen
2. Drop content — drag files or folders directly into the tool panel, or click Select Folder / Select Files
3. Processing starts automatically with sanitization enabled by default

---

Development

Requirements

• Python 3.14
• macOS 12.0+
• uv

Setup

git clone https://github.com/RazorBackRoar/Libra.git
cd Libra
uv sync
uv run python -m Libra.main

Build

razorbuild "L!bra"
# Output: dist/L!bra.dmg

Lint & Test

uv run ruff check .
uv run ty check src --python-version 3.14
uv run pytest tests/ -q

---

Project Structure

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

---

License

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