https://github.com/janecea/filesurfer

Modern file explorer for the Windows OS.
https://github.com/janecea/filesurfer

avalonia avaloniaui file-explorer file-management file-manager git windows

Last synced: 25 days ago
JSON representation

Modern file explorer for the Windows OS.

• Host: GitHub
• URL: https://github.com/janecea/filesurfer
• Owner: JANECEA
• Created: 2024-09-08T21:04:15.000Z (4 months ago)
• Default Branch: master
• Last Pushed: 2024-11-26T10:42:51.000Z (27 days ago)
• Last Synced: 2024-11-26T11:27:05.269Z (27 days ago)
• Topics: avalonia, avaloniaui, file-explorer, file-management, file-manager, git, windows
• Language: C#
• Homepage:
• Size: 3.24 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# README - FileSurfer

## This is an open-source file explorer for Windows, built with Avalonia UI.

Supports all you'd expect from a modern file explorer, plus some extra quirks:

- Image pasting from the system clipboard

- Treating dotfiles as hidden

- Renaming multiple files or directories at once

- Undo & redo for most of the reversible file operations

- Integration with the Git version control system

## Dependencies

To build and run this project, ensure that the following dependencies are installed:

### .NET and Frameworks

- **.NET 8.0**

- **Avalonia UI**

- **Windows Forms**: The project uses Windows Forms to interact with the system clipboard

### NuGet Packages

- **[Avalonia](https://avaloniaui.net/gettingstarted#installation)** (v11.0.10)

- **Avalonia.Desktop** (v11.0.10)

- **Avalonia.Themes.Fluent** (v11.0.10)

- **Avalonia.Fonts.Inter** (v11.0.10)

- **Avalonia.ReactiveUI** (v11.0.10)

- **Avalonia.Diagnostics** (v11.0.10) — *Debug configuration only*

- **LibGit2Sharp** (v0.30.0)

- **SharpCompress** (v0.37.2)

### COM References

- **Shell32** (GUID: `50a7e9b0-70ef-11d1-b75a-00a0c90564fe`)

- **IWshRuntimeLibrary** (GUID: `f935dc20-1cf0-11d0-adb9-00c04fd58a0b`)

Ensure these COM components are registered on the system where the application is running. If not, you may need to manually register the corresponding DLLs using `regsvr32 "path/to/dll"`.

### Other

- [Git for Windows](https://git-scm.com/download/win): for optional Git integration.

## Building from source *

1) Install the .NET Build tool using the [Visual Studio Build Tools](https://visualstudio.microsoft.com/cs/visual-cpp-build-tools/) installer.

2) Open "Developer command prompt for VS 2022"

3) Run `dotnet restore "path\to\csproject-file\FileSurfer.csproj"`

4) Run `msbuild "path\to\project\solution\FileSurfer.sln" /t:publish /p:Configuration=Release /p:DeployOnBuild=true`

5) Find `.\src\FileSurfer\bin\Release\net8.0-windows\FileSurfer.exe` to run the app.

\* *You can also compile the project using Visual Studio 2022.*

[User Guide](docs/UserGuide.md)

---

[Programming Documentation](/docs/ProgrammingDocumentation/html.zip)

---