kps

#!/usr/bin/env sh
#
# Description: Krathalan's PrintScreen. Takes a nice screenshot.
#
# Homepage: https://github.com/krathalan/miscellaneous-scripts
#
# Copyright (C) 2019-2024 Hunter Peavey
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <https://www.gnu.org/licenses/>.

# -----------------------------------------
# -------------- Guidelines ---------------
# -----------------------------------------

# This script follows the Google Shell Style Guide:
# https://google.github.io/styleguide/shell.xml

# This script uses shellcheck: https://www.shellcheck.net/

# See https://vaneyckt.io/posts/safer_bash_scripts_with_set_euxo_pipefail/
set -eu # (Eo pipefail) is Bash only!

# -----------------------------------------
# ----------- Program variables -----------
# -----------------------------------------

# Colors
RED=$(tput bold && tput setaf 1)
NC=$(tput sgr0) # No color/turn off all tput attributes

# Other
readonly SCRIPT_NAME="${0##*/}"

# Determine pictures directory
# Don't use check_command() here because the script should NOT fail if
# xdg-user-dir isn't available
if [ -n "$(command -v xdg-user-dir)" ]; then
  SCREENSHOTS_DIR="$(xdg-user-dir PICTURES)/screenshots"
elif [ -d "${HOME}/Pictures" ]; then
  SCREENSHOTS_DIR="${HOME}/Pictures/screenshots"
else
  SCREENSHOTS_DIR="${HOME}/pictures/screenshots"
fi

# Convert output file name to lowercase for easier tab completion
OUTPUT_FILE="${SCREENSHOTS_DIR}/$(printf "%s" "screen-$(date -Iseconds | sed 's/:/-/g').jpg" | tr '[:upper:]' '[:lower:]')"

readonly OUTPUT_FILE SCREENSHOTS_DIR RED NC

# -----------------------------------------
# --------------- Functions ---------------
# -----------------------------------------

#######################################
# Checks to see if a specified command is available and
# exits the script if the command is not available.
# Globals:
#   none
# Arguments:
#   $1: command to test
# Returns:
#   none
#######################################
check_command()
{
  if [ -z "$(command -v "$1")" ]; then
    exit_script_on_failure "Package $1 is required and is not installed."
  fi
}

#######################################
# Prints passed error message before premature exit.
# Prints everything to >&2 (STDERR).
# Globals:
#   RED, NC
#   SCRIPT_NAME
# Arguments:
#   $1: error message to print
# Returns:
#   none
#######################################
exit_script_on_failure()
{
  printf "%sError%s: %s\n" "${RED}" "${NC}" "$1" >&2
  notify-send -i "script-error" "${SCRIPT_NAME}" "Error: $1"

  exit 1
}

# -----------------------------------------
# ---------------- Script -----------------
# -----------------------------------------

[ "$(whoami)" = "root" ] &&
  exit_script_on_failure "This script should NOT be run as root (or sudo)!"

# Make screenshots directory if it does not exist yet
[ ! -d "${SCREENSHOTS_DIR}" ] &&
  mkdir -p "${SCREENSHOTS_DIR}"

notificationMessage="Saved screenshot to ${SCREENSHOTS_DIR}."

if [ -n "${SWAYSOCK:-}" ]; then
  check_command "grim"

  if [ $# -gt 0 ]; then
    check_command "slurp"
    check_command "wl-copy"

    grim -g "$(slurp)" -t jpeg -q 95 - | wl-copy
    notificationMessage="Copied selection to clipboard."
  else
    grim -t jpeg -q 95 "${OUTPUT_FILE}"
  fi
else
  check_command "scrot"
  scrot -q 95 "${OUTPUT_FILE}"
fi

notify-send -i "folder-pictures-open" "${SCRIPT_NAME}" "${notificationMessage}"

printf "Done.\n"