MCPcopy Index your code
hub / github.com/CCA3370/XFast-Manager

github.com/CCA3370/XFast-Manager @v1.2.5

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.2.5 ↗ · + Follow
2,713 symbols 6,919 edges 154 files 449 documented · 17%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

XFast Manager

XFast Manager

The Modern X-Plane Addon Installer & Manager

Stars  Issues  Latest Release  Downloads  Platforms  License

Download Latest Release

XFast Manager makes installing and managing X-Plane addons effortless. Drop in a file and get a ready-to-fly setup in minutes. Available for Windows, macOS, and Linux.


Experience at a Glance

  • Install in seconds: drag and drop any addon file, archive, or folder
  • Zero guesswork: the app identifies addon types and puts them in the right place
  • Stay organized: manage aircraft, plugins, navdata, and scenery in one view
  • Safe and reversible: backups, verification, and clear conflict warnings
  • Polished UI: light/dark themes, English/Chinese support, smooth progress feedback

What You Can Do

  • Install directly from ZIP, 7z, RAR, or folders without manual extraction
  • Manage aircraft, plugins, navdata, scenery, and liveries with quick actions
  • Keep scenery load order clean and stable with smart sorting
  • See update availability at a glance
  • Use a right-click install menu on Windows

Screenshots

Home and drag-and-drop Install confirm Scenery management X-Plane Log Analysis Management overview Settings and preferences

System Requirements

  • Windows 10/11 (x64)
  • macOS 10.15+ (Intel or Apple Silicon)
  • Linux (x64, GTK3 + WebKit2GTK required)

Getting Started

  1. Download the latest release from the Releases page.
  2. Launch the app and select your X-Plane folder.
  3. Drag your addon into the window and install.

Linux Downloads

  • AppImage (Recommended for most Linux users): download the regular Linux AppImage from the Releases page.
  • Arch Linux tar.gz (Recommended on Arch/Wayland if AppImage has issues): download XFast-Manager-<version>-linux-arch-x64.tar.gz.

Arch Linux Install

  1. Install runtime dependencies: sudo pacman -S --needed gtk3 webkit2gtk-4.1 libappindicator-gtk3 librsvg
  2. Extract the release archive: tar -xzf XFast-Manager-<version>-linux-arch-x64.tar.gz
  3. Enter the extracted directory and run the app: chmod +x XFast-Manager && ./XFast-Manager

FAQ

Does it support ZIP/7z/RAR archives?
Yes. You can install directly from ZIP, 7z, or RAR without extracting first.

Can it handle conflicting versions?
Yes. Choose clean install or overwrite, and enable verification for safety.

Is it safe to run while X-Plane is running?
We recommend closing X-Plane during installs to avoid file locks.

Does it run on macOS and Linux?
Yes. XFast Manager ships for Windows, macOS, and Linux.

Troubleshooting

  • Install fails due to permissions
    Close X-Plane and file explorer windows, then retry.

  • Windows context menu missing
    Enable it in Settings, then relaunch the app.

  • Linux app does not start
    Install GTK3 and WebKit2GTK packages.

  • Linux Wayland AppImage shows EGL_BAD_PARAMETER on startup
    On current builds, the AppImage automatically prefers X11 on problematic Wayland sessions when XWayland is available. If you still need to override it manually, try GDK_BACKEND=x11 ./XFast-Manager-*.AppImage or XFAST_FORCE_X11=1 ./XFast-Manager-*.AppImage.

  • AppImage still has problems on Arch Linux
    Use the Arch Linux tar.gz release instead of the AppImage. It ships as a native Arch-built binary and avoids the extra AppImage runtime layer.

  • Password requested
    Provide the archive password when prompted.

Support & Feedback

  • Found a bug or need help? Please open an issue with your OS, app version, and logs.
  • Feature requests are welcome via GitHub Issues.

Development

Requirements - Node.js 18+ - Rust 1.70+

Commands

# Install dependencies
npm install

# Development mode
npm run tauri:dev

# Production build
npm run tauri:build

Tests

  • Rust unit tests: cargo test

Testers

Thanks to: SINO1660, enenY, 🍊, Tong Wu, HTony03, CHN131

Extra Notes

  • App data is stored in platform-specific application data directories using the app identifier com.xfastmanager.tool.
  • RAR archives do not support file integrity verification.
  • Windows shortcut (.lnk) resolution is supported on Windows only.

License

This project is licensed under the GNU General Public License v3.0. See LICENSE for details.

Extension points exported contracts — how you extend this code

CachedEntry (Interface)
Trait to extract `cached_at` from different cache entry types [2 implementers]
src-tauri/src/core/cache.rs
ImportMetaEnv (Interface)
(no doc)
src/vite-env.d.ts
StoreInitResult (Interface)
(no doc)
src/main.ts
ApiError (Interface)
(no doc)
src/types/index.ts
SmartSceneryGroup (Interface)
(no doc)
src/utils/scenerySmartGroups.ts
PresetSummary (Interface)
(no doc)
src/stores/presets.ts
BugReportToast (Interface)
(no doc)
src/services/bugReport.ts
ContextMenuItem (Interface)
(no doc)
src/composables/useContextMenu.ts

Core symbols most depended-on inside this repo

get
called by 446
src-tauri/src/data/database/mod.rs
len
called by 373
src-tauri/src/management/zibo_updater.rs
log_info
called by 229
src-tauri/src/core/logger.rs
as_str
called by 93
src-tauri/src/map/mod.rs
log_error
called by 62
src-tauri/src/core/logger.rs
setItem
called by 61
src/services/storage.ts
log_info
called by 53
src-tauri/src/management/zibo_updater.rs
logDebug
called by 52
src/services/logger.ts

Shape

Function 1,782
Method 450
Class 286
Interface 150
Enum 45

Languages

Rust75%
TypeScript25%

Modules by API surface

src-tauri/src/lib.rs153 symbols
src-tauri/src/map/mod.rs151 symbols
src-tauri/src/management/csl_index.rs150 symbols
src-tauri/src/management/zibo_updater.rs128 symbols
src-tauri/src/management/gateway.rs104 symbols
src-tauri/src/management/addon_updater.rs93 symbols
src-tauri/src/analysis/scanner/mod.rs92 symbols
src-tauri/src/data/models.rs81 symbols
src-tauri/src/management/airport_flatten.rs76 symbols
src-tauri/src/scenery/scenery_index.rs73 symbols
src-tauri/src/management/management_index.rs73 symbols
src-tauri/src/install/installer/mod.rs72 symbols

For agents

$ claude mcp add XFast-Manager \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact