# xplorer **Repository Path**: EEEEEZ/xplorer ## Basic Information - **Project Name**: xplorer - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-11-26 - **Last Updated**: 2021-11-26 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

Xplorer, a customizable, modern and cross-platform File Explorer.

Supports • Discussions • Documentation • Discord

[![LICENSE](https://img.shields.io/github/license/kimlimjustin/xplorer.svg?style=for-the-badge)](https://github.com/kimlimjustin/xplorer/blob/master/LICENSE) [![Download Counts](https://img.shields.io/github/downloads/kimlimjustin/xplorer/total.svg?style=for-the-badge)](https://github.com/kimlimjustin/xplorer/releases) [![Stars Count](https://img.shields.io/github/stars/kimlimjustin/xplorer.svg?style=for-the-badge)](https://github.com/kimlimjustin/xplorer/stargazers) [![Forks Count](https://img.shields.io/github/forks/kimlimjustin/xplorer.svg?style=for-the-badge)](https://github.com/kimlimjustin/xplorer/network/members) [![Watchers Count](https://img.shields.io/github/watchers/kimlimjustin/xplorer.svg?style=for-the-badge)](https://github.com/kimlimjustin/xplorer/watchers) [![Issues Count](https://img.shields.io/github/issues/kimlimjustin/xplorer.svg?style=for-the-badge)](https://github.com/kimlimjustin/xplorer/issues) [![Pull Request Count](https://img.shields.io/github/issues-pr/kimlimjustin/xplorer.svg?style=for-the-badge)](https://github.com/kimlimjustin/xplorer/pulls) [![Follow](https://img.shields.io/github/followers/kimlimjustin.svg?style=for-the-badge&label=Follow&maxAge=2592000)](https://github.com/kimlimjustin) [![Discord Server](https://img.shields.io/discord/893135322093871104?style=for-the-badge)](https://discord.gg/eM2hsDMtjq) [![Windows Support](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white)](https://github.com/kimlimjustin/xplorer/releases) [![Ubuntu Support](https://img.shields.io/badge/Ubuntu-E95420?style=for-the-badge&logo=ubuntu&logoColor=white)](https://github.com/kimlimjustin/xplorer/releases) [![Arch Linux Support](https://img.shields.io/badge/Arch_Linux-1793D1?style=for-the-badge&logo=arch-linux&logoColor=white)](https://github.com/kimlimjustin/xplorer/releases) [![Windows Support](https://img.shields.io/badge/MACOS-adb8c5?style=for-the-badge&logo=macos&logoColor=white)](https://github.com/kimlimjustin/xplorer/releases)
--- # What is Xplorer? ![Demo](docs/static/img/Xplorer_dark.png)
View More Screenshots ![Demo](docs/static/img/Xplorer_dark+.png) ![Demo](docs/static/img/Xplorer_light.png) ![Demo](docs/static/img/Xplorer_light+.png) ![Demo](docs/static/img/Xplorer_mac_light.png) ![Demo](docs/static/img/Xplorer_mac_dark.png) ![Demo](docs/static/img/Xplorer_linux.png)
Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern! Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key features is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document previews, but also video previews. To summarize, Xplorer's features contain: - It looks modern - Easy to use - Cross-platform - [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos! - Customizable - Supports multiple tabs - Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit Xplorer is currently under heavy development. You can give your suggestions and feedback on our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/). --- ## Installation If you want to install Xplorer on your system, you can download the installer for your operating system [on the release page](https://github.com/kimlimjustin/xplorer/releases). Please note that the current version is not stable yet, and you may encounter various bugs. --- ## Bug Reporting If you find any bugs, please report it by submitting an issue on our [issue page](https://github.com/kimlimjustin/xplorer/issues) with a detailed explanation. Giving some screenshots would also be very helpful. ## Feature Request You can also submit a feature request on our [issue page](https://github.com/kimlimjustin/xplorer) or [discussions](https://github.com/kimlimjustin/xplorer/discussions) and we will try to implement it as soon as possible. If you want to contribute to this project, please [contribute to this project](https://xplorer.vercel.app/community/Contributing/). --- ## Common Problems **NB: For common installation problems, please visit this page [here](https://xplorer.vercel.app/docs/install/#common-problems)**
Opening folders like Documents, Desktop, Downloads makes Xplorer crash Try disabling the [`Extract exe file icon and make it as preview`](https://xplorer.vercel.app/docs/guides/setting/#extract-exe-file-icon-and-make-it-a-preview) option on `Preference` page on Settings. Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
Xplorer crashes when opening a folder. Simply close and reopen Xplorer, Xplorer will fix itself. If it doesn't, please address an issue over here
--- ## Architecture Xplorer is a cross-platform application built using the [Tauri](https://tauri.studio) framework. Tauri is based on Microsoft Edge-similar webview and Rust to work. Read about tauri [here](https://tauri.studio/en/docs/about/intro) Xplorer is a polygot application. Xplorer relies on Rust api for file operations and TS, SCSS for the webview. Rust code are under `src-tauri` directory whereas the webview code are under `src` directory. The API that connects webview with the Rust code is under `src/Api` directory. --- ## Development If you want to run this project in your local system, please follow this guide: 1. Fork this project 2. Clone the project to your local system using this command 3. Follow [this guide](https://tauri.studio/en/docs/getting-started/intro/#setting-up-your-environment) to set up Tauri environment ```sh $ git clone https://github.com//xplorer.git ``` 4. Change directory to the root directory of this project ```sh $ cd xplorer ``` 5. Install all dependencies using [`yarn`](https://yarnpkg.com/) ```sh $ yarn install ``` 6. Run the project in development mode. Please note that it might takes some times for Cargo to install dependencies for the first run. ```sh $ yarn dev ``` --- ## Contribution Guide We highly encourage you to contribute to this project (even if you are a beginner). And if you finally want to contribute to this project, please read [our contribution guide](https://xplorer.vercel.app/community/Contributing). --- ### Gitpod for Xplorer's development Gitpod is a Ready-to-Code environment in which you don't need to worry about dependency errors or lagging your computer. Hit the button below and log in to GitHub with your GitHub account. Then, after it loads, you end up with a VS Code-like environment where you can start developing and pushing your changes. **Very Important Note: Remember to reload the Gitpod website after it loads up since it won't start the servers immediately, but by reloading, you can get it started. If you are developing the app, go to the Remote Explorer on the sidebar and visit port _6080_ which opens the noVNC app server. If you are developing the docs, go to the Remote explorer but instead of port 6080, visit port _3000_. You can edit normally as you do in VS Code, but if you want to use it locally, click the hamburger menu button and click _Open in VS Code_.** [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#/https://github.com/kimlimjustin/xplorer) --- ## LICENSE [Apache-2.0](https://github.com/kimlimjustin/xplorer/blob/master/LICENSE)