theamify-cli 1.0.1

package/vendor/lib/colors.sh

@@ -0,0 +1,151 @@
+#!/usr/bin/env bash
+# -----------------------------------------------------------------------------
+# lib/colors.sh - ANSI Colors, Print Functions & UI Components
+# -----------------------------------------------------------------------------
+
+RESET=$'\033[0m';    BOLD=$'\033[1m';  DIM=$'\033[2m'
+ITALIC=$'\033[3m';   UNDERLINE=$'\033[4m'
+
+BLACK=$'\033[0;30m'; RED=$'\033[0;31m';     GREEN=$'\033[0;32m'
+YELLOW=$'\033[0;33m';BLUE=$'\033[0;34m';    MAGENTA=$'\033[0;35m'
+CYAN=$'\033[0;36m';  WHITE=$'\033[0;37m'
+
+BOLD_BLACK=$'\033[1;30m';   BOLD_RED=$'\033[1;31m';     BOLD_GREEN=$'\033[1;32m'
+BOLD_YELLOW=$'\033[1;33m';  BOLD_BLUE=$'\033[1;34m';    BOLD_MAGENTA=$'\033[1;35m'
+BOLD_CYAN=$'\033[1;36m';    BOLD_WHITE=$'\033[1;37m'
+
+BRIGHT_RED=$'\033[0;91m';   BRIGHT_GREEN=$'\033[0;92m'; BRIGHT_YELLOW=$'\033[0;93m'
+BRIGHT_BLUE=$'\033[0;94m';  BRIGHT_MAGENTA=$'\033[0;95m';BRIGHT_CYAN=$'\033[0;96m'
+BRIGHT_WHITE=$'\033[0;97m'
+
+BG_BLACK=$'\033[40m';  BG_RED=$'\033[41m';  BG_GREEN=$'\033[42m'
+BG_YELLOW=$'\033[43m'; BG_BLUE=$'\033[44m'; BG_MAGENTA=$'\033[45m'
+BG_CYAN=$'\033[46m';   BG_WHITE=$'\033[47m'
+
+C_TITLE="${BOLD_CYAN}"
+C_SUBTITLE="${BOLD_MAGENTA}"
+C_SECTION="${BOLD_YELLOW}"
+C_SUCCESS="${BOLD_GREEN}"
+C_ERROR="${BOLD_RED}"
+C_WARNING="${YELLOW}"
+C_INFO="${CYAN}"
+C_DIM="${DIM}${WHITE}"
+C_HIGHLIGHT="${BOLD_WHITE}"
+C_PROMPT="${BOLD_BLUE}"
+C_ACTIVE="${BOLD_GREEN}"
+C_INACTIVE="${DIM}${WHITE}"
+C_STEP="${BRIGHT_CYAN}"
+C_CMD="${DIM}${GREEN}"
+C_LINK="${UNDERLINE}${BRIGHT_BLUE}"
+C_TAG="${BRIGHT_MAGENTA}"
+C_NUM="${BOLD_YELLOW}"
+C_BORDER="${BOLD_BLUE}"
+
+if [[ -n "${NO_COLOR:-}" ]] || [[ ! -t 1 ]]; then
+    RESET="" BOLD="" DIM="" ITALIC="" UNDERLINE=""
+    BLACK="" RED="" GREEN="" YELLOW="" BLUE="" MAGENTA="" CYAN="" WHITE=""
+    BOLD_BLACK="" BOLD_RED="" BOLD_GREEN="" BOLD_YELLOW="" BOLD_BLUE=""
+    BOLD_MAGENTA="" BOLD_CYAN="" BOLD_WHITE=""
+    BRIGHT_RED="" BRIGHT_GREEN="" BRIGHT_YELLOW="" BRIGHT_BLUE=""
+    BRIGHT_MAGENTA="" BRIGHT_CYAN="" BRIGHT_WHITE=""
+    BG_BLACK="" BG_RED="" BG_GREEN="" BG_YELLOW="" BG_BLUE=""
+    BG_MAGENTA="" BG_CYAN="" BG_WHITE=""
+    C_TITLE="" C_SUBTITLE="" C_SECTION="" C_SUCCESS="" C_ERROR=""
+    C_WARNING="" C_INFO="" C_DIM="" C_HIGHLIGHT="" C_PROMPT=""
+    C_ACTIVE="" C_INACTIVE="" C_STEP="" C_CMD="" C_LINK=""
+    C_TAG="" C_NUM="" C_BORDER=""
+fi
+
+print_title()   { echo -e "${C_TITLE}${*}${RESET}"; }
+print_section() { echo -e "\n${C_SECTION}== ${*}${RESET}"; }
+print_success() { echo -e "${C_SUCCESS}[OK]${RESET} ${*}"; }
+print_error()   { echo -e "${C_ERROR}[ERR]${RESET} ${*}" >&2; }
+print_warning() { echo -e "${C_WARNING}[WARN]${RESET} ${*}"; }
+print_info()    { echo -e "${C_INFO}[INFO]${RESET} ${*}"; }
+print_step()    { echo -e "${C_STEP}->${RESET} ${*}"; }
+print_dim()     { echo -e "${C_DIM}${*}${RESET}"; }
+print_cmd()     { echo -e "${C_CMD}  \$ ${*}${RESET}"; }
+print_link()    { echo -e "${C_LINK}${*}${RESET}"; }
+print_bold()    { echo -e "${BOLD_WHITE}${*}${RESET}"; }
+
+_term_width() {
+    local w; w="$(tput cols 2>/dev/null || echo 80)"
+    (( w > 100 )) && w=100
+    echo "${w}"
+}
+
+print_rule() {
+    local char="${1:--}"
+    local w; w="$(_term_width)"
+    printf '%s' "${C_BORDER}"
+    printf '%*s' "${w}" '' | tr ' ' "${char}"
+    printf '%s\n' "${RESET}"
+}
+
+print_box_title() {
+    local title="${1}"
+    local w; w="$(_term_width)"
+    local inner=$(( w - 4 ))
+    local tlen="${#title}"
+    local lpad=$(( (inner - tlen) / 2 ))
+    (( lpad < 0 )) && lpad=0
+    local rpad=$(( inner - tlen - lpad ))
+    (( rpad < 0 )) && rpad=0
+
+    print_rule "-"
+    printf '%s|%s %s%*s%s%*s %s|%s\n' \
+        "${C_BORDER}" "${RESET}" "${C_TITLE}" \
+        "${lpad}" "" "${title}" "${rpad}" "" "${C_BORDER}" "${RESET}"
+    print_rule "-"
+}
+
+print_kv() {
+    local key="${1}" val="${2}"
+    printf "  ${BOLD_WHITE}%-20s${RESET} %b\n" "${key}:" "${val}"
+}
+
+print_status() {
+    case "${1:-}" in
+        active)   printf '%s[ACTIVE]%s'  "${C_ACTIVE}" "${RESET}" ;;
+        cached)   printf '%s[CACHED]%s'  "${C_INFO}"   "${RESET}" ;;
+        remote)   printf '%s[REMOTE]%s'  "${C_DIM}"    "${RESET}" ;;
+        error)    printf '%s[ERROR]%s'   "${C_ERROR}"  "${RESET}" ;;
+        *)        printf '%s[UNKNOWN]%s' "${C_DIM}"    "${RESET}" ;;
+    esac
+}
+
+print_banner() {
+    print_rule "="
+    echo -e "  ${C_TITLE}${BOLD}theamify${RESET} ${C_DIM}v${VERSION:-1.0.0}${RESET} ${C_DIM}- GRUB Theme Manager${RESET}"
+    echo -e "  ${C_DIM}by Don Artkins${RESET}"
+    print_rule "="
+    echo
+}
+
+SPINNER_FRAMES=('|' '/' '-' '\')
+SPINNER_PID=""
+
+spinner_start() {
+    local msg="${1:-Working}"
+    (
+        local i=0
+        while true; do
+            # >&2 is mandatory: get_repo() and other functions run this while
+            # their own stdout is being captured via $(...). Anything the
+            # spinner writes to fd1 lands inside that captured string.
+            printf '\r  %s%s%s %s...' "${C_STEP}" "${SPINNER_FRAMES[$((i % 4))]}" "${RESET}" "${msg}" >&2
+            sleep 0.1
+            i=$(( i + 1 ))
+        done
+    ) &
+    SPINNER_PID=$!
+    disown "${SPINNER_PID}" 2>/dev/null || true
+}
+
+spinner_stop() {
+    if [[ -n "${SPINNER_PID:-}" ]]; then
+        kill "${SPINNER_PID}" 2>/dev/null || true
+        SPINNER_PID=""
+        printf '\r\033[K' >&2
+    fi
+}

package/vendor/lib/grub.sh

@@ -0,0 +1,179 @@
+#!/usr/bin/env bash
+# -----------------------------------------------------------------------------
+# lib/grub.sh - GRUB Detection & Management
+# -----------------------------------------------------------------------------
+
+# -- Detect GRUB themes directory ---------------------------------------------
+grub_detect_dir() {
+    local candidates=(
+        "/boot/grub/themes"
+        "/boot/grub2/themes"
+        "/usr/share/grub/themes"
+    )
+    for d in "${candidates[@]}"; do
+        [[ -d "${d}" ]] && echo "${d}" && return 0
+    done
+    echo "/boot/grub/themes"   # default fallback - will be created on apply
+}
+
+# -- Detect GRUB update command ------------------------------------------------
+grub_detect_update_cmd() {
+    if command -v update-grub &>/dev/null; then
+        echo "update-grub"
+    elif command -v grub-mkconfig &>/dev/null; then
+        echo "grub-mkconfig -o /boot/grub/grub.cfg"
+    elif command -v grub2-mkconfig &>/dev/null; then
+        if command -v zypper &>/dev/null; then
+            echo "grub2-mkconfig -o /boot/grub2/grub.cfg"
+        elif command -v dnf &>/dev/null; then
+            echo "grub2-mkconfig -o /boot/efi/EFI/fedora/grub.cfg"
+        else
+            echo "grub2-mkconfig -o /boot/grub2/grub.cfg"
+        fi
+    else
+        return 1
+    fi
+}
+
+# -- Get name of currently active GRUB theme ----------------------------------
+grub_get_active_theme() {
+    local cfg="${GRUB_CFG:-/etc/default/grub}"
+    [[ ! -f "${cfg}" ]] && echo "" && return 0
+
+    local line
+    line="$(grep '^GRUB_THEME=' "${cfg}" 2>/dev/null | tail -1 || true)"
+    [[ -z "${line}" ]] && echo "" && return 0
+
+    local path
+    path="$(echo "${line}" | cut -d= -f2- | tr -d '"' | tr -d "'")"
+    # The theme folder is the parent dir of theme.txt
+    dirname "${path}" 2>/dev/null | xargs basename 2>/dev/null || echo ""
+}
+
+# -- Backup GRUB config --------------------------------------------------------
+grub_backup() {
+    local cfg="${GRUB_CFG:-/etc/default/grub}"
+    local bak="${cfg}.bak.$(date +%Y%m%d_%H%M%S)"
+    cp -a "${cfg}" "${bak}"
+    print_dim "  Backed up: ${bak}"
+}
+
+# ==============================================================================
+#  Apply theme to GRUB  (4-stage process)
+# ==============================================================================
+grub_apply_theme() {
+    local theme_name="${1}"
+    local cached="${THEMES_CACHE_DIR}/${theme_name}"
+    local grub_dir
+    grub_dir="$(grub_detect_dir)"
+    local cfg="${GRUB_CFG:-/etc/default/grub}"
+
+    echo
+    print_box_title " Applying Theme: ${theme_name} "
+
+    # -- Stage 1 : Verify cached theme -----------------------------------------
+    print_section "Stage 1 of 4 - Verify"
+
+    if [[ ! -d "${cached}" ]]; then
+        print_error "Theme '${theme_name}' is not cached."
+        print_step "Run: theamify get ${theme_name}"
+        exit 1
+    fi
+
+    local theme_txt
+    theme_txt="$(find_theme_txt "${cached}")" || {
+        print_error "No theme.txt found in cache for '${theme_name}'."
+        print_warning "This theme may require its own install script."
+        print_step "Check the repo: theamify open ${theme_name}"
+        exit 1
+    }
+    print_success "theme.txt found: ${theme_txt}"
+
+    # -- Stage 2 : Install theme files -----------------------------------------
+    print_section "Stage 2 of 4 - Install Files"
+
+    local dest="${grub_dir}/${theme_name}"
+    mkdir -p "${grub_dir}"
+    [[ -d "${dest}" ]] && rm -rf "${dest}"
+
+    print_step "Copying to: ${dest}"
+    cp -r "${cached}" "${dest}"
+
+    local dest_txt
+    dest_txt="$(find_theme_txt "${dest}")" || {
+        print_error "theme.txt not found after copying. Something went wrong."
+        exit 1
+    }
+    print_success "Theme files installed."
+
+    # -- Stage 3 : Configure /etc/default/grub --------------------------------
+    print_section "Stage 3 of 4 - Configure GRUB"
+
+    grub_backup
+
+    # Remove any old conflicting options
+    sed -i '/^GRUB_THEME=/d'          "${cfg}"
+    sed -i '/^GRUB_TERMINAL_OUTPUT=/d' "${cfg}"
+    sed -i '/^GRUB_TIMEOUT_STYLE=/d'  "${cfg}"
+    sed -i '/^GRUB_GFXMODE=/d'        "${cfg}"
+
+    # Set timeout style to show menu
+    echo 'GRUB_TIMEOUT_STYLE="menu"'   >> "${cfg}"
+    echo 'GRUB_GFXMODE="auto"'         >> "${cfg}"
+    # Set timeout if not already defined
+    grep -q '^GRUB_TIMEOUT=' "${cfg}" || echo 'GRUB_TIMEOUT="30"' >> "${cfg}"
+    # Point GRUB at theme
+    echo "GRUB_THEME=\"${dest_txt}\""  >> "${cfg}"
+
+    print_success "GRUB config updated."
+    print_kv "GRUB_THEME" "${dest_txt}"
+
+    # -- Stage 4 : Rebuild GRUB config ----------------------------------------
+    print_section "Stage 4 of 4 - Rebuild GRUB"
+
+    local update_cmd
+    update_cmd="$(grub_detect_update_cmd)" || {
+        print_error "No GRUB update command found."
+        print_step "Run manually: update-grub  OR  grub-mkconfig -o /boot/grub/grub.cfg"
+        exit 1
+    }
+
+    print_step "Running: ${update_cmd}"
+    if eval "${update_cmd}"; then
+        print_success "GRUB rebuilt successfully."
+    else
+        print_error "GRUB rebuild failed. Check your GRUB setup."
+        exit 1
+    fi
+
+    # -- Done ------------------------------------------------------------------
+    echo
+    print_rule "="
+    echo -e "\n  ${C_SUCCESS}${BOLD}Theme '${theme_name}' is now active!${RESET}"
+    echo
+    print_step "Next steps:"
+    echo -e "  ${C_DIM}1.${RESET}  Reboot -> ${C_CMD}sudo reboot${RESET}"
+    echo -e "  ${C_DIM}2.${RESET}  Switch -> ${C_CMD}sudo theamify use <name>${RESET}"
+    echo -e "  ${C_DIM}3.${RESET}  Browse -> ${C_CMD}theamify list${RESET}"
+    echo
+}
+
+# -- Remove theme from GRUB (does NOT remove cache) ---------------------------
+grub_remove_theme() {
+    local theme_name="${1}"
+    local grub_dir
+    grub_dir="$(grub_detect_dir)"
+    local dest="${grub_dir}/${theme_name}"
+    local cfg="${GRUB_CFG:-/etc/default/grub}"
+
+    [[ -d "${dest}" ]] && rm -rf "${dest}" && \
+        print_success "Removed GRUB theme dir: ${dest}"
+
+    if grep -q "${theme_name}" "${cfg}" 2>/dev/null; then
+        sed -i "/GRUB_THEME=.*${theme_name}.*/d" "${cfg}"
+        print_success "Removed theme from GRUB config."
+        local update_cmd
+        update_cmd="$(grub_detect_update_cmd)" && eval "${update_cmd}" || \
+            print_warning "GRUB rebuild had issues. Run update-grub manually."
+    fi
+}

package/vendor/lib/themes.sh

@@ -0,0 +1,283 @@
+#!/usr/bin/env bash
+# -----------------------------------------------------------------------------
+# lib/themes.sh - Theme Registry CRUD & Download Logic
+# -----------------------------------------------------------------------------
+
+parse_conf() {
+    grep -v '^[[:space:]]*$' "${THEMES_CONF}" 2>/dev/null \
+        | grep -v '^#' \
+        || true
+}
+
+theme_get_entry() {
+    local name="${1}"
+    local line
+    line="$(parse_conf | grep "^${name}|" | head -1 || true)"
+    [[ -z "${line}" ]] && return 1
+    echo "${line}"
+}
+
+theme_generate_subdir() {
+    local name="${1}" repo_path="${2}" gen_args="${3}"
+
+    local gen_script="${repo_path}/generate.sh"
+    if [[ ! -f "${gen_script}" ]]; then
+        print_error "Registry entry '${name}' uses 'generate:' but no"
+        print_error "generate.sh was found at: ${gen_script}"
+        return 1
+    fi
+
+    local build_dir="${REPO_CACHE_DIR}/.build/${name}"
+    rm -rf "${build_dir}"
+    mkdir -p "${build_dir}"
+
+    print_step "Running: generate.sh -d <build_dir> ${gen_args}" >&2
+    # shellcheck disable=SC2086
+    if ! bash "${gen_script}" -d "${build_dir}" ${gen_args} >&2; then
+        print_error "generate.sh failed for '${name}'."
+        print_step "Reproduce manually: cd ${repo_path} && ./generate.sh -d <dir> ${gen_args}" >&2
+        return 1
+    fi
+
+    local -a produced=()
+    while IFS= read -r -d '' d; do
+        produced+=("${d}")
+    done < <(find "${build_dir}" -mindepth 1 -maxdepth 1 -type d -print0)
+
+    if (( ${#produced[@]} == 0 )); then
+        print_error "generate.sh ran but produced no output directory in: ${build_dir}"
+        return 1
+    fi
+    if (( ${#produced[@]} > 1 )); then
+        print_warning "generate.sh produced ${#produced[@]} directories; using: $(basename "${produced[0]}")" >&2
+    fi
+
+    echo "${produced[0]}"
+}
+
+theme_download() {
+    local name="${1}"
+    local force="${2:-}"
+
+    local line
+    line="$(theme_get_entry "${name}")" || {
+        print_error "Theme '${name}' not found in registry."
+        print_info  "Run 'theamify list' to see all themes."
+        return 1
+    }
+
+    IFS='|' read -r t_name t_url t_sub t_desc t_source t_tags <<< "${line}"
+    local dest="${THEMES_CACHE_DIR}/${t_name}"
+
+    if [[ -d "${dest}" && "${force}" != "--force" ]]; then
+        print_info "Theme '${t_name}' is already cached."
+        print_step "Re-download with: theamify update ${t_name}"
+        return 0
+    fi
+
+    print_section "Downloading: ${t_name}"
+    echo -e "  ${C_DIM}${t_desc}${RESET}"
+    echo -e "  ${C_LINK}${t_url}${RESET}"
+    echo
+
+    check_deps_required
+
+    print_step "[1/4] Fetching repository..."
+    local force_clone="false"
+    [[ "${force}" == "--force" ]] && force_clone="true"
+
+    local repo_path
+    repo_path="$(get_repo "${t_url}" "${force_clone}")" || return 1
+    print_success "Repository ready."
+
+    print_step "[2/4] Locating theme files..."
+
+    local src_path
+    if [[ "${t_sub}" == generate:* ]]; then
+        src_path="$(theme_generate_subdir "${t_name}" "${repo_path}" "${t_sub#generate:}")" || return 1
+    elif [[ "${t_sub}" == "." ]]; then
+        src_path="${repo_path}"
+    else
+        src_path="${repo_path}/${t_sub}"
+        if [[ ! -d "${src_path}" ]]; then
+            local found_dir
+            found_dir="$(find "${repo_path}" -maxdepth 4 -type d \
+                         -iname "$(basename "${t_sub}")" 2>/dev/null | head -1 || true)"
+            if [[ -n "${found_dir}" ]]; then
+                print_warning "Subdir '${t_sub}' not found exactly; using: ${found_dir}"
+                src_path="${found_dir}"
+            else
+                print_error "Theme subdir '${t_sub}' not found in repo."
+                echo
+                print_dim "  Repo contents:"
+                ls "${repo_path}" 2>/dev/null | head -20 | while read -r f; do
+                    print_dim "    ${f}"
+                done
+                return 1
+            fi
+        fi
+    fi
+    print_success "Source path: ${src_path}"
+
+    print_step "[3/4] Caching theme..."
+    [[ -d "${dest}" ]] && rm -rf "${dest}"
+    mkdir -p "${dest}"
+    cp -r "${src_path}/." "${dest}/"
+
+    rm -rf "${dest}/.git" "${dest}/.github" 2>/dev/null || true
+
+    local preview_img
+    preview_img="$(find "${dest}" -maxdepth 3 \
+                   \( -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" \) \
+                   -not -path "*/.git/*" 2>/dev/null | sort | head -1 || true)"
+    if [[ -n "${preview_img}" ]]; then
+        mkdir -p "${dest}/.preview"
+        cp "${preview_img}" "${dest}/.preview/" 2>/dev/null || true
+    fi
+
+    print_success "Cached: ${dest}"
+
+    print_step "[4/4] Validating..."
+    local theme_txt
+    theme_txt="$(find_theme_txt "${dest}")" || {
+        print_warning "No theme.txt found in '${t_name}'."
+        print_dim "  This usually means the repo has no static theme folder and"
+        print_dim "  no compatible generate.sh - SUBDIR may need fixing, or the"
+        print_dim "  repo needs a 'generate:<args>' entry (see CONTRIBUTING.md)."
+        print_dim "  Check the repo README for instructions:"
+        print_dim "  ${t_url}"
+        print_dim "  Cache is saved at: ${dest}"
+        echo
+        return 1
+    }
+
+    print_success "Valid theme - theme.txt: ${theme_txt}"
+    echo
+    echo -e "  ${C_DIM}Apply with:${RESET}  ${C_CMD}sudo theamify use ${t_name}${RESET}"
+    echo -e "  ${C_DIM}Preview at:${RESET}  ${C_CMD}theamify info ${t_name}${RESET}"
+    echo
+}
+
+theme_remove_cache() {
+    local name="${1}"
+
+    theme_get_entry "${name}" &>/dev/null || {
+        print_error "Theme '${name}' not found in registry."
+        return 1
+    }
+
+    local dest="${THEMES_CACHE_DIR}/${name}"
+    if [[ ! -d "${dest}" ]]; then
+        print_info "Theme '${name}' is not currently cached."
+        return 0
+    fi
+
+    local active
+    active="$(grub_get_active_theme)"
+    if [[ "${name}" == "${active}" ]]; then
+        print_warning "Theme '${name}' is currently active in GRUB."
+        confirm "Remove cache anyway?" || { print_info "Cancelled."; return 0; }
+    else
+        confirm "Remove local cache for '${name}'?" || { print_info "Cancelled."; return 0; }
+    fi
+
+    rm -rf "${dest}"
+    print_success "Cache removed for '${name}'."
+    print_dim "  Registry entry kept. Re-download: theamify get ${name}"
+}
+
+theme_add_to_registry() {
+    local url="${1}"
+
+    print_section "Add New Theme"
+    echo -e "  ${C_DIM}URL: ${url}${RESET}"
+
+    if ! echo "${url}" | grep -qE '^https?://(github|gitlab)\.com/'; then
+        print_error "URL must be a GitHub or GitLab repository URL."
+        return 1
+    fi
+
+    local default_name
+    default_name="$(basename "${url%.git}")"
+
+    echo
+    echo -ne "  ${C_PROMPT}Theme name${RESET} ${C_DIM}[${default_name}]${RESET}: "
+    read -r name
+    name="${name:-${default_name}}"
+
+    if parse_conf | grep -q "^${name}|"; then
+        print_error "A theme named '${name}' already exists."
+        return 1
+    fi
+
+    echo -ne "  ${C_PROMPT}Subdir within repo${RESET} ${C_DIM}[.]${RESET} ${C_DIM}(or 'generate:<args>' if the repo builds via its own generate.sh)${RESET}: "
+    read -r subdir
+    subdir="${subdir:-.}"
+
+    echo -ne "  ${C_PROMPT}Description${RESET}: "
+    read -r desc
+    desc="${desc:-Custom GRUB theme}"
+
+    echo -ne "  ${C_PROMPT}Source page URL${RESET} ${C_DIM}[${url}]${RESET}: "
+    read -r source
+    source="${source:-${url}}"
+
+    echo -ne "  ${C_PROMPT}Tags${RESET} ${C_DIM}(comma-separated)${RESET}: "
+    read -r tags
+    tags="${tags:-custom}"
+
+    local entry="${name}|${url}|${subdir}|${desc}|${source}|${tags}"
+
+    echo
+    print_section "Preview Entry"
+    echo -e "  ${C_DIM}${entry}${RESET}"
+    echo
+
+    if confirm "Add '${name}' to registry?"; then
+        echo "${entry}" >> "${THEMES_CONF}"
+        print_success "Theme '${name}' added to registry!"
+        echo -e "  ${C_DIM}Download:${RESET} ${C_CMD}theamify get ${name}${RESET}"
+        echo -e "  ${C_DIM}Apply:${RESET}    ${C_CMD}sudo theamify use ${name}${RESET}"
+    else
+        print_info "Cancelled."
+    fi
+    echo
+}
+
+theme_delete_from_registry() {
+    local name="${1}"
+
+    local line
+    line="$(theme_get_entry "${name}")" || {
+        print_error "Theme '${name}' not found in registry."
+        return 1
+    }
+
+    local active
+    active="$(grub_get_active_theme)"
+    if [[ "${name}" == "${active}" ]]; then
+        print_error "Cannot delete the currently active GRUB theme '${name}'."
+        print_step "Switch to another theme first: sudo theamify use <other>"
+        return 1
+    fi
+
+    echo -e "  ${C_WARNING}Entry to delete:${RESET}"
+    echo -e "  ${C_DIM}${line}${RESET}"
+    echo
+
+    confirm "Permanently delete '${name}' from registry?" || {
+        print_info "Cancelled."
+        return 0
+    }
+
+    local dest="${THEMES_CACHE_DIR}/${name}"
+    [[ -d "${dest}" ]] && rm -rf "${dest}" && print_dim "  Cache removed: ${dest}"
+
+    local tmp
+    tmp="$(mktemp)"
+    grep -v "^${name}|" "${THEMES_CONF}" > "${tmp}"
+    mv "${tmp}" "${THEMES_CONF}"
+
+    print_success "Theme '${name}' deleted from registry."
+    echo
+}