FiBridge 📱🌉💻

FiBridge is a local web application for secure and convenient file and data sharing between PC and mobile devices, only using the default browser. 🔗📱💻

• Your PC and mobile must be connected to the same network.
• No USB cable needed.
• No bluetooth needed.
• No additional software or app needed.
• No administrative privileges needed.
• No jailbreak (iOS) or root (Android) required. 🚫🔓
• No privacy exclosure risks!

Ensuring seamless flow between PC and mobile devices, FiBridge also ease your life by providing the following interesting features:

• Generate logo embedded QR code
• Scan QR code using your PC, when your want to open the link on PC
• Sign your name using your finger, instead of mouse, without an apple pencil
• Send photos from phone to PC without a USB cable
• Save documents on your phone, using it as a wireless hard drive. This is especially attractive to iPhone users.
• More to explore...

Main Functions ✨

FiBridge can transfer text, (drawing) images, and files between your PC and mobile device in a fast and convenient way. It supports most hardware platforms and operating systems, including PC with Windows or Linux, iphone, iPad, and Android devices. The main features include:

Text transfer via QR code scanning 📄➡️📱

• QR Code Generator: Generate logo-embedded QR codes Locally. No more online QR generators! 🔳
• Remote Scan: Use your phone to scan QR codes and send the result back to your PC. 📲

Image transfer via drawing or signing on mobile device 🎨✍️

• Draw & Sign: Draw or sign on your device and transfer the image to your PC. 🖼️

File transfer between PC and mobile device 📁🔄

• File Share: Transfer files from your PC to your mobile device via browser. 📤
• File Fetch: Transfer files from your mobile device to your PC. 📥

Installation ⚙️

Requirements 📋

• Windows, Linux, or macOS 🖥️
• Python 3.7 or higher (recommended: Python 3.10+) 🐍
• pip (Python package manager) 📦
• (Optional) Potrace for saving drawing as vector.

Clone & Install ⬇️

Clone the repository and install all dependencies:

git clone https://github.com/paradoxsolver1997/FiBridge.git
cd FiBridge
pip install -r requirements.txt

Run the Application ▶️

Start the desktop app:

python main.py

• By default, the local web server is closed. Configrue it in "Server Setup" and click "Start Server". 🖱️
• Check help for how to use the app. ℹ️

SSL keys Setup 🔐

The remote scan requires HTTPS protocol to access cameras. To enable HTTPS (recommended for security):

1. Generate a self-signed certificate using the provided script. In the root folder:
   • On Windows:

     scripts\generate_cert.bat

   • On Linux/macOS:

     bash scripts/generate_cert.sh

2. The generated key.pem and cert.pem will be placed in the root directory. 📁
3. Update your Flask app configuration to use these certificate files for SSL. 🔒

Installing Potrace

Potrace is a tool that transforms a binary bitmap into vector. It is required for saving drawing or signatures as vectors. Follow the official guide to download and install Potrace.

Important: you MUST add the path of the Potrace executable to the $PATH environment variable (Windows or Linux) such that the app can find it. If successful, the Tool Check panel of the app shows a tick.

If Potrace is not installed, you can still use the other features of FiBridge. You can save drawing or signatures only as bitmaps.

File Structure 🗂️

FiBridge/
├── main.py                # Main entry, starts the Flask server
├── requirements.txt       # Python dependencies
├── README.md              # Project documentation
├── LICENSE                # Open source license
├── configs/               # Configuration files (e.g., SSL certificates)
├── output/                # Uploaded/shared files storage
├── static/                # Frontend static resources
│   ├── index.html         # Main entry page (dashboard/portal)
│   ├── help.html          # User help and documentation
│   ├── scan.html          # Remote scan page (scan QR codes, send result to PC)
│   ├── share.html         # File share page (PC to mobile file download)
│   ├── fetch.html         # File fetch page (mobile to PC file upload)
│   ├── text.html          # Direct text sending page
│   ├── js/                # JavaScript files for each page
│   │   ├── scan.js        # Logic for scan.html
│   │   ├── share.js       # Logic for share.html
│   │   ├── fetch.js       # Logic for fetch.html
│   │   ├── text.js        # Logic for text.html
│   │   └── ...
│   ├── css/
│   │   └── style.css      # Global styles
│   └── ...                # Other static assets (images, etc.)
├── scripts/               # Utility scripts (e.g., certificate generation)
│   ├── generate_cert.bat  # Windows: generate self-signed SSL cert
│   ├── generate_cert.sh   # Linux/Mac: generate self-signed SSL cert
│   └── detect_cjk.py      # Detect CJK characters in codebase
└── src/                   # Backend core code
    ├── app.py             # Main application window (Tkinter)
    ├── tabs/              # Tab logic for each feature (QR, scan, share, fetch, about, etc.)
    ├── frames/            # UI frame components (title, server, tool, etc.)
    └── utils/             # Utility modules (logger, server_manager, etc.)

File/Directory Explanations 📝

• main.py: Entry point for the backend server and desktop app. 🏁
• requirements.txt: Lists all Python dependencies. 📦
• configs/: Stores configuration files and SSL certificates (key.pem, cert.pem). 🔑
• output/: Stores files uploaded or shared via the app. 📂
• static/: Contains all frontend resources:
  • index.html: Main dashboard/portal for navigation. 🗺️
  • help.html: In-app help and usage guide. 🆘
  • scan.html / scan.js: Scan QR codes with mobile, send result to PC. 🔍
  • share.html / share.js: Download files from PC to mobile. 📤
  • fetch.html / fetch.js: Upload files from mobile to PC. 📥
  • text.html / text.js: Directly send/paste text between devices. 📝
  • css/style.css: Global styles for all pages. 🎨
• scripts/: Utility scripts for development and deployment. 🛠️
• src/: All backend and desktop app logic:
  • app.py: Main Tkinter application window and logic. 🖼️
  • tabs/: Each feature tab (QR, scan, share, fetch, about, etc.). 🗂️
  • frames/: UI frame components for modular design. 🧩
  • utils/: Helper modules (logging, server management, etc.). 🧰

This structure ensures clear separation of backend, frontend, configuration, and utility scripts, making the project easy to maintain and extend. 🧑‍💻

License 📝

MIT License

Credits 🙏

• Developed by: Paradoxsolver 👨‍💻
• License: MIT 🪪
• Powered by:
  • Flask ⚗️
  • html5-qrcode 📷
  • And more open source libraries 🌐
• Project Home: https://github.com/paradoxsolver1997/FiBridge 🏠

---

For questions, suggestions, or contributions, feel free to open an issue or contact the author! 💬