Restructure README: features, per-platform prereqs, then install

This commit is contained in:
mikisoq
2026-07-29 02:04:47 -01:00
parent bb32a78e1e
commit 31d1526ffe
+12 -14
View File
@@ -2,6 +2,15 @@
Cross-platform Avalonia UI app for bulk Active Directory operations from a CSV file. Cross-platform Avalonia UI app for bulk Active Directory operations from a CSV file.
## Features
- Load a CSV with any column structure
- Auto-discover the AD domain and domain controller via DNS (click **Discover** or runs on startup)
- Built-in port/connectivity health check (DNS, TCP 389, TCP 636, LDAP bind, LDAPS bind)
- Dry-run mode to validate before making changes
- Actions: enable, disable, add/remove from group, set/force password change
- LDAP 389 for normal edits; LDAPS 636 required for password resets
## Prerequisites ## Prerequisites
- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0) - [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
@@ -31,7 +40,7 @@ sudo apt install dotnet-sdk-8.0
brew install dotnet-sdk-8.0 brew install dotnet-sdk-8.0
``` ```
## Build & Run ## Install & Run
```bash ```bash
git clone https://gitea.mikisoq.cc/mikisoq/ADBulk.git git clone https://gitea.mikisoq.cc/mikisoq/ADBulk.git
@@ -43,15 +52,6 @@ dotnet run
On Windows, you can also open the folder in Visual Studio and run from there. On Windows, you can also open the folder in Visual Studio and run from there.
## Features
- Load a CSV with any column structure
- Auto-discover the AD domain and domain controller via DNS (click **Discover** or runs on startup)
- Supports LDAP 389 (normal edits) and LDAPS 636 (password resets)
- Built-in port/connectivity health check
- Dry-run mode to validate before making changes
- Actions: enable, disable, add/remove from group, set/force password change
## Quick start ## Quick start
1. Launch the app 1. Launch the app
@@ -73,14 +73,12 @@ On Windows, you can also open the folder in Visual Studio and run from there.
### Linux ### Linux
Place your root CA certificate and run:
```bash ```bash
# Arch / CachyOS # Arch / CachyOS — place root CA and run:
sudo cp your-root-ca.crt /etc/ca-certificates/trust-source/anchors/ sudo cp your-root-ca.crt /etc/ca-certificates/trust-source/anchors/
sudo trust extract-compat sudo trust extract-compat
# Ubuntu / Debian # Ubuntu / Debian:
sudo cp your-root-ca.crt /usr/local/share/ca-certificates/ sudo cp your-root-ca.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates sudo update-ca-certificates
``` ```