https://github.com/mijocecr/samba-util
GUI tool to manage Samba shares on Linux
https://github.com/mijocecr/samba-util
gui linux linux-share-file samba
Last synced: 16 days ago
JSON representation
GUI tool to manage Samba shares on Linux
- Host: GitHub
- URL: https://github.com/mijocecr/samba-util
- Owner: mijocecr
- License: mit
- Created: 2026-05-01T15:18:56.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-05-18T23:44:23.000Z (about 1 month ago)
- Last Synced: 2026-05-19T01:44:15.030Z (about 1 month ago)
- Topics: gui, linux, linux-share-file, samba
- Language: C#
- Homepage:
- Size: 10.2 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# SAMBA‑Util
SAMBA‑Util is a graphical application designed to simplify the management of Samba shares, users, and configuration files on Linux systems.
It provides a clear and accessible interface that allows administrators to configure Samba without manually editing `smb.conf` or relying on complex command‑line tools.
The goal of the project is to offer a dependable and easy‑to‑use utility that makes Samba administration more intuitive, organized, and safe for both new and experienced users.
---
## Purpose
Samba is widely used for file sharing across networks, but its configuration can be difficult to manage efficiently through text files or terminal commands.
SAMBA‑Util presents these capabilities through a modern interface that emphasizes clarity, consistency, and ease of use, helping users avoid common mistakes and streamline their workflow.
---
## Key Features
### Share Management
- Create, edit, and remove Samba shares
- Configure paths, permissions, masks, and visibility options
- Validate share names and paths before saving
- Browse and detect available SMB folders on the network
- Reload Samba configuration safely and without service interruption
### User Management
- Add and remove Samba users
- Synchronize system accounts with Samba
- Handle passwords securely
- Detect invalid or outdated credentials
### System Integration
- Read and write `/etc/samba/smb.conf` in a controlled and safe manner
- Perform administrative actions using `sudo`
- Detect incorrect administrator passwords without affecting system authentication
- Display Samba service status and relevant logs
### Modern Interface
- Built with Avalonia for a consistent cross‑platform experience
- Clean, organized layout with clear sections
- Support for SVG and PNG icons
- Designed for readability and simplicity
---
## Installation
For all Linux distributions there is an AppImage available and
Pre‑built packages on the project’s GitHub page:
**https://github.com/mijocecr/samba-util/releases**
### AUR (Arch Linux / Manjaro / EndeavourOS)
SAMBA‑Util is available in the Arch User Repository.
Install with `yay`:
```bash
yay -S samba-util-bin
```
Install with `paru`:
```bash
paru -S samba-util-bin
```
Manual AUR clone:
```bash
git clone https://aur.archlinux.org/samba-util-bin.git
cd samba-util-bin
makepkg -si
```
---
## Running SAMBA‑Util
### From source:
```bash
git clone https://github.com/mijocecr/samba-util.git
cd samba-util
dotnet run
```
---
## Requirements
- Linux distribution with `systemd`
- `samba`
- `linux-headers` needed for kernel controller
- `cifs-utils` needed to operate the filesystem
- .NET 9.0 runtime (or self‑contained build)
- `sudo` privileges for administrative actions
- Access to `/etc/samba/smb.conf`
---
## License
SAMBA‑Util is distributed under the **MIT License**, allowing free use, modification, and distribution.
---
Project Status
---
SAMBA‑Util is stable, safe, and suitable for production use in home servers, homelabs, and small office environments.
It focuses on reliability and does not modify any Samba settings outside the user’s explicit actions.
---
---