https://github.com/cca3370/xfast-manager
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.
https://github.com/cca3370/xfast-manager
installer log-analysis manager rust scenery-manager tool vue x-plane
Last synced: about 2 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/cca3370/xfast-manager
- Owner: CCA3370
- License: gpl-3.0
- Created: 2025-12-14T01:08:58.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-04-26T04:22:28.000Z (about 2 months ago)
- Last Synced: 2026-04-26T05:31:56.516Z (about 2 months ago)
- Topics: installer, log-analysis, manager, rust, scenery-manager, tool, vue, x-plane
- Language: Rust
- Homepage: https://www.3370tech.cn/
- Size: 8.3 MB
- Stars: 31
- Watchers: 3
- Forks: 1
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# XFast Manager
The Modern X-Plane Addon Installer & Manager
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
### 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--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--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**
```bash
# 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.