โšก OpenVue

A lightweight local HTTP file server based on Tauri 2 + Axum.
One-click launch, plugin extensions, multi-device preview โ€” ready to go.

Release Stars License Tauri
OpenVue Demo

๐ŸŽฏ Core Features

Desktop app + HTTP server dual mode covers various use cases

๐Ÿš€

One-Click Launch

Install and use immediately. Desktop app supports auto-start. HTTP server + Tauri GUI combine the best of both worlds โ€” desktop control with browser convenience.

๐Ÿงฉ

Plugin Extensions

Extend file preview capabilities via HTML pages. Supports GeoGebra, Markdown, Office documents and more. Plugins are customizable, downloadable, and uninstallable.

๐Ÿ“‚

Directory Browse & File Upload

Browse specified directories in the browser with file upload support. Access from any device on your local network โ€” no extra tools needed.

๐ŸŒ

Dual Mode

Desktop Mode: Tauri window manages plugins & settings; Server Mode: pure HTTP backend, ideal for server deployment.

๐Ÿ”Œ

Plugin Marketplace

Built-in plugin marketplace. One-click download & install from remote indexes with auto hash verification. Update or uninstall anytime.

๐ŸŒ

Internationalization

Built-in bilingual UI (EN/ZH). Both desktop and web pages support language switching to serve users worldwide.

๐Ÿ”ง Architecture

Configure once, access anywhere

Frontend
Vue 3 + TypeScript
Desktop Shell
Tauri 2.x
HTTP Backend
Rust + Axum
Build Tool
Vite 5
Minimal Size
~8 MB
Cross-Platform
Windows / macOS / Linux

๐Ÿงฉ Plugin Development

An OpenVue plugin is essentially a standard web page (HTML + CSS + JS) that renders files of a specific format. Create your own in just 3 steps!

Create Plugin Directory

Create a folder under plugins/ named after your plugin ID, e.g. my-viewer.

Write index.html

Build a preview page. Use the ?path= parameter to get the file URL, then load and render it.

Add plugin.json

Create plugin.json in the plugin directory to describe the plugin name, supported extensions, download sources, etc.

// plugin.json example { "id": "my-viewer", "name": "My Viewer", "version": "1.0.0", "extensions": ["ext1", "ext2"], "urlTemplate": "/plugins/{pluginId}/?path={publicPath}", "downloadSources": [ { "label": "Github", "url": "https://...", "priority": 1 } ], "sha256": "e261d6162b91991c..." }

๐Ÿ’ก When your plugin is ready, package it as a ZIP and submit it along with plugin.json to the openvue-plugins repository โ€” it will be listed in the marketplace.

๐Ÿ“– Read the Full Plugin Documentation

โšก Quick Start

Download from Releases to get started, or build from source

๐Ÿ“ฆ Download & Install

  1. Go to Releases and download the latest version
  2. Windows: run the installer; macOS: mount the DMG; Linux: use AppImage
  3. Launch it โ€” manage settings in the desktop app, preview via your browser

๐Ÿ”ง Build from Source

  1. git clone https://github.com/yunend/openvue.git
  2. cd openvue && npm install
  3. cargo tauri dev (dev mode)
  4. cargo tauri build (production build)

๐Ÿค Contribute

OpenVue is fully open source. All contributions are welcome โ€” bug reports, feature suggestions, plugin submissions, documentation improvements, or code PRs โ€” every bit helps!

๐Ÿ› Report Issues ๐Ÿด Fork the Project ๐Ÿงฉ Submit Plugins