Bridgex 🌉

Bridgex is an open‑source desktop application for converting files to Markdown, built in Rust with Freya and the Markitdown crate. It provides a lightweight graphical interface for editing converted Markdown content and saving it locally.

This repository maintains Rust packaging for crates.io, and also keeps Python packaging metadata so a compatible distribution can be published to pypi.org for interoperability.

Features ✨

• Native Rust desktop app with Freya UI.
• Cross‑platform support for Windows, macOS, and Linux.
• Efficient file‑to‑Markdown conversion.
• Lightweight editing before saving.
• Modular architecture for future extensions.

Screenshots 🖼️

Example of Bridgex’s main window.

View interface previews

Name	Preview
Main Screen
LLM Config
Markdown Render

Installation 📦

Rust / crates.io installation

Requirements:

• Rust toolchain with cargo
• Recommended stable Rust version

Build and install locally from the current source tree:

cargo install --path .

Install the published crate from crates.io:

cargo install bridgex

Run directly from source:

cargo run --release

For a release build:

cargo build --release
./target/release/bridgex

Python / PyPI installation

On Windows and macOS, install the compatible PyPI wheel:

pip install bridgex

Run the installed command:

bridgex

(If needed, you can also run it with python -m bridgex.)

On Linux, use the prebuilt Linux binary from SourceForge instead of PyPI:

https://sourceforge.net/projects/bridgex/

Although Bridgex is implemented in Rust, the repository also includes Python packaging metadata to preserve compatibility with pypi.org as a secondary distribution target for Windows and macOS wheels.

Local Cloning and Execution 💻

Clone the repository and run Bridgex locally:

1. Clone the repository.

git clone https://github.com/Dev2Forge/bridgex.git

2. Navigate to the project directory.

cd bridgex/src/bridgex

3. Build and run the application.

cargo run --release

4. To install the binary locally:

cargo install --path .

Basic Usage 🚀

1. Run the application from the terminal or the installed binary.
2. Select the file to convert.
3. Review and edit the Markdown result.
4. Save the file in Markdown format.

Supported Formats 📂

Bridgex currently supports opening and converting the following file formats:

• Excel (.xlsx, .xls)
• Word (.docx)
• PowerPoint (.pptx)
• PDF (.pdf)
• HTML (.html, .htm)
• Images (.jpg, .jpeg)
• CSV (.csv)
• RSS / XML (.xml, .rss, .atom)
• ZIP archives (.zip)

Limitations ⚠️

Bridgex is not an IDE, text editor, Markdown editor, or full document viewer. It is designed to bridge users to Markdown conversion with lightweight editing and a simple interface.

Releases 🏷️

Check the published versions and release notes in the Releases section of the repository.

Dependencies and Licences 📚

This project uses third‑party libraries with their own licenses. See the third-party folder for details.

Contribute 🤝

Contributions are welcome. Please open an issue or pull request following community best practices.

Licence 📄

Distributed under the GPLv3 Licence.

©2025–2026 Dev2Forge