G9BlazorComponent.FileManagementSystem 1.0.1.4

G9BlazorComponent.FileManagementSystem

G9BlazorComponent.FileManagementSystem is a full-featured, customizable, and extensible Blazor file management component designed to provide powerful file browsing, manipulation, and remote SSH/SFTP access capabilities. It supports drag-and-drop uploads, context menus, real-time operations, SSH terminals, and more. This library is built to support file management for both local and remote server environments with modern UI and multi-language support.

🔧 Features

• 📁 File/Directory browsing for:

  • Public area
  • Private area
  • Remote SSH/SFTP

• 📂 Tabbed interface for multi-path navigation

• 🖱️ Context menu and mouse/touch event handling (click, double-click, right-click, hold)

• 🔑 Secure SSH/SFTP support with private key + passphrase

• 🧭 Tree navigation view for directory structures

• 📋 File operations:

  • Upload/Download
  • Create/Rename/Delete
  • Copy/Cut/Paste with progress notification
  • Compress/Decompress (ZIP, TAR, etc.)

• 📝 Text and code file editing with encoding support

• 📷 Preview for images, videos, and PDFs

• 🔍 Search and live filtering

• 📚 Internationalization (20+ languages)

• ⌨️ Keyboard shortcut support

• 🧱 Modular design with customization support

📦 Installation

Install the NuGet package:

Install-Package G9BlazorComponent.FileManagementSystem

Or via .NET CLI:

dotnet add package G9BlazorComponent.FileManagementSystem

🧪 Basic Usage

Use the Component

@page "/"
@using G9BlazorComponent.FileManagementSystem

<G9FileManagement @ref="_fileManager" Language="G9ECultures.en" />

@code {
    private G9FileManagement _fileManager = null!;

    protected override void OnInitialized()
    {
        if (_fileService == null)
        {
            var privatePath = G9Assembly.InputOutputTools.GetExecutableDirectory();
            _fileService = new G9CFileService("PublicFileManagementSystem", privatePath);
        }
    }
}

🔐 SSH/SFTP Access

You can open a remote SSH/SFTP area (automatically) with the following method:

await _fileManager.OpenShhSftpAreaPath(new SshConfig
{
    UserName = "root",
    HostName = "127.0.0.1",
    Port = 9000,
    PrivateKeyContent = "-----BEGIN OPENSSH PRIVATE KEY-----\n...",
    PassPhrase = "your-passphrase",
    ConnectionTimeoutSeconds = 60,
    OperationTimeoutSeconds = 300
}, "/home", newTab: true, isShhMode: true);

Supports interactive terminal integration via Xterm.

💡 Keyboard Shortcuts

🌍 Localization

Set your preferred culture via the Language parameter:

<G9FileManagement Language="G9ECultures.en" />

Custom dictionaries are also supported and can be extended from the G9Dictionaries folder.

Supported cultures are as follows:

Supported Cultures

The following cultures are supported:

• en (English)
• zh (Chinese - Mandarin)
• es (Spanish)
• hi (Hindi)
• ar (Arabic)
• fr (French)
• pt (Portuguese)
• ru (Russian)
• de (German)
• ja (Japanese)
• bn (Bengali)
• pa (Punjabi)
• jv (Javanese)
• ko (Korean)
• vi (Vietnamese)
• ta (Tamil)
• tr (Turkish)
• it (Italian)
• fa (Persian)
• th (Thai)

To add additional languages, update the {LibraryName}.LanguageDictionaryConfig.json file located in the /G9Dictionaries folder. Then, include translations and word definitions for the new language in the {LibraryName}.LanguageDictionary.json file.

📑 File Operations API

All main file operations are available:

• CreateFile()
• CreateFolder()
• Rename()
• DeleteItem()
• UploadFile()
• DownloadFile()
• Compress() / Decompress()
• EditTextFile()

Additionally, all operations provide full feedback via popup modals and toast notifications.

🧩 Integration Notes

• Works with both Blazor Server and Blazor WebAssembly
• Can be extended with other G9 components (e.g., Modals, Input Forms)
• Full TypeScript/JavaScript interop is used for terminal, key bindings, and event handling

🛡 Security

• Secure file management via private paths
• Full support for secure SSH key-based access
• Passphrase-protected keys supported (ED25519, RSA)

📬 Feedback and Contribution

Feel free to contribute or report issues on the GitHub repository. For questions, reach out to the author or open a discussion.

📄 License

Licensed under MIT.

Built with ❤️ for advanced file management in modern Blazor apps.