peterwood/shell
1
0
Fork 0
mirror of https://github.com/acedanger/shell.git synced 2026-03-24 20:11:49 -07:00
Code Issues 19 Packages Projects Releases Wiki Activity

feat: Add DBRepair installation and management features to Plex scripts

Browse Source
This commit is contained in:
Peter Wood
2026-03-07 10:56:39 -05:00
parent 9bb99aecbf
commit 2bae9bc6ce
2 changed files with 522 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

261
plex/plex-db-manager.sh
View File

@@ -57,6 +57,10 @@ readonly SCRIPT_DIR
readonly LOG_FILE="$SCRIPT_DIR/logs/db-manager-$(date +%Y%m%d_%H%M%S).log"
# DBRepair.sh location — searched in order: script dir, database dir, /usr/local/bin
readonly DBREPAIR_INSTALL_PATH="${SCRIPT_DIR}/DBRepair.sh"
readonly DBREPAIR_GITHUB_API="https://api.github.com/repos/ChuckPa/PlexDBRepair/releases"
readonly DBREPAIR_DOWNLOAD_BASE="https://github.com/ChuckPa/PlexDBRepair/releases/download"
find_dbrepair() {
local candidates=(
"${SCRIPT_DIR}/DBRepair.sh"
@@ -72,6 +76,231 @@ find_dbrepair() {
return 1
}
# Get the latest non-beta release tag from GitHub
_dbrepair_latest_release_tag() {
local tag
tag=$(curl -fsSL "${DBREPAIR_GITHUB_API}" 2>/dev/null \
| grep -Eo '"tag_name"\s*:\s*"[^"]+"' \
| head -n 1 \
| sed 's/"tag_name"\s*:\s*"//;s/"//')
if [[ -z "$tag" ]]; then
return 1
fi
echo "$tag"
}
# Get currently installed DBRepair version
_dbrepair_installed_version() {
local bin="$1"
grep -oP 'Version\s+v\K[0-9.]+' "$bin" 2>/dev/null | head -n 1
}
# Install or update DBRepair.sh
install_or_update_dbrepair() {
log_message "Checking DBRepair (ChuckPa/PlexDBRepair)..."
local latest_tag
if ! latest_tag=$(_dbrepair_latest_release_tag); then
log_error "Failed to query GitHub for the latest release"
log_warning "Check your internet connection or try: https://github.com/ChuckPa/PlexDBRepair/releases"
return 1
fi
log_message "Latest stable release: ${latest_tag}"
local dbrepair_bin
if dbrepair_bin=$(find_dbrepair); then
local installed_ver
installed_ver=$(_dbrepair_installed_version "$dbrepair_bin")
local remote_ver
remote_ver=$(echo "$latest_tag" | sed 's/^v//')
if [[ -n "$installed_ver" ]]; then
log_message "Installed version: v${installed_ver} at ${dbrepair_bin}"
if [[ "$installed_ver" == "$remote_ver" ]]; then
log_success "DBRepair is already up to date (v${installed_ver})"
return 0
else
log_warning "Update available: v${installed_ver} -> ${latest_tag}"
fi
else
log_warning "Installed at ${dbrepair_bin} (version unknown), will update"
fi
else
log_message "DBRepair not found — installing to ${DBREPAIR_INSTALL_PATH}"
fi
local download_url="${DBREPAIR_DOWNLOAD_BASE}/${latest_tag}/DBRepair.sh"
log_message "Downloading ${download_url}"
if curl -fsSL -o "${DBREPAIR_INSTALL_PATH}" "$download_url"; then
chmod +x "${DBREPAIR_INSTALL_PATH}"
log_success "DBRepair ${latest_tag} installed to ${DBREPAIR_INSTALL_PATH}"
return 0
else
log_error "Download failed"
rm -f "${DBREPAIR_INSTALL_PATH}" 2>/dev/null
return 1
fi
}
# Suggest installing DBRepair when errors are found and it's not available
_hint_install_dbrepair() {
if ! find_dbrepair >/dev/null 2>&1; then
echo ""
log_warning "DBRepair is NOT installed. It can fix most database issues automatically."
echo -e " ${CYAN}Install it now: $(basename "$0") install-dbrepair${RESET}"
echo -e " ${CYAN}Then repair: $(basename "$0") repair${RESET}"
fi
}
# List and manage database backup files
list_db_backups() {
local db_dir="$PLEX_DB_DIR"
local -a backup_files=()
local -a backup_paths=()
while IFS= read -r -d '' entry; do
backup_paths+=("$entry")
done < <(sudo find "$db_dir" -maxdepth 1 \( \
-name '*-BACKUP-*' -o \
-name '*-BKUP-*' -o \
-name '*.backup.*' -o \
-name '*recovery*' -o \
-name 'corrupted-*' -o \
-name '*-BLOATED-*' \
\) -print0 2>/dev/null | sort -z)
if [[ ${#backup_paths[@]} -eq 0 ]]; then
log_message "No database backup files found in the Plex database directory"
return 0
fi
echo -e "\n${BOLD}${WHITE} # Type Size Created Name${RESET}"
echo -e " --- ------------- ----------- ------------------------ ------------------------------------"
local idx=0
for entry in "${backup_paths[@]}"; do
((idx++))
local name
name=$(basename "$entry")
local type_label
if [[ "$name" == *-BACKUP-* || "$name" == *-BKUP-* ]]; then
type_label="DBRepair"
elif [[ "$name" == *-BLOATED-* ]]; then
type_label="Bloated"
elif [[ "$name" == *.backup.* ]]; then
type_label="Script"
elif [[ "$name" == corrupted-* ]]; then
type_label="Corrupted"
elif [[ "$name" == *recovery* ]]; then
type_label="Recovery"
else
type_label="Other"
fi
local size
if [[ -d "$entry" ]]; then
size=$(sudo du -sh "$entry" 2>/dev/null | cut -f1)
type_label="${type_label}/dir"
else
size=$(sudo stat --printf='%s' "$entry" 2>/dev/null)
if [[ -n "$size" ]]; then
size=$(numfmt --to=iec-i --suffix=B "$size" 2>/dev/null || echo "${size}B")
else
size="?"
fi
fi
local created
created=$(sudo stat --printf='%y' "$entry" 2>/dev/null | cut -d. -f1)
[[ -z "$created" ]] && created="unknown"
printf " ${WHITE}%-3s${RESET} ${CYAN}%-13s${RESET} ${YELLOW}%-11s${RESET} %-24s %s\n" \
"$idx" "$type_label" "$size" "$created" "$name"
backup_files+=("$entry")
done
echo -e " --- ------------- ----------- ------------------------ ------------------------------------"
echo -e " Total: ${idx} backup file(s)\n"
_BACKUP_LIST=("${backup_files[@]}")
_BACKUP_COUNT=$idx
}
# Interactive backup deletion
delete_db_backups_interactive() {
list_db_backups
if [[ ${_BACKUP_COUNT:-0} -eq 0 ]]; then
return 0
fi
echo -e "${CYAN}Enter backup number(s) to delete (comma-separated), or 'q' to cancel:${RESET} "
read -r selection
if [[ "$selection" == "q" || -z "$selection" ]]; then
log_message "Cancelled"
return 0
fi
IFS=',' read -ra nums <<< "$selection"
local deleted=0
for num in "${nums[@]}"; do
num=$(echo "$num" | tr -d ' ')
if ! [[ "$num" =~ ^[0-9]+$ ]] || (( num < 1 || num > _BACKUP_COUNT )); then
log_error "Invalid selection: $num (skipping)"
continue
fi
local target="${_BACKUP_LIST[$((num-1))]}"
local target_name
target_name=$(basename "$target")
echo -e "${YELLOW}Delete ${target_name}? [y/N]:${RESET} "
read -r confirm
if [[ "${confirm,,}" == "y" ]]; then
if [[ -d "$target" ]]; then
sudo rm -rf "$target"
else
sudo rm -f "$target"
fi
log_success "Deleted: $target_name"
((deleted++))
else
log_message "Skipped: $target_name"
fi
done
echo ""
log_message "Deleted $deleted backup(s)"
}
# Delete backup by name/pattern
delete_db_backup_by_name() {
local pattern="$1"
local db_dir="$PLEX_DB_DIR"
local found=0
while IFS= read -r -d '' entry; do
local name
name=$(basename "$entry")
echo -e "${YELLOW}Delete ${name}? [y/N]:${RESET} "
read -r confirm
if [[ "${confirm,,}" == "y" ]]; then
if [[ -d "$entry" ]]; then
sudo rm -rf "$entry"
else
sudo rm -f "$entry"
fi
log_success "Deleted: $name"
((found++))
fi
done < <(sudo find "$db_dir" -maxdepth 1 -name "*${pattern}*" -print0 2>/dev/null)
if [[ $found -eq 0 ]]; then
log_error "No backups matching '${pattern}' found"
return 1
fi
log_message "Deleted $found file(s)"
}
# Create log directory
mkdir -p "$SCRIPT_DIR/logs"
@@ -298,6 +527,7 @@ check_all_databases() {
return 0
else
log_warning "Found integrity issues in $issues database(s)"
_hint_install_dbrepair
return 1
fi
}
@@ -312,12 +542,18 @@ show_help() {
echo -e " ${YELLOW}${BOLD}repair --gentle${RESET} Gentle repair methods only"
echo -e " ${RED}${BOLD}repair --force${RESET} Aggressive repair methods"
echo -e " ${RED}${BOLD}nuclear${RESET} Nuclear recovery (replace from backup)"
echo -e " ${CYAN}${BOLD}backups${RESET} List and manage database backup files"
echo -e " ${GREEN}${BOLD}install-dbrepair${RESET} Install or update DBRepair tool"
echo -e " ${CYAN}${BOLD}help${RESET} Show this help message"
echo ""
echo -e "${BOLD}${WHITE}Examples:${RESET}"
echo -e " ${DIM}$(basename "$0") check # Safe integrity check${RESET}"
echo -e " ${DIM}$(basename "$0") repair # Interactive repair${RESET}"
echo -e " ${DIM}$(basename "$0") repair --gentle # Minimal repair only${RESET}"
echo -e " ${DIM}$(basename "$0") backups # List DB backups${RESET}"
echo -e " ${DIM}$(basename "$0") backups delete # Interactive backup deletion${RESET}"
echo -e " ${DIM}$(basename "$0") backups delete --name foo # Delete by name pattern${RESET}"
echo -e " ${DIM}$(basename "$0") install-dbrepair # Install/update DBRepair${RESET}"
echo ""
echo -e "${BOLD}${YELLOW}⚠️ WARNING:${RESET} Always run ${CYAN}check${RESET} first before attempting repairs!"
echo ""
@@ -375,9 +611,8 @@ main() {
fi
else
echo -e "${RED}${BOLD}⚠️ DBRepair.sh NOT FOUND${RESET}"
echo -e "${YELLOW}Install DBRepair for repair/optimize/reindex/FTS-rebuild:${RESET}"
echo -e " ${CYAN}wget -O ${SCRIPT_DIR}/DBRepair.sh https://github.com/ChuckPa/PlexDBRepair/releases/latest/download/DBRepair.sh${RESET}"
echo -e " ${CYAN}chmod +x ${SCRIPT_DIR}/DBRepair.sh${RESET}"
echo -e "${YELLOW}You can install it automatically:${RESET}"
echo -e " ${CYAN}$(basename "$0") install-dbrepair${RESET}"
echo -e "${YELLOW}Then re-run: $(basename "$0") repair${RESET}"
exit 2
fi
@@ -432,7 +667,25 @@ main() {
print_header
show_help
;;
"install-dbrepair"|"update-dbrepair"|"dbrepair")
print_header
install_or_update_dbrepair
;;
"backups"|"backup-list")
print_header
if [[ $# -ge 2 && "${2,,}" == "delete" ]]; then
if [[ $# -ge 4 && "${3}" == "--name" ]]; then
delete_db_backup_by_name "$4"
else
delete_db_backups_interactive
fi
else
list_db_backups
fi
;;
*)
print_header
log_error "Unknown command: $1"

265
plex/plex.sh
View File

@@ -78,6 +78,10 @@ SCRIPT_DIR="$(dirname "$(readlink -f "$0")")"
readonly SCRIPT_DIR
# DBRepair.sh location — searched in order: script dir, database dir, /usr/local/bin
readonly DBREPAIR_INSTALL_PATH="${SCRIPT_DIR}/DBRepair.sh"
readonly DBREPAIR_GITHUB_API="https://api.github.com/repos/ChuckPa/PlexDBRepair/releases"
readonly DBREPAIR_DOWNLOAD_BASE="https://github.com/ChuckPa/PlexDBRepair/releases/download"
find_dbrepair() {
local candidates=(
"${SCRIPT_DIR}/DBRepair.sh"
@@ -93,6 +97,245 @@ find_dbrepair() {
return 1
}
# Get the latest non-beta release tag from GitHub
_dbrepair_latest_release_tag() {
# Fetch releases, filter out pre-releases & drafts, grab the first tag_name
local tag
tag=$(curl -fsSL "${DBREPAIR_GITHUB_API}" 2>/dev/null \
| grep -Eo '"tag_name"\s*:\s*"[^"]+"' \
| head -n 1 \
| sed 's/"tag_name"\s*:\s*"//;s/"//')
if [[ -z "$tag" ]]; then
return 1
fi
echo "$tag"
}
# Get currently installed DBRepair version (from its own version output)
_dbrepair_installed_version() {
local bin="$1"
# DBRepair prints "Version vX.YY.ZZ" near the top when run interactively;
# we can also grep the script file itself for the version string.
grep -oP 'Version\s+v\K[0-9.]+' "$bin" 2>/dev/null | head -n 1
}
# Install or update DBRepair.sh
install_or_update_dbrepair() {
print_status "${INFO}" "Checking DBRepair (ChuckPa/PlexDBRepair)..." "${BLUE}"
# Determine latest non-beta release
local latest_tag
if ! latest_tag=$(_dbrepair_latest_release_tag); then
print_status "${CROSS}" "Failed to query GitHub for the latest release" "${RED}"
print_status "${INFO}" "Check your internet connection or try: https://github.com/ChuckPa/PlexDBRepair/releases" "${YELLOW}"
return 1
fi
print_status "${INFO}" "Latest stable release: ${latest_tag}" "${BLUE}"
# Check if already installed
local dbrepair_bin
if dbrepair_bin=$(find_dbrepair); then
local installed_ver
installed_ver=$(_dbrepair_installed_version "$dbrepair_bin")
local remote_ver
remote_ver=$(echo "$latest_tag" | sed 's/^v//')
if [[ -n "$installed_ver" ]]; then
print_status "${INFO}" "Installed version: v${installed_ver} at ${dbrepair_bin}" "${BLUE}"
if [[ "$installed_ver" == "$remote_ver" ]]; then
print_status "${CHECKMARK}" "DBRepair is already up to date (v${installed_ver})" "${GREEN}"
return 0
else
print_status "${INFO}" "Update available: v${installed_ver} -> ${latest_tag}" "${YELLOW}"
fi
else
print_status "${INFO}" "Installed at ${dbrepair_bin} (version unknown), will update" "${YELLOW}"
fi
else
print_status "${INFO}" "DBRepair not found — installing to ${DBREPAIR_INSTALL_PATH}" "${BLUE}"
fi
# Download
local download_url="${DBREPAIR_DOWNLOAD_BASE}/${latest_tag}/DBRepair.sh"
print_status "${INFO}" "Downloading ${download_url}" "${BLUE}"
if curl -fsSL -o "${DBREPAIR_INSTALL_PATH}" "$download_url"; then
chmod +x "${DBREPAIR_INSTALL_PATH}"
print_status "${CHECKMARK}" "DBRepair ${latest_tag} installed to ${DBREPAIR_INSTALL_PATH}" "${GREEN}"
return 0
else
print_status "${CROSS}" "Download failed" "${RED}"
rm -f "${DBREPAIR_INSTALL_PATH}" 2>/dev/null
return 1
fi
}
# Suggest installing DBRepair when errors are found and it's not available
_hint_install_dbrepair() {
if ! find_dbrepair >/dev/null 2>&1; then
echo ""
print_status "${INFO}" "DBRepair is NOT installed. It can fix most database issues automatically." "${YELLOW}"
echo -e "${DIM}${CYAN} Install it now: ${SCRIPT_NAME} install-dbrepair${RESET}"
echo -e "${DIM}${CYAN} Then repair: ${SCRIPT_NAME} repair${RESET}"
fi
}
# 📦 List and manage database backup files
# Covers: DBRepair backups (-BACKUP-*, -BKUP-*), script backups (*.backup.*),
# corrupted dirs (corrupted-*), recovery files (*recovery*)
list_db_backups() {
local db_dir="$PLEX_DB_DIR"
local -a backup_files=()
local -a backup_paths=()
# Collect all backup-like files and dirs
while IFS= read -r -d '' entry; do
backup_paths+=("$entry")
done < <(sudo find "$db_dir" -maxdepth 1 \( \
-name '*-BACKUP-*' -o \
-name '*-BKUP-*' -o \
-name '*.backup.*' -o \
-name '*recovery*' -o \
-name 'corrupted-*' -o \
-name '*-BLOATED-*' \
\) -print0 2>/dev/null | sort -z)
if [[ ${#backup_paths[@]} -eq 0 ]]; then
print_status "${INFO}" "No database backup files found in the Plex database directory" "${YELLOW}"
return 0
fi
echo -e "\n${BOLD}${WHITE} # Type Size Created Name${RESET}"
echo -e "${DIM}${CYAN} --- ------------- ----------- ------------------------ ------------------------------------${RESET}"
local idx=0
for entry in "${backup_paths[@]}"; do
((idx++))
local name
name=$(basename "$entry")
# Determine type label
local type_label
if [[ "$name" == *-BACKUP-* || "$name" == *-BKUP-* ]]; then
type_label="DBRepair"
elif [[ "$name" == *-BLOATED-* ]]; then
type_label="Bloated"
elif [[ "$name" == *.backup.* ]]; then
type_label="Script"
elif [[ "$name" == corrupted-* ]]; then
type_label="Corrupted"
elif [[ "$name" == *recovery* ]]; then
type_label="Recovery"
else
type_label="Other"
fi
# Size (human-readable)
local size
if [[ -d "$entry" ]]; then
size=$(sudo du -sh "$entry" 2>/dev/null | cut -f1)
type_label="${type_label}/dir"
else
size=$(sudo stat --printf='%s' "$entry" 2>/dev/null)
if [[ -n "$size" ]]; then
size=$(numfmt --to=iec-i --suffix=B "$size" 2>/dev/null || echo "${size}B")
else
size="?"
fi
fi
# Created date
local created
created=$(sudo stat --printf='%y' "$entry" 2>/dev/null | cut -d. -f1)
[[ -z "$created" ]] && created="unknown"
printf " ${WHITE}%-3s${RESET} ${CYAN}%-13s${RESET} ${YELLOW}%-11s${RESET} ${DIM}%-24s${RESET} %s\n" \
"$idx" "$type_label" "$size" "$created" "$name"
backup_files+=("$entry")
done
echo -e "${DIM}${CYAN} --- ------------- ----------- ------------------------ ------------------------------------${RESET}"
echo -e " ${DIM}Total: ${idx} backup file(s)${RESET}\n"
# Store for use by delete function
_BACKUP_LIST=("${backup_files[@]}")
_BACKUP_COUNT=$idx
}
# Interactive backup deletion
delete_db_backups_interactive() {
list_db_backups
if [[ ${_BACKUP_COUNT:-0} -eq 0 ]]; then
return 0
fi
echo -e "${CYAN}Enter backup number(s) to delete (comma-separated), or 'q' to cancel:${RESET} "
read -r selection
if [[ "$selection" == "q" || -z "$selection" ]]; then
print_status "${INFO}" "Cancelled" "${YELLOW}"
return 0
fi
# Parse comma-separated numbers
IFS=',' read -ra nums <<< "$selection"
local deleted=0
for num in "${nums[@]}"; do
num=$(echo "$num" | tr -d ' ')
if ! [[ "$num" =~ ^[0-9]+$ ]] || (( num < 1 || num > _BACKUP_COUNT )); then
print_status "${CROSS}" "Invalid selection: $num (skipping)" "${RED}"
continue
fi
local target="${_BACKUP_LIST[$((num-1))]}"
local target_name
target_name=$(basename "$target")
echo -e "${YELLOW}Delete ${target_name}? [y/N]:${RESET} "
read -r confirm
if [[ "${confirm,,}" == "y" ]]; then
if [[ -d "$target" ]]; then
sudo rm -rf "$target"
else
sudo rm -f "$target"
fi
print_status "${CHECKMARK}" "Deleted: $target_name" "${GREEN}"
((deleted++))
else
print_status "${INFO}" "Skipped: $target_name" "${YELLOW}"
fi
done
echo ""
print_status "${INFO}" "Deleted $deleted backup(s)" "${BLUE}"
}
# Delete backup by name/pattern (for scripted use)
delete_db_backup_by_name() {
local pattern="$1"
local db_dir="$PLEX_DB_DIR"
local found=0
while IFS= read -r -d '' entry; do
local name
name=$(basename "$entry")
echo -e "${YELLOW}Delete ${name}? [y/N]:${RESET} "
read -r confirm
if [[ "${confirm,,}" == "y" ]]; then
if [[ -d "$entry" ]]; then
sudo rm -rf "$entry"
else
sudo rm -f "$entry"
fi
print_status "${CHECKMARK}" "Deleted: $name" "${GREEN}"
((found++))
fi
done < <(sudo find "$db_dir" -maxdepth 1 -name "*${pattern}*" -print0 2>/dev/null)
if [[ $found -eq 0 ]]; then
print_status "${CROSS}" "No backups matching '${pattern}' found" "${RED}"
return 1
fi
print_status "${INFO}" "Deleted $found file(s)" "${BLUE}"
}
# 🎭 ASCII symbols for compatible output
readonly CHECKMARK="[✓]"
readonly CROSS="[✗]"
@@ -353,6 +596,7 @@ check_database_integrity() {
fi
print_status "${INFO}" "Consider running database repair: ${SCRIPT_NAME} repair" "${YELLOW}"
_hint_install_dbrepair
return 1
}
@@ -374,6 +618,7 @@ start_plex() {
if ! check_database_integrity; then
print_status "${INFO}" "Database integrity issues detected — starting Plex anyway (it may self-repair)." "${YELLOW}"
echo -e "${DIM}${YELLOW} If Plex fails to start, run: ${SCRIPT_NAME} repair${RESET}"
_hint_install_dbrepair
fi
print_status "${INFO}" "Attempting to start service..." "${BLUE}"
@@ -537,6 +782,8 @@ show_help() {
echo -e " ${PURPLE}${BOLD}scan${RESET} ${SPARKLES} Library scanner operations"
echo -e " ${RED}${BOLD}repair${RESET} [!] Repair database corruption issues"
echo -e " ${RED}${BOLD}nuclear${RESET} [!!] Nuclear database recovery (last resort)"
echo -e " ${CYAN}${BOLD}backups${RESET} [#] List and manage database backup files"
echo -e " ${GREEN}${BOLD}install-dbrepair${RESET} Install or update DBRepair tool"
echo -e " ${PURPLE}${BOLD}help${RESET} [*] Show this help message"
echo ""
echo -e "${DIM}${WHITE}Examples:${RESET}"
@@ -545,6 +792,10 @@ show_help() {
echo -e " ${DIM}${SCRIPT_NAME} scan # Launch library scanner interface${RESET}"
echo -e " ${DIM}${SCRIPT_NAME} repair # Fix database issues${RESET}"
echo -e " ${DIM}${SCRIPT_NAME} nuclear # Complete database replacement${RESET}"
echo -e " ${DIM}${SCRIPT_NAME} backups # List and manage DB backups${RESET}"
echo -e " ${DIM}${SCRIPT_NAME} backups delete # Interactive backup deletion${RESET}"
echo -e " ${DIM}${SCRIPT_NAME} backups delete --name foo # Delete by name pattern${RESET}"
echo -e " ${DIM}${SCRIPT_NAME} install-dbrepair # Install/update DBRepair${RESET}"
echo ""
}
@@ -712,6 +963,20 @@ main() {
"nuclear"|"nuke")
nuclear_recovery
;;
"install-dbrepair"|"update-dbrepair"|"dbrepair")
install_or_update_dbrepair
;;
"backups"|"backup-list")
if [[ $# -ge 2 && "${2,,}" == "delete" ]]; then
if [[ $# -ge 4 && "${3}" == "--name" ]]; then
delete_db_backup_by_name "$4"
else
delete_db_backups_interactive
fi
else
list_db_backups
fi
;;
"help"|"--help"|"-h")
show_help
;;