FileSurfer

A Modern, Open-Source File Explorer for Linux and Windows

---

FileSurfer is an open-source file explorer for Linux and Windows built with AvaloniaUI. FileSurfer is designed for convenience and efficiency, targeting technical users while still providing a familiar and modern interface. Your feedback is very welcome: if you encounter any bugs or have suggestions, please open an issue here on GitHub!

---

✨ Features

All what you'd expect from a file manager plus some more:

• Git Integration: Speed up basic interactions with Git repositories directly from the app.
• SFTP Integration: Browse and easily interact with remote folders.
• Directory synchronization: Synchronize local directories with remote locations.
• Image and text Pasting from Clipboard: Paste images or text directly from your clipboard into folders.
• Batch Renaming: Rename multiple files or directories at once.
• Undo & Redo: Reverse most file operations with a simple undo/redo feature.

---

🖼️ Screenshots

Dark interface using the list view in a Git repository.

Light interface using the icon view.

---

🚀 Getting Started

On Linux

Make sure to have the following command line tools installed!:

• trash-cli: for interacting with the system trash.
• resvg: for handling svg icons.
• xdg-mime: for resolving file mimetypes (most likely already installed).

Download and Install

1. Download the latest release from the Releases Page.
2. Just extract the .zip, open the executable file.

Build from Source

If you want to customize FileSurfer, you can build it from source.
See the following section for detailed instructions.

---

🛠️ Building from Source

On Windows

To build FileSurfer from source on Windows, you'll need the following:

Prerequisites

• .NET 8.0 SDK.
• Git for Windows: (optional, for Git integration)

Steps

1. Install the .NET Build Tools.
2. Open the "Developer Command Prompt for VS 2022" app on your computer.
3. Run the following commands:

   dotnet restore <path to FileSurfer.Windows.csproj>  
   msbuild <path to FileSurfer.sln> /t:publish /p:Configuration=Release /p:DeployOnBuild=true  

4. Locate the compiled executable at: "...\src\FileSurfer.Windows\bin\Release\net8.0-windows\FileSurfer.exe"

(You can also use Visual Studio 2022/2026 to build the project.)

---

On Linux

To build FileSurfer from source on Windows, you'll need the following:

Prerequisites

• .NET 8.0 SDK.
• Git for Linux: (optional, for Git integration)

To Run:

• trash-cli: for interacting with the system trash.
• resvg: for handling svg icons.
• xdg-mime: for resolving file mimetypes (most likely already installed).

Steps

1. Run the following commands:

   dotnet build  <path to FileSurfer.Linux.csproj> -c Release

2. Locate the compiled executable at: ".../src/FileSurfer.Linux/bin/Release/net8.0/FileSurfer"

---

📚 Documentation (WIP)

• User Guide: Learn how to use FileSurfer's features.
• Specification: Check out the technical and functional specification of the project.
• Technical Documentation: Take a look at the technical details of the project.
• Doxygen: Look around the generated doxygen documentation.

---

📦 Dependencies

FileSurfer relies on the following dependencies:

Common

.NET and Frameworks

• .NET 8.0
• Avalonia UI

NuGet Packages

• Avalonia (v11.3.9)
• Avalonia.Desktop (v11.3.9)
• Avalonia.Themes.Fluent (v11.3.9)
• Avalonia.Fonts.Inter (v11.3.9)
• ReactiveUI.Avalonia (v11.3.8)
• LibGit2Sharp (v0.31.0)
• SharpCompress (v0.41.0)

Windows

.NET and Frameworks

• Windows Forms

COM References

• Shell32 (GUID: 50a7e9b0-70ef-11d1-b75a-00a0c90564fe)
• IWshRuntimeLibrary (GUID: f935dc20-1cf0-11d0-adb9-00c04fd58a0b)

Linux

NuGet Packages

• Mime-Detective (v25.8.1)
• Mime-Detective.Definitions.Exhaustive (v25.8.1)
• Mono.Posix.NETStandard (v1.0.0)