Skip to content

Commit 1292972

Browse files
committed
updates
1 parent 7830116 commit 1292972

File tree

4 files changed

+130
-27
lines changed

4 files changed

+130
-27
lines changed

.gitignore

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,3 +66,25 @@
6666
/src-tauri/config
6767
/config
6868
app.log
69+
70+
# Ignore test data
71+
/src-tauri/test-data*/
72+
73+
74+
# for the latex stuff
75+
/FileExplorerAusarbeitung/*.acn
76+
/FileExplorerAusarbeitung/*.acr
77+
/FileExplorerAusarbeitung/*.alg
78+
/FileExplorerAusarbeitung/*.aux
79+
/FileExplorerAusarbeitung/*.bcf
80+
/FileExplorerAusarbeitung/*.fdb_latexmk
81+
/FileExplorerAusarbeitung/*.fls
82+
/FileExplorerAusarbeitung/*.glg
83+
/FileExplorerAusarbeitung/*.glo
84+
/FileExplorerAusarbeitung/*.gls
85+
/FileExplorerAusarbeitung/*.ist
86+
/FileExplorerAusarbeitung/*.lof
87+
/FileExplorerAusarbeitung/*.log
88+
/FileExplorerAusarbeitung/*.out
89+
/FileExplorerAusarbeitung/*.xml
90+
/FileExplorerAusarbeitung/*.toc

README.md

Lines changed: 108 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,124 @@
1-
[![Rust](https://github.com/conaticus/FileExplorer/actions/workflows/rust.yml/badge.svg?event=push)](https://github.com/conaticus/FileExplorer/actions/workflows/rust.yml)
1+
<div align="center">
22

3-
# Fast File Explorer
4-
This is a fast file explorer written in Rust. After testing on my C drive, this file explorer was able to find a file in 280ms. In comparison, Windows took 3 minutes and 45 seconds.
3+
# 🚀 Fast File Explorer
54

6-
Before contributing please read the [contributing guidelines](CONTRIBUTING.md).
5+
<a href="https://www.rust-lang.org/">
6+
<img src="resources/rust-logo.png" alt="Rust Logo" width="80"/>
7+
</a>
78

8-
## Supported operating systems
9-
- Windows
9+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
1010

11-
There are some issues with Linux and Mac but we shall work on these soon.
11+
**A fast file explorer built with Rust and Tauri**
1212

13-
Bear in mind this is still in development and missing the following core features:
14-
- Caching service (constant file watching to keep cache up to date) - only works when program is open
15-
- Top navigation bar
16-
- Search/caching progress counter
17-
- Ability to search for file extensions without including any name
18-
- Ability to copy/cut/paste files
19-
- Ability to move files
20-
- Ability to create files
13+
<img src="./resources/screenshot-explorer.png" alt="Fast Search Feature" width="700px"/>
2114

22-
![Fast Search Feature](./screenshots/search.jpg)
15+
</div>
2316

24-
# Dev Setup/Installation
25-
## Prerequisites
26-
- Stable [NodeJS](https://nodejs.org/) Install
27-
- Stable [Rust](https://www.rust-lang.org/) Install
28-
- Yarn installation (`npm i -g yarn`)
17+
## 🔍 Current Status
2918

30-
## Steps
19+
Cross platform compatibility is given and it supports all common Linux distros, which are supported by Tauri. If there is an
20+
interest of contributing feel free to join the [discord channel](https://discord.com/invite/dnVJQtNXjr) from Connaticus.
21+
22+
## Coming Soon
23+
24+
- Caching service with real-time file watching
25+
- Search/caching progress indicator
26+
- A better terminal emulator (maybe it is possible to have the systems default terminal integrated)
27+
28+
# 🛠️ Installation
29+
30+
For the installation there are packages provided with the current stable version. If there are no packages for your system you can
31+
compile the Explorer from source with the given instructions.
32+
33+
## Installation from source
34+
35+
### Prerequisites for installing from source
36+
37+
- [NodeJS](https://nodejs.org/) (stable version)
38+
- [Rust](https://www.rust-lang.org/) (stable version)
39+
40+
### Install with compiling from source
41+
42+
Note that on macOS you need XCode installed with the build tools.
43+
44+
```bash
45+
# Install Tauri CLI
46+
cargo install tauri-cli # The version should be >2.4.0
47+
48+
# Build for production
49+
cargo tauri build
50+
```
51+
52+
After that you need to follow the instructions for your operating system because now the installer for your system is created and
53+
you need to install the application.
54+
55+
### 🐧 Linux
56+
57+
Under Linux the given command generates an `.deb`, `.rpm`, `AppImage` in the `FileExplorer/src-tauri/target/release/bundle`
58+
folder. From there on open the file and drag it into the applications folder. Then it should be available.
59+
60+
#### For the `AppImage`
61+
62+
```bash
63+
#Make sure the image is runnable
64+
chmod +x yourapp-x.y.z.AppImage
65+
#Run the image. After that it should behaving like a native application
66+
./yourapp-x.y.z.AppImage
3167
```
32-
# Make sure you have Tauri CLI installed
33-
cargo install tauri-cli
3468

35-
# Install dependencies
36-
yarn
69+
### 🍎 macOS
70+
71+
Tauri creates an `.dmg` or `.app` bundle under the folder `FileExplorer/src-tauri/target/release/bundle/macos/`. Open the
72+
73+
### 🪟 Windows
74+
75+
This generates an installer for your system, which lays in `FileExplorer/src-tauri/target/release/bundle/msi/`. There should be an
76+
`.exe` or `.msi` which is called `file-explorer`. To install it you need to double click the file and install like any other
77+
application. Then you can completely remove the `FileExplorer` folder.
78+
79+
### Development Setup
3780

38-
# Run app for development
81+
```bash
82+
# Install Tauri CLI
83+
cargo install tauri-cli # The version should be >2.4.0
84+
85+
# Run in development mode
3986
cargo tauri dev
4087

4188
# Build for production
4289
cargo tauri build
4390
```
91+
92+
## 📄 History
93+
94+
The Explorer was started as a project from the youtuber [Connaticus](https://www.youtube.com/@conaticus).
95+
He documented parts of his development journey online in two Videos:
96+
[I Made a FAST File Explorer](https://youtu.be/Z60f2g-COJY?si=PHWogkV1R_wD8dza)
97+
and
98+
[How I RUINED My Rust Project](https://youtu.be/4wdAZQROc4A?si=9ksfN2TcxdDI41BD).
99+
100+
Lots of changes were made in the course of the InformatiCup from the year 2025. It is a competition in Germany. The given task was
101+
to contribute to existing open source projects. The team members were
102+
[Marco Brandt](https://github.com/CodeMarco05), [Daniel Schatz](https://github.com/xd1i0), [Lauritz
103+
Wiebusch](https://github.com/wielauritz), [Sören Panten](https://github.com/SPKonig).
104+
The repo can be found under [FileExplorer](https://github.com/CodeMarco05/FileExplorer).
105+
106+
## ⚡ Performance
107+
108+
Our benchmarks show extraordinary performance improvements over native solutions:
109+
110+
| Operation | Fast File Explorer | Windows Explorer |
111+
| ----------- | :----------------: | :--------------: |
112+
| File search | 280ms | 3min 45sec |
113+
114+
## 🤝 Contributing
115+
116+
Contributions are welcome! Before contributing, please read our [contributing guidelines](CONTRIBUTING.md).
117+
118+
## 📝 License
119+
120+
This project is licensed under the MIT License - see the LICENSE file for details.
121+
122+
## 📬 Contact
123+
124+
Have questions or feedback? Open an issue on our GitHub repository!

resources/rust-logo.png

127 KB
Loading

resources/screenshot-explorer.png

882 KB
Loading

0 commit comments

Comments
 (0)