docs: Update README and documentation for lxs multi-tool across Linux and Windows platforms.

This commit is contained in:
2026-09-09 15:32:05 -04:00
parent 3fda22d3d5
commit 1df5cdb0bb
37 changed files with 4811 additions and 75 deletions
+19 -3
View File
@@ -6,10 +6,26 @@
# Date: 2025
# Load LXS common library (colors, separator, run_spinner, loggers, helpers)
# Prefers the sibling ../lib/common.sh (repo checkout or installed layout) and
# only hits the network when this script is run standalone via curl.
LXS_RAW_BASE="${LXS_RAW_BASE:-https://git.hyko.cx/hykocx/lxs/raw/branch/main}"
_lib=$(curl -fsSL "${LXS_RAW_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
LXS_RAW_PLATFORM_BASE="${LXS_RAW_PLATFORM_BASE:-${LXS_RAW_BASE}/linux}"
_lxs_lib=""
if [ -n "${BASH_SOURCE[0]:-}" ]; then
_lxs_self=$(readlink -f "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self=$(realpath "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self="${BASH_SOURCE[0]}"
_lxs_lib="$(dirname "$_lxs_self")/../lib/common.sh"
fi
if [ -n "$_lxs_lib" ] && [ -r "$_lxs_lib" ]; then
# shellcheck disable=SC1090,SC1091
. "$_lxs_lib"
else
_lib=$(curl -fsSL "${LXS_RAW_PLATFORM_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
fi
unset _lxs_lib _lxs_self
export LXS_LOG_FILE="/tmp/lxs_harden.log"
require_root "$0" "$@"
+21 -5
View File
@@ -6,13 +6,29 @@
# Date: 2025
# Load LXS common library (colors, separator, run_spinner, loggers)
# Prefers the sibling ../lib/common.sh (repo checkout or installed layout) and
# only hits the network when this script is run standalone via curl.
LXS_RAW_BASE="${LXS_RAW_BASE:-https://git.hyko.cx/hykocx/lxs/raw/branch/main}"
_lib=$(curl -fsSL "${LXS_RAW_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
LXS_RAW_PLATFORM_BASE="${LXS_RAW_PLATFORM_BASE:-${LXS_RAW_BASE}/linux}"
_lxs_lib=""
if [ -n "${BASH_SOURCE[0]:-}" ]; then
_lxs_self=$(readlink -f "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self=$(realpath "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self="${BASH_SOURCE[0]}"
_lxs_lib="$(dirname "$_lxs_self")/../lib/common.sh"
fi
if [ -n "$_lxs_lib" ] && [ -r "$_lxs_lib" ]; then
# shellcheck disable=SC1090,SC1091
. "$_lxs_lib"
else
_lib=$(curl -fsSL "${LXS_RAW_PLATFORM_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
fi
unset _lxs_lib _lxs_self
# Run a sibling tool script. Prefers a file next to this script (installed
# layout); falls back to downloading from LXS_RAW_BASE.
# layout); falls back to downloading from LXS_RAW_PLATFORM_BASE.
run_sibling() {
local script_path=$1
shift
@@ -36,7 +52,7 @@ run_sibling() {
local temp_file exit_code
temp_file=$(mktemp "/tmp/lxs.${script_name%.*}.XXXXXX.sh")
echo -e "${CYAN}[..] Fetching ${BOLD}${script_name}${NC}${CYAN}...${NC}"
if curl -fsSL -H "Cache-Control: no-cache" -o "${temp_file}" "${LXS_RAW_BASE}/${script_path}"; then
if curl -fsSL -H "Cache-Control: no-cache" -o "${temp_file}" "${LXS_RAW_PLATFORM_BASE}/${script_path}"; then
echo -e "${GREEN}[OK] Payload acquired${NC}"
chmod +x "${temp_file}"
"${temp_file}" "$@"
+19 -3
View File
@@ -6,10 +6,26 @@
# Date: 2025
# Load LXS common library (colors, separator, run_spinner, loggers, helpers)
# Prefers the sibling ../lib/common.sh (repo checkout or installed layout) and
# only hits the network when this script is run standalone via curl.
LXS_RAW_BASE="${LXS_RAW_BASE:-https://git.hyko.cx/hykocx/lxs/raw/branch/main}"
_lib=$(curl -fsSL "${LXS_RAW_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
LXS_RAW_PLATFORM_BASE="${LXS_RAW_PLATFORM_BASE:-${LXS_RAW_BASE}/linux}"
_lxs_lib=""
if [ -n "${BASH_SOURCE[0]:-}" ]; then
_lxs_self=$(readlink -f "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self=$(realpath "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self="${BASH_SOURCE[0]}"
_lxs_lib="$(dirname "$_lxs_self")/../lib/common.sh"
fi
if [ -n "$_lxs_lib" ] && [ -r "$_lxs_lib" ]; then
# shellcheck disable=SC1090,SC1091
. "$_lxs_lib"
else
_lib=$(curl -fsSL "${LXS_RAW_PLATFORM_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
fi
unset _lxs_lib _lxs_self
export LXS_LOG_FILE="/tmp/lxs_root_password.log"
require_root "$0" "$@"
+19 -3
View File
@@ -6,10 +6,26 @@
# Date: 2025
# Load LXS common library (colors, separator, run_spinner, loggers, helpers)
# Prefers the sibling ../lib/common.sh (repo checkout or installed layout) and
# only hits the network when this script is run standalone via curl.
LXS_RAW_BASE="${LXS_RAW_BASE:-https://git.hyko.cx/hykocx/lxs/raw/branch/main}"
_lib=$(curl -fsSL "${LXS_RAW_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
LXS_RAW_PLATFORM_BASE="${LXS_RAW_PLATFORM_BASE:-${LXS_RAW_BASE}/linux}"
_lxs_lib=""
if [ -n "${BASH_SOURCE[0]:-}" ]; then
_lxs_self=$(readlink -f "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self=$(realpath "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self="${BASH_SOURCE[0]}"
_lxs_lib="$(dirname "$_lxs_self")/../lib/common.sh"
fi
if [ -n "$_lxs_lib" ] && [ -r "$_lxs_lib" ]; then
# shellcheck disable=SC1090,SC1091
. "$_lxs_lib"
else
_lib=$(curl -fsSL "${LXS_RAW_PLATFORM_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
fi
unset _lxs_lib _lxs_self
export LXS_LOG_FILE="/tmp/lxs_root_ssh_login.log"
require_root "$0" "$@"
+19 -3
View File
@@ -6,10 +6,26 @@
# Date: 2025
# Load LXS common library (colors, separator, run_spinner, loggers)
# Prefers the sibling ../lib/common.sh (repo checkout or installed layout) and
# only hits the network when this script is run standalone via curl.
LXS_RAW_BASE="${LXS_RAW_BASE:-https://git.hyko.cx/hykocx/lxs/raw/branch/main}"
_lib=$(curl -fsSL "${LXS_RAW_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
LXS_RAW_PLATFORM_BASE="${LXS_RAW_PLATFORM_BASE:-${LXS_RAW_BASE}/linux}"
_lxs_lib=""
if [ -n "${BASH_SOURCE[0]:-}" ]; then
_lxs_self=$(readlink -f "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self=$(realpath "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self="${BASH_SOURCE[0]}"
_lxs_lib="$(dirname "$_lxs_self")/../lib/common.sh"
fi
if [ -n "$_lxs_lib" ] && [ -r "$_lxs_lib" ]; then
# shellcheck disable=SC1090,SC1091
. "$_lxs_lib"
else
_lib=$(curl -fsSL "${LXS_RAW_PLATFORM_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
fi
unset _lxs_lib _lxs_self
export LXS_LOG_FILE="/tmp/lxs_benchmark.log"
# Always clean up benchmark artifacts on exit, even on error or Ctrl+C. Without
+19 -3
View File
@@ -6,10 +6,26 @@
# Date: 2025
# Load LXS common library (colors, separator, run_spinner, loggers)
# Prefers the sibling ../lib/common.sh (repo checkout or installed layout) and
# only hits the network when this script is run standalone via curl.
LXS_RAW_BASE="${LXS_RAW_BASE:-https://git.hyko.cx/hykocx/lxs/raw/branch/main}"
_lib=$(curl -fsSL "${LXS_RAW_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
LXS_RAW_PLATFORM_BASE="${LXS_RAW_PLATFORM_BASE:-${LXS_RAW_BASE}/linux}"
_lxs_lib=""
if [ -n "${BASH_SOURCE[0]:-}" ]; then
_lxs_self=$(readlink -f "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self=$(realpath "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self="${BASH_SOURCE[0]}"
_lxs_lib="$(dirname "$_lxs_self")/../lib/common.sh"
fi
if [ -n "$_lxs_lib" ] && [ -r "$_lxs_lib" ]; then
# shellcheck disable=SC1090,SC1091
. "$_lxs_lib"
else
_lib=$(curl -fsSL "${LXS_RAW_PLATFORM_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
fi
unset _lxs_lib _lxs_self
export LXS_LOG_FILE="/tmp/lxs_system_infos.log"
# Menu: System Infos
+19 -3
View File
@@ -6,10 +6,26 @@
# Date: 2025
# Load LXS common library (colors, separator, run_spinner, loggers, helpers)
# Prefers the sibling ../lib/common.sh (repo checkout or installed layout) and
# only hits the network when this script is run standalone via curl.
LXS_RAW_BASE="${LXS_RAW_BASE:-https://git.hyko.cx/hykocx/lxs/raw/branch/main}"
_lib=$(curl -fsSL "${LXS_RAW_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
LXS_RAW_PLATFORM_BASE="${LXS_RAW_PLATFORM_BASE:-${LXS_RAW_BASE}/linux}"
_lxs_lib=""
if [ -n "${BASH_SOURCE[0]:-}" ]; then
_lxs_self=$(readlink -f "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self=$(realpath "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self="${BASH_SOURCE[0]}"
_lxs_lib="$(dirname "$_lxs_self")/../lib/common.sh"
fi
if [ -n "$_lxs_lib" ] && [ -r "$_lxs_lib" ]; then
# shellcheck disable=SC1090,SC1091
. "$_lxs_lib"
else
_lib=$(curl -fsSL "${LXS_RAW_PLATFORM_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
fi
unset _lxs_lib _lxs_self
export LXS_LOG_FILE="/tmp/lxs_update_server.log"
require_root "$0" "$@"
+19 -3
View File
@@ -6,10 +6,26 @@
# Date: 2025
# Load LXS common library (colors, separator, run_spinner, loggers, helpers)
# Prefers the sibling ../lib/common.sh (repo checkout or installed layout) and
# only hits the network when this script is run standalone via curl.
LXS_RAW_BASE="${LXS_RAW_BASE:-https://git.hyko.cx/hykocx/lxs/raw/branch/main}"
_lib=$(curl -fsSL "${LXS_RAW_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
LXS_RAW_PLATFORM_BASE="${LXS_RAW_PLATFORM_BASE:-${LXS_RAW_BASE}/linux}"
_lxs_lib=""
if [ -n "${BASH_SOURCE[0]:-}" ]; then
_lxs_self=$(readlink -f "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self=$(realpath "${BASH_SOURCE[0]}" 2>/dev/null) \
|| _lxs_self="${BASH_SOURCE[0]}"
_lxs_lib="$(dirname "$_lxs_self")/../lib/common.sh"
fi
if [ -n "$_lxs_lib" ] && [ -r "$_lxs_lib" ]; then
# shellcheck disable=SC1090,SC1091
. "$_lxs_lib"
else
_lib=$(curl -fsSL "${LXS_RAW_PLATFORM_BASE}/lib/common.sh") || { echo "Failed to fetch lib/common.sh" >&2; exit 1; }
eval "$_lib"
unset _lib
fi
unset _lxs_lib _lxs_self
export LXS_LOG_FILE="/tmp/lxs_welcome_message.log"
require_root "$0" "$@"