OpenXplorer
Get startedInstallation

Installation

Install the stable release without replacing your desktop.

Requirements#

For the .deb: Zorin OS 18, Ubuntu 24.04 or newer, or Debian 13 on x86-64, with GTK 4.14 or newer, GIO/GVfs and a graphical user session. The .deb declares its runtime dependencies; APT resolves them. Fedora, openSUSE and Arch users install the release's .rpm or Arch package when it lists one; every other distribution, including Debian 12, installs the Flatpak.

There are no Node.js, pnpm or Python requirements for the application itself. The optional persistent mount helper, openxplorer-mount-share, is a Rust program in the .deb, .rpm and Arch packages (not the Flatpak); it needs cifs-utils.

Install OpenXplorer#

Close every old Winspace/OpenXplorer window and finish file operations. Download the .deb, then run these commands from that download directory as your normal user.

Terminal
sudo apt update
sudo apt install ./openxplorer_2.0.23_all.deb
openxplorer --version
openxplorer

This is a local unsigned package, not an APT repository. Installation does not change your default file manager, Downloads folder, browser preferences, or network mounts.

Install the Flatpak#

The Flatpak runs on any distribution with Flatpak, and Flatpak keeps it up to date. Open https://openxplorer.app/openxplorer.flatpakref to install it with GNOME Software or KDE Discover, or run these commands as your normal user.

This adds the OpenXplorer repository, https://flatpak.openxplorer.app/repo/, whose releases are signed with the OpenXplorer Flatpak repository key (fingerprint 4483 F86D FCF3 21FD D175 3FEF B6B1 B6AB F57D 00E2), and Flathub for the GNOME runtime it needs. Each new release then arrives with your other updates in GNOME Software, KDE Discover or flatpak update.

Terminal
flatpak install --user https://openxplorer.app/openxplorer.flatpakref
flatpak run io.winspace.Development

Moving from the Flatpak file#

The io.winspace.Development.flatpak file of a GitHub release does not update itself. If you installed it, replace it once with the Flatpak from the repository; your settings and saved passwords stay.

Terminal
flatpak uninstall io.winspace.Development
flatpak install --user https://openxplorer.app/openxplorer.flatpakref

Update from inside the app#

Once a day, a few seconds after OpenXplorer starts, it asks the public OpenXplorer GitHub Releases API whether a newer release exists. When one does, a notice pops up at the top right with Install update… and Later, an accent Update button shows in the command bar beside the Settings gear, and Update available shows at the bottom right, beside the view controls. Later only closes that release's notice; Update and Update available stay until you update. Turn Settings › About › Show the Update button in the command bar off to keep only Update available; while the status bar is hidden, Update shows in the command bar anyway. You can also check at any time with Settings › About › Check for updates, and turn the daily check off there with Check for updates automatically. In 2.0.13 and earlier the app checked only when you asked, and in 1.1.0 and 1.1.1 the button is at the bottom of the sidebar. Review the installed and available versions, then choose Install update. Finish file operations and tab moves first.

The installed Debian app downloads the release installer, verifies its GitHub SHA-256 digest and package identity, then asks for an administrator's password through polkit before a small helper downloads, verifies and installs only the latest official release. Administrators at the computer install updates without the password: Settings › About › Install updates without asking for a password is on by default. Turning it back on asks for an administrator's password, and upgrades keep your choice. It applies only to administrators at the computer; other accounts still approve with an administrator's password. Removing the package turns it off. APT installs the update without removing packages. Choose Restart now when finished; restarting closes existing windows and tabs.

Older releases need one manual upgrade to 1.1.0 before this control is available; 1.1.x offers the newest 2.x release there. Earlier releases need one manual upgrade from GitHub Releases. Source checkouts, RPM, Arch and Flatpak installations update through their own package manager. Updates are not live code patches; the running app must restart. GitHub HTTPS and asset digests are the trust boundary, not an independent publisher signature. To go back to 1.1.4, install its .deb with sudo apt install --allow-downgrades; settings and saved passwords are shared.

Upgrading from Winspace#

The new package replaces winspace-explorer versions older than 0.8.0. Existing settings, caches, desktop IDs and credential identifiers are deliberately retained. The winspace and winspace-mount-share commands are compatibility aliases.

Stop the previous background reveal service before upgrading: winspace --quit. Do not force-kill a process that is transferring files. Re-pin the installed OpenXplorer launcher if the dock has cached the old display name.

First-run checklist#

Open a disposable folder. Create and rename a test file, then send it to Trash. Connect to a non-critical SMB share before trusting the app with your main storage. For a phone, unlock it and select file transfer or trust the computer when prompted; a GVfs-supported device then appears under This PC. See Known limitations in the project README before enabling advanced operations.

Blank window or graphics trouble#

Close the application completely and try the software-rendering launch. This changes this launch only, not your desktop graphics configuration.

Terminal
openxplorer --quit
openxplorer --software-rendering

Remove the application#

In Settings, restore previous default handlers, disable Show in folder integration and, on KDE Plasma, turn off Super+E opens OpenXplorer before removal, so Super+E goes back to the app that had it. Unmount/remove persistent mounts separately after closing files. Removing the application does not undo custom folder locations or delete your files.

Terminal
sudo apt remove openxplorer

The Software card before installation#

A downloaded .deb can have a generic card before installation even though its installed card shows the folder icon, application name and AGPL license. The embedded catalog is not necessarily available to Software until installed and indexed. Another icon or homepage URL cannot guarantee the local pre-install view.

The Flatpak repository is such a signed repository with an AppStream catalog: GNOME Software and KDE Discover show the Flatpak's name, screenshots and release notes before installation. The .deb is a local package and has no repository.

Project documentation · OpenXplorer 2.0.23 · AGPL-3.0-only
Search stays in your browser. ↵ Open result