Omni

Modern, scalable, and efficient solution for fast local file conversion via CLI.
→ Website · Report Bug · Request Feature

---

📦 What is Omni?

Omni is your no-cloud, developer-first CLI tool for blazing fast file format conversion. No telemetry, no lock-in — just raw performance and clean extensibility.

Born from the need for local-first tools with real power, Omni is engineered for devs who value speed, control, and clarity. ⚙️

---

🤔 Why Omni?

• You don’t want cloud uploads.
• You want extensibility without bloat.
• You care about performance.

Omni is built for:

• Developers 🧑‍💻
• Data wranglers 📊
• Automation engineers 🤖
• Security-conscious users 🔐

---

🔧 How It Works

Omni uses a plugin-like strategy system to select and run the right converter for each file type. Its clean, hexagonal architecture ensures easy testing, maintenance, and extension.

---

🚀 Features

• ⚡ Fast & efficient local file processing via CLI
• 🧠 Clean architecture with a focus on testability
• 🔌 Plugin system for easy extensibility
• 🧱 Hexagonal architecture (Ports & Adapters)
• 🧪 100% tested with JUnit

---

💠 Getting Started

git clone https://github.com/youruser/yourrepo.git
cd yourrepo
./gradlew build

To run:

java -jar omni.jar convert -i ./input.docx -o ./output.pdf -r docxReader -t pdf

---

⚙️ Activation System

Omni includes an optional license activation system for Pro features. Activation is simple and local:

onmi activate --key "YOUR_LICENSE_KEY"
omni deactivate
omni status

• 🔑 License keys are one-time purchasable
• 🖥️ Bound to your device fingerprint
• 📁 Stored in ~/.omni/config.json
• 📬 Keys are delivered by email

No cloud validation. Fully offline-capable.

---

🧪 Running Tests

./gradlew test

Or run tests via IntelliJ.

---

✨ Example Usage (Java)

FormatConverter<String, String> converter = new MyConverter();
String result = converter.convertTo("input");

---

🧰 Example Usage (CLI)

omni -i ./input/file.docx -o ./output/file.txt -p pretty

Parameters:

• -i or --input – Path to the input file
• -o or --output – Path to the output file
• -r or --rename – Renames original path

Flags may vary depending on implementation.

---

🌐 Project Website

https://getomni.sh

---

🤝 Contributing

Pull requests welcome! For major changes, open an issue first to discuss what you’d like to change.

---

📄 License

This project is licensed under the MIT License.

---

👤 Author

dev.jaron – GitHub • Website

---

Crafted with ❤️ by dev.jaron – Last updated: June 2025 ✅