❓ Why OSGi.fx?

OSGi.fx is the ultimate remote management tool for your OSGi frameworks. Unlike legacy consoles, it offers a modern, responsive JavaFX interface that gives you:

• 🚀 Deep Insights: Visualize bundles, services, users, and components instantly.
• ⚡ Real-time Monitoring: Track threads, heap usage, and logs live.
• �️ Visual Dependencies: Explore complex relationships with interactive graphs.
• ✨ Ease of Use: Drag-and-drop installs, smart auto-complete, and valid configuration editing.

�📸 Gallery

🛠️ Tech Stack

| Component | Technology | | :--- | :--- | | ☕ Java (Application) | 25 | | ☕ Java (Agent) | 1.8 | | 🖥️ Rich Client Platform | JavaFX 25 | | ⚙️ Runtime (Application) | OSGi R8 (Equinox), Eclipse 4 (e4), e(fx)clipse | | ⚙️ Runtime (Agent) | OSGi R6 | | 🎨 UI Libraries | ControlsFX, TilesFX, FormsFX | | 🛠️ Software Tools | Bndtools 7.2.1 |

🚀 Getting Started

The latest released version is 2.4.4.

📥 Download & Install

Visit the Project Website to download and install the latest version for your platform.

For detailed instructions, please refer to the User Guide on the website or check our local User Guide.

✨ Features

| Feature | Version | Implemented | Released | | :--- | :---: | :---: | :---: | | 📦 Bundle Inventory View all installed bundles and fragments | 2.4.4 | ✅ | 🚀 | | 📦 Package Insights Explore exported and imported packages | 2.4.4 | ✅ | 🚀 | | 🛠️ Service Registry Inspect all registered OSGi services | 2.4.4 | ✅ | 🚀 | | 🧩 Component Viewer Visualize declarative services (DS) components | 2.4.4 | ✅ | 🚀 | | ⚙️ System Properties Access robust system and framework properties | 2.4.4 | ✅ | 🚀 | | 🧵 Thread Monitor Track daemon and non-daemon threads | 2.4.4 | ✅ | 🚀 | | 📢 Event Emitter Dispatch synchronous or asynchronous events | 2.4.4 | ✅ | 🚀 | | 👂 Event Listener Subscribe to OSGi events in real-time | 2.4.4 | ✅ | 🚀 | | 📝 Log Stream Live streaming of OSGi logs | 2.4.4 | ✅ | 🚀 | | logger R7 Logger Config Manage OSGi R7 logger levels and configurations | 2.4.4 | ✅ | 🚀 | | 🐚 Gogo Shell Execute Gogo commands remotely | 2.4.4 | ✅ | 🚀 | | 💻 CLI Executor Run system CLI commands directly | 2.4.4 | ✅ | 🚀 | | ✨ Smart Auto-Complete Intelligent suggestion for remote Gogo commands | 2.4.4 | ✅ | 🚀 | | 📥 Bundle Manager Install, update, starting and stopping bundles | 2.4.4 | ✅ | 🚀 | | 🖱️ Drag & Drop Install Effortless bundle installation via drag-and-drop | 2.4.4 | ✅ | 🚀 | | 🔧 Config Admin Manage configurations via ConfigurationAdmin | 2.4.4 | ✅ | 🚀 | | 📋 Metatype Inspector Browse OCDs and property descriptors | 2.4.4 | ✅ | 🚀 | | ⏯️ Bundle Lifecycle Start, stop, and uninstall bundles/fragments | 2.4.4 | ✅ | 🚀 | | ⚡ Component Control Enable or disable DS components on the fly | 2.4.4 | ✅ | 🚀 | | ✏️ Config Editor Create, update, and delete configurations | 2.4.4 | ✅ | 🚀 | | 🏗️ Config Factory Instantiate new configurations from factory PIDs | 2.4.4 | ✅ | 🚀 | | 📊 Runtime Dashboard Overview of memory, uptime, bundles, threads, and services | 2.4.4 | ✅ | 🚀 | | 🕸️ Bundle Graph Visualize bundle dependencies interactively | 2.4.4 | ✅ | 🚀 | | 🔗 Component Graph Visualize DS component references and dependencies | 2.4.4 | ✅ | 🚀 | | 🔄 Cycle Detector Identify circular dependencies in DS components | 2.4.4 | ✅ | 🚀 | | 📤 Graph Export Export dependency graphs to DOT (GraphViz) format | 2.4.4 | ✅ | 🚀 | | 📂 Log Viewer Access and analyze application log files | 2.4.4 | ✅ | 🚀 | | 🕵️ Leak Detector Identify suspicious classloader leaks | 2.4.4 | ✅ | 🚀 | | 🌐 HTTP Runtime Inspect Servlets, Filters, and Resources | 2.4.4 | ✅ | 🚀 | | 📈 Heap Monitor Real-time heap usage and GC tracking | 2.4.4 | ✅ | 🚀 | | 🔌 Extension Manager Install and manage external plugins | 2.4.4 | ✅ | 🚀 | | 🗑️ Extension Uninstaller Remove installed extensions easily | 2.4.4 | ✅ | 🚀 | | 📜 OBR Generator Generate OBR XML repositories | 2.4.4 | ✅ | 🚀 | | 🌲 DMT Explorer Traverse and update the Device Management Tree | 2.4.4 | ✅ | 🚀 | | 👥 User Admin Manage roles, users, and groups | 2.4.4 | ✅ | 🚀 | | ❤️ Health Checks Execute and monitor Felix Health Checks | 2.4.4 | ✅ | 🚀 | | 📸 Snapshot Capture and analyze runtime state snapshots | 2.4.4 | ✅ | 🚀 | | ℹ️ DTO Inspector Explore standard OSGi Runtime DTOs | 2.4.4 | ✅ | 🚀 | | 🔍 Advanced Search Powerful search across the OSGi framework | 2.4.4 | ✅ | 🚀 | | 🤖 MCP Support Model Context Protocol integration for AI agents. Read More | 2.4.5 | ✅ | 🚧 | | 👻 Headless Launch Start application with pre-configured connection | 2.4.5 | ✅ | 🚧 |

💡 Troubleshooting & Tips

• 👻 Headless Mode: Starting from 2.4.5, need to connect without the connection wizard? Use the -Dosgifx.config=/path/to/config.json system property to launch OSGi.fx with a pre-defined connection. See the Headless Launch Documentation.
• 🤖 AI Assistance: OSGi.fx 2.4.5 supports the Model Context Protocol (MCP), allowing AI agents to connect to and debug your OSGi runtime directly! See the MCP Server Documentation.

👨‍💻 Maintainer

Amit Kumar Mondal ([email protected])

🤝 Contributing

Want to contribute? Great! Check out Contribution Guide

📄 License

This project is licensed under Apache License Version 2.0