Bridgex 🌉

Bridgex is an open‑source graphical interface for converting files to Markdown, built in Python and based on Pyside6 (Qt for Python). Its objective is to simplify access to the Markitdown library through a straightforward, modular visual experience.

---

Features ✨

• Cross‑platform graphical interface.
• Efficient file‑to‑Markdown conversion.
• Modularity: easy to adapt and extend.
• Support for multiple input formats.
• Lightweight editing prior to saving.

---

Screenshots 🖼️

Example of Bridgex’s main window.

View interface previews

Name	Preview
Open File
Mini Editor
Convert
Change Language

---

Installation 📦

Requirements:

• Python ≥ 3.9 and ≤ 3.13

Install via pip:

pip install bridgex

Start Bridgex from the terminal:

bridgex

It is recommended to use a virtual environment. To customise supported formats, edit the requirements.txt file as needed.

---

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 and set up a virtual environment.

cd bridgex

3. Create a virtual environment.

python -m venv .venv

4. Activate the virtual environment.

# On Windows
.venv\Scripts\activate
# source .venv/bin/activate  # On Linux/MacOS

5. Install the required dependencies.

pip install -r requirements.txt

6. Run the application.

python -m src.bridgex

---

Basic Usage 🚀

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

---

Supported Formats 📂

Bridgex supports conversion of the following file formats:

• PDF (.pdf)
• Word (.docx)
• PowerPoint (.pptx)
• Excel (.xlsx, .xls, .csv)
• Outlook Messages (.msg)
• Text (.txt, .text)
• Markdown (.md, .markdown)
• JSON (.json, .jsonl)
• XML (.xml)
• RSS/Atom (.rss, .atom)
• HTML/MHTML (.html, .htm, .mhtml)
• ePub (.epub)
• Compressed files (.zip)
• Jupyter Notebooks (.ipynb)
• Other formats supported by Markitdown

---

Limitations ⚠️

Bridgex is not an IDE, text editor, Markdown editor, or document viewer. Its purpose is to serve as a bridgex between the user and Markdown conversion, offering lightweight editing without advanced editing features.

---

Releases 🏷️

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

---

Dependencies and Licences 📚

This project uses third‑party libraries, each with its own licence. See the third‑party folder for more information.

---

Contribute 🤝

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

---

Licence 📄

Distributed under the MIT Licence.

©2025 Dev2Forge