feat(os/freebsd): add support

Configs/.local/bin/hyde-shell

@@ -532,8 +532,18 @@ export BIN_DIR LIB_DIR SHARE_DIR PATH HYDE_SCRIPTS_PATH
 
 #*--------------------------------------------------------------------------------
 
+if [[ -z "${XDG_RUNTIME_DIR:-}" ]]; then
+	if [[ "$(uname -s)" == "FreeBSD" ]]; then
+		export XDG_RUNTIME_DIR="/tmp/runtime-$(id -u)"
+	else
+		export XDG_RUNTIME_DIR="/run/user/$(id -u)"
+	fi
+fi
+[[ -d "${XDG_RUNTIME_DIR}" ]] || mkdir -p "${XDG_RUNTIME_DIR}"
+chmod 700 "${XDG_RUNTIME_DIR}" 2>/dev/null || true
+
 # Prepare runtime directory for hyde
-[[ -d "${XDG_RUNTIME_DIR:-/run/user/$(id -u)}/hyde" ]] || mkdir -p "${XDG_RUNTIME_DIR:-/run/user/$(id -u)}/hyde"
+[[ -d "${XDG_RUNTIME_DIR}/hyde" ]] || mkdir -p "${XDG_RUNTIME_DIR}/hyde"
 
 # Priority commands
 case "$1" in

Configs/.local/lib/hyde/globalcontrol.sh

@@ -3,7 +3,15 @@ export XDG_CONFIG_HOME="${XDG_CONFIG_HOME:-$HOME/.config}"
 export XDG_DATA_HOME="${XDG_DATA_HOME:-$HOME/.local/share}"
 export XDG_CACHE_HOME="${XDG_CACHE_HOME:-$HOME/.cache}"
 export XDG_STATE_HOME="${XDG_STATE_HOME:-$HOME/.local/state}"
-export XDG_RUNTIME_DIR="${XDG_RUNTIME_DIR:-/run/user/$(id -u)}"
+if [[ -z "${XDG_RUNTIME_DIR:-}" ]]; then
+    if [[ "$(uname -s)" == "FreeBSD" ]]; then
+        export XDG_RUNTIME_DIR="/tmp/runtime-$(id -u)"
+    else
+        export XDG_RUNTIME_DIR="/run/user/$(id -u)"
+    fi
+fi
+[[ -d "${XDG_RUNTIME_DIR}" ]] || mkdir -p "${XDG_RUNTIME_DIR}"
+chmod 700 "${XDG_RUNTIME_DIR}" 2>/dev/null || true
 export HYDE_CONFIG_HOME="$XDG_CONFIG_HOME/hyde"
 export HYDE_DATA_HOME="$XDG_DATA_HOME/hyde"
 export HYDE_CACHE_HOME="$XDG_CACHE_HOME/hyde"
@@ -178,6 +186,7 @@ get_themes() {
     unset thmSort
     unset thmList
     unset thmWall
+    [ -d "$HYDE_CONFIG_HOME/themes" ] || return 0
     while read -r thmDir; do
         local realWallPath
         realWallPath="$(readlink "$thmDir/wall.set")"
@@ -215,7 +224,7 @@ case "$enableWallDcol" in
 esac
 if [ -z "$HYDE_THEME" ] || [ ! -d "$HYDE_CONFIG_HOME/themes/$HYDE_THEME" ]; then
     get_themes
-    HYDE_THEME="${thmList[0]}"
+    [ "${#thmList[@]}" -gt 0 ] && HYDE_THEME="${thmList[0]}"
 fi
 HYDE_THEME_DIR="$HYDE_CONFIG_HOME/themes/$HYDE_THEME"
 WALLBASH_DIRS=(

Configs/.local/lib/hyde/pm.sh

@@ -207,7 +207,7 @@ skip_table_header() {
 xargs_self() {
     xargs -r sh -c '"$0" "$@" </dev/tty' "$0" "$@"
 }
-PMS="paru yay pacman apt dnf zypper apk brew scoop flatpak"
+PMS="paru yay pacman pkg apt dnf zypper apk brew scoop flatpak"
 pm_detect() {
     if [ ! "${PM-}" ]; then
         for NAME in $PMS; do
@@ -290,6 +290,41 @@ pacman_is_installed() {
 pacman_file_query() {
     pacman -F "$1"
 }
+pkg_install() {
+    sudo pkg install -y "$@"
+}
+pkg_remove() {
+    sudo pkg delete -y "$@"
+}
+pkg_upgrade() {
+    sudo pkg upgrade -y
+}
+pkg_fetch() {
+    sudo pkg update
+}
+pkg_info() {
+    pkg info "$1" 2> /dev/null || pkg search -x "$1"
+}
+pkg_list_all() {
+    pkg rquery '%n %v'
+}
+pkg_list_installed() {
+    pkg query '%n %v'
+}
+pkg_format_all() {
+    awk "{ print $FMT_NAME \$1 $FMT_VERSION \$2 $FMT_RESET }"
+}
+pkg_format_installed() {
+    awk "{ print $FMT_NAME \$1 $FMT_VERSION \$2 $FMT_RESET }"
+}
+pkg_is_installed() {
+    pkg info -e "$1" > /dev/null 2>&1 && echo "Installed" || {
+        echo "Not installed" && return 1
+    }
+}
+pkg_file_query() {
+    pkg which "$1"
+}
 AUR_HELPERS="paru paru-bin yay yay-bin"
 aur_helpers_contain() {
     for NAME in $AUR_HELPERS; do

Configs/.local/lib/hyde/pyutils/pip_env.py

@@ -20,7 +20,7 @@
 
 def is_venv_valid(venv_path):
     """Returns whether the venv is valid or not
-    
+
     Args:
         venv_path: Path to the virtual environment to validate
     """
@@ -32,8 +32,8 @@ def is_venv_valid(venv_path):
     # 1.- Must have its own python file and it must be executable
     if not (os.path.isfile(python_exe) and os.access(python_exe, os.X_OK)):
         return False
-    
-    # 2.- Python inside venv must be able to import pip 
+
+    # 2.- Python inside venv must be able to import pip
     try:
         res = subprocess.run(
             [python_exe, "-c", "import pip"],
@@ -45,7 +45,7 @@ def is_venv_valid(venv_path):
             return False
     except Exception:
         return False
-    
+
     # 3.- Python version used to create the venv must match current one
     if os.path.exists(pyvenv_cfg):
         try:
@@ -345,9 +345,12 @@ def main(args):
     args = parser.parse_args(args)
 
     venv_path = get_venv_path()
-    requirements_file = os.path.join(
-        xdg_base_dirs.user_lib_dir(), "hyde", "pyutils", "requirements.txt"
-    )
+    requirements_dir = os.path.join(xdg_base_dirs.user_lib_dir(), "hyde", "pyutils")
+    requirements_file = os.path.join(requirements_dir, "requirements.txt")
+    if sys.platform.startswith("freebsd"):
+        freebsd_requirements = os.path.join(requirements_dir, "requirements-freebsd.txt")
+        if os.path.exists(freebsd_requirements):
+            requirements_file = freebsd_requirements
 
     if args.command == "create":
         args.func(venv_path, requirements_file)

Configs/.local/lib/hyde/pyutils/requirements-freebsd.txt

@@ -0,0 +1,4 @@
+loguru==0.7.3
+pulsectl==24.12.0
+requests==2.32.4
+PyGObject

Configs/.local/lib/hyde/resetxdgportal.sh

@@ -6,6 +6,8 @@ killall -e xdg-desktop-portal
 sleep 1
 if [ -d /run/current-system/sw/libexec ]; then
     libDir=/run/current-system/sw/libexec
+elif [ -d /usr/local/libexec ]; then
+    libDir=/usr/local/libexec
 else
     libDir=/usr/lib
 fi

Configs/.local/lib/hyde/theme.switch.sh

@@ -3,6 +3,13 @@
 [ -z "$HYDE_THEME" ] && echo "ERROR: unable to detect theme" && exit 1
 get_themes
 confDir="${XDG_CONFIG_HOME:-$HOME/.config}"
+sed_in_place() {
+    if sed --version >/dev/null 2>&1; then
+        sed -i "$@"
+    else
+        sed -i '' "$@"
+    fi
+}
 Theme_Change() {
     local x_switch=$1
     for i in "${!thmList[@]}"; do
@@ -85,7 +92,7 @@ sanitize_hypr_theme() {
     dirty_regex+=("${HYPR_CONFIG_SANITIZE[@]}")
     for pattern in "${dirty_regex[@]}"; do
         grep -E "$pattern" "$buffer_file" | while read -r line; do
-            sed -i "\|$line|d" "$buffer_file"
+            sed_in_place "\|$line|d" "$buffer_file"
             print_log -sec "theme" -warn "sanitize" "$line"
         done
     done
@@ -130,8 +137,12 @@ if [[ -r $HYPRLAND_CONFIG ]]; then
     load_hypr_variables "${XDG_STATE_DIR:-$HOME/.local/state}/hyde/hyprland.conf"
 fi
 show_theme_status
-if ! dconf write /org/gnome/desktop/interface/icon-theme "'$ICON_THEME'"; then
-    print_log -sec "theme" -warn "dconf" "failed to set icon theme"
+if command -v dconf >/dev/null 2>&1 && { [[ -n "${DBUS_SESSION_BUS_ADDRESS:-}" ]] || [[ -n "${DISPLAY:-}" ]]; }; then
+    if ! dconf write /org/gnome/desktop/interface/icon-theme "'$ICON_THEME'"; then
+        print_log -sec "theme" -warn "dconf" "failed to set icon theme"
+    fi
+else
+    print_log -sec "theme" -warn "dconf" "no active DBus session; skipping icon theme write"
 fi
 if [ -d /run/current-system/sw/share/themes ]; then
     export themesDir=/run/current-system/sw/share/themes
@@ -159,10 +170,10 @@ toml_write "$confDir/kdeglobals" "UiSettings" "ColorScheme" "colors"
 toml_write "$confDir/kdeglobals" "KDE" "widgetStyle" "kvantum"
 toml_write "$XDG_DATA_HOME/icons/default/index.theme" "Icon Theme" "Inherits" "$CURSOR_THEME"
 toml_write "$HOME/.icons/default/index.theme" "Icon Theme" "Inherits" "$CURSOR_THEME"
-sed -i -e "/^gtk-theme-name=/c\gtk-theme-name=\"$GTK_THEME\"" \
-    -e "/^include /c\include \"$HOME/.gtkrc-2.0.mime\"" \
-    -e "/^gtk-cursor-theme-name=/c\gtk-cursor-theme-name=\"$CURSOR_THEME\"" \
-    -e "/^gtk-icon-theme-name=/c\gtk-icon-theme-name=\"$ICON_THEME\"" "$HOME/.gtkrc-2.0"
+sed_in_place -e "s|^gtk-theme-name=.*$|gtk-theme-name=\"$GTK_THEME\"|" \
+    -e "s|^include .*$|include \"$HOME/.gtkrc-2.0.mime\"|" \
+    -e "s|^gtk-cursor-theme-name=.*$|gtk-cursor-theme-name=\"$CURSOR_THEME\"|" \
+    -e "s|^gtk-icon-theme-name=.*$|gtk-icon-theme-name=\"$ICON_THEME\"|" "$HOME/.gtkrc-2.0"
 GTK3_FONT="${GTK3_FONT:-$FONT}"
 GTK3_FONT_SIZE="${GTK3_FONT_SIZE:-$FONT_SIZE}"
 toml_write "$confDir/gtk-3.0/settings.ini" "Settings" "gtk-theme-name" "$GTK_THEME"
@@ -193,10 +204,10 @@ if pkg_installed flatpak; then
         --env=ICON_THEME="$ICON_THEME"
     flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo &
 fi
-sed -i -e "/^Net\/ThemeName /c\Net\/ThemeName \"$GTK_THEME\"" \
-    -e "/^Net\/IconThemeName /c\Net\/IconThemeName \"$ICON_THEME\"" \
-    -e "/^Gtk\/CursorThemeName /c\Gtk\/CursorThemeName \"$CURSOR_THEME\"" \
-    -e "/^Gtk\/CursorThemeSize /c\Gtk\/CursorThemeSize $CURSOR_SIZE" \
+sed_in_place -e "s|^Net/ThemeName .*$|Net/ThemeName \"$GTK_THEME\"|" \
+    -e "s|^Net/IconThemeName .*$|Net/IconThemeName \"$ICON_THEME\"|" \
+    -e "s|^Gtk/CursorThemeName .*$|Gtk/CursorThemeName \"$CURSOR_THEME\"|" \
+    -e "s|^Gtk/CursorThemeSize .*$|Gtk/CursorThemeSize $CURSOR_SIZE|" \
     "$confDir/xsettingsd/xsettingsd.conf"
 if [ ! -L "$HOME/.themes/$GTK_THEME" ] && [ -d "$themesDir/$GTK_THEME" ]; then
     print_log -sec "theme" -warn "linking" "$GTK_THEME to ~/.themes to fix GTK4 not following xdg"
@@ -205,8 +216,8 @@ if [ ! -L "$HOME/.themes/$GTK_THEME" ] && [ -d "$themesDir/$GTK_THEME" ]; then
     ln -snf "$themesDir/$GTK_THEME" "$HOME/.themes/"
 fi
 if [ -f "$HOME/.Xresources" ]; then
-    sed -i -e "/^Xcursor\.theme:/c\Xcursor.theme: $CURSOR_THEME" \
-        -e "/^Xcursor\.size:/c\Xcursor.size: $CURSOR_SIZE" "$HOME/.Xresources"
+    sed_in_place -e "s|^Xcursor\.theme:.*$|Xcursor.theme: $CURSOR_THEME|" \
+        -e "s|^Xcursor\.size:.*$|Xcursor.size: $CURSOR_SIZE|" "$HOME/.Xresources"
     grep -q "^Xcursor\.theme:" "$HOME/.Xresources" || echo "Xcursor.theme: $CURSOR_THEME" >>"$HOME/.Xresources"
     grep -q "^Xcursor\.size:" "$HOME/.Xresources" || echo "Xcursor.size: 30" >>"$HOME/.Xresources"
 else
@@ -216,8 +227,8 @@ Xcursor.size: $CURSOR_SIZE
 EOF
 fi
 if [ -f "$HOME/.Xdefaults" ]; then
-    sed -i -e "/^Xcursor\.theme:/c\Xcursor.theme: $CURSOR_THEME" \
-        -e "/^Xcursor\.size:/c\Xcursor.size: $CURSOR_SIZE" "$HOME/.Xdefaults"
+    sed_in_place -e "s|^Xcursor\.theme:.*$|Xcursor.theme: $CURSOR_THEME|" \
+        -e "s|^Xcursor\.size:.*$|Xcursor.size: $CURSOR_SIZE|" "$HOME/.Xdefaults"
     grep -q "^Xcursor\.theme:" "$HOME/.Xdefaults" || echo "Xcursor.theme: $CURSOR_THEME" >>"$HOME/.Xdefaults"
     grep -q "^Xcursor\.size:" "$HOME/.Xdefaults" || echo "Xcursor.size: 30" >>"$HOME/.Xdefaults"
 fi

Configs/.local/lib/hyde/waybar.py

@@ -68,6 +68,7 @@
 STATE_FILE = Path(os.path.join(str(xdg_state_home()), "hyde", "staterc"))
 HYDE_CONFIG = Path(os.path.join(str(xdg_state_home()), "hyde", "config"))
 UNIT_NAME = f"hyde-{os.environ.get('XDG_SESSION_DESKTOP', 'unknown')}-bar.service"
+HAS_SYSTEMCTL = shutil.which("systemctl") is not None
 
 
 def source_env_file(filepath):
@@ -500,6 +501,10 @@ def signal_handler(sig, frame):
 
 def is_waybar_running_for_current_user():
     """Check if Waybar or Waybar-wrapped is running for the current user only."""
+    if not HAS_SYSTEMCTL:
+        result = subprocess.run(["pgrep", "-x", "waybar"], capture_output=True, text=True)
+        return result.returncode == 0
+
     check_cmd = ["systemctl", "--user", "is-active", UNIT_NAME]
     try:
         result = subprocess.run(check_cmd, capture_output=True, text=True)
@@ -514,6 +519,14 @@ def is_waybar_running_for_current_user():
 
 def run_waybar():
     """Run Waybar using hyde-shell app with systemd unit, let systemd handle logging."""
+    if not HAS_SYSTEMCTL:
+        if not is_waybar_running_for_current_user():
+            subprocess.Popen(["waybar"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+            logger.debug("Waybar launched directly (no systemctl available)")
+        else:
+            logger.debug("Waybar already running (direct mode)")
+        return
+
     # check_cmd = ["systemctl", "--user", "is-active", "--quiet", UNIT_NAME]
     run_cmd = ["hyde-shell", "app", "-u", UNIT_NAME, "-t", "service", "--", "waybar"]
     # Check if the unit is active
@@ -528,6 +541,11 @@ def run_waybar():
 def kill_waybar():
     """Kill only the current user's Waybar process."""
     """Stop Waybar systemd unit for current session desktop."""
+    if not HAS_SYSTEMCTL:
+        subprocess.run(["pkill", "-x", "waybar"])
+        logger.debug("Stopped Waybar process directly (no systemctl available)")
+        return
+
     subprocess.run(["systemctl", "--user", "stop", UNIT_NAME])
     logger.debug(f"Stopped Waybar systemd unit: {UNIT_NAME}")
 
@@ -544,6 +562,9 @@ def kill_waybar_and_watcher():
     kill_waybar()
     logger.debug("Killed Waybar processes for current user.")
 
+    if not HAS_SYSTEMCTL:
+        return
+
     try:
         watcher_unit = f"hyde-{os.getenv('XDG_SESSION_DESKTOP')}-waybar-watcher.service"
         result = subprocess.run(
@@ -1441,8 +1462,12 @@ def main():
 
     if args.hide:
         # Send SIGUSR1 to Waybar systemd unit
-        cmd = ["systemctl", "--user", "kill", "-s", "SIGUSR1", UNIT_NAME]
-        logger.info(f"Sending SIGUSR1 to {UNIT_NAME} via systemctl")
+        if HAS_SYSTEMCTL:
+            cmd = ["systemctl", "--user", "kill", "-s", "SIGUSR1", UNIT_NAME]
+            logger.info(f"Sending SIGUSR1 to {UNIT_NAME} via systemctl")
+        else:
+            cmd = ["pkill", "-USR1", "-x", "waybar"]
+            logger.info("Sending SIGUSR1 to waybar directly (no systemctl)")
         subprocess.run(cmd)
         sys.exit(0)
 

README.md

@@ -47,6 +47,7 @@ Multi-language README support
     <img src="Source/assets/endeavouros.png" alt="EndeavourOS" style="width: 10%; margin: 10px;"/>
     <img src="Source/assets/garuda.png" alt="Garuda" style="width: 10%; margin: 10px;"/>
     <img src="Source/assets/nixos.png" alt="NixOS" style="width: 10%; margin: 10px;"/>
+    <img src="Source/assets/freebsd.png" alt="FreeBSD" style="width: 10%; margin: 10px;"/>
   </div>
 </div>
 
@@ -73,6 +74,8 @@ While installing HyDE alongside another [DE](https://wiki.archlinux.org/title/De
 
 For NixOS support there is a separate project being maintained @ [Hydenix](https://github.com/richen604/hydenix/tree/main)
 
+[FreeBSD](https://www.freebsd.org) is supported via HydeBSD. Due to differences in bootloader, kernel, userspace, and package availability, not all features of HyDE may be present.
+
 > [!IMPORTANT]
 > The install script will auto-detect an NVIDIA card and install nvidia-open-dkms drivers for your kernel.
 > For legacy cards [check this first](./Scripts/nvidia-db/)

Scripts/global_fn.sh

@@ -23,8 +23,19 @@ export shlList
 
 pkg_installed() {
     local PkgIn=$1
+    local PkgResolved
 
-    if pacman -Q "${PkgIn}" &>/dev/null; then
+    case "${PkgIn}" in
+    kvantum) PkgResolved="Kvantum" ;;
+    imagemagick) PkgResolved="ImageMagick7" ;;
+    *) PkgResolved="${PkgIn}" ;;
+    esac
+
+    if [[ "${PkgIn}" == "zsh-theme-powerlevel10k" ]] && [[ -d "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k" ]]; then
+        return 0
+    fi
+
+    if "${pacmanCmd}" query "${PkgResolved}" &>/dev/null; then
         return 0
     else
         return 1