Feature Request: Start in Tray

[irmoktran]

It would be really usefull to start this minimized on tray.

[sidevesh]

This app is mainly built for Gnome desktop, which is famously against tray icons,
not planning to implement this for now.

[AndreJorgeLopes]

Since this was closed as not planned and I have this issue subscribed because it would also help me, I believe it will be helpful to leave the script I built to be able to set keybinds for changing the brightness in here.

#!/usr/bin/env bash
set -euo pipefail

# hypr-brightness
# Flags:
#   --inc [N]   increase by N% (default 5)
#   --dec [N]   decrease by N% (default 5)
#   --min       set to 0%
#   --max       set to 100%
#   --all|-all  target all displays
#   --display N force luminance display index
#
# Optional mapping file (recommended for perfect matching):
#   $XDG_CONFIG_HOME/hypr-brightness.map  (or ~/.config/hypr-brightness.map)
#   Example lines:
#     eDP-1=1
#     DP-3=2
#
# Examples:
#   hypr-brightness --inc           # focused +5%
#   hypr-brightness --dec 10        # focused -10%
#   hypr-brightness --max --all     # all to 100%
#   hypr-brightness --inc 5 --display 2

# --- config / helpers --------------------------------------------------------

MAP_FILE="${XDG_CONFIG_HOME:-$HOME/.config}/hypr-brightness.map"

lum() {
  if command -v com.sidevesh.Luminance >/dev/null 2>&1; then
    com.sidevesh.Luminance "$@"
  elif command -v flatpak >/dev/null 2>&1; then
    flatpak run com.sidevesh.Luminance "$@"
  else
    echo "ERROR: Luminance CLI not found (com.sidevesh.Luminance / flatpak)." >&2
    exit 1
  fi
}

# Return Hyprland focused connector name (e.g., DP-3, eDP-1) and description
get_focused_info() {
  local json
  json="$(hyprctl -j monitors)"
  local name desc
  name="$(printf %s "$json" | jq -r '.[] | select(.focused==true) | .name')"
  # description can be null in some versions; coalesce to empty string
  desc="$(printf %s "$json" | jq -r '.[] | select(.focused==true) | (.description // "")')"
  printf "%s\t%s" "$name" "$desc"
}

# Parse "luminance --list-displays" into "index<TAB>label" per line
list_luminance_displays() {
  # Output format of Luminance varies; we robustly grab a leading integer as index
  lum --list-displays | awk '
    /^[[:space:]]*[0-9]+/ {
      # take first integer on the line as INDEX
      idx=$1
      # strip possible trailing ":" or "." from idx like "1:" or "1."
      sub(/[^0-9].*/, "", idx)
      $1=""
      sub(/^[[:space:]]*/, "", $0)
      print idx "\t" $0
    }'
}

# Try mapping via user map file, else fuzzy match name/description within Luminance list
resolve_display_index() {
  local forced="$1"
  if [[ -n "${forced}" ]]; then
    echo "$forced"
    return 0
  fi

  local focused_name focused_desc
  IFS=$'\t' read -r focused_name focused_desc < <(get_focused_info)

  # 1) explicit map file
  if [[ -f "$MAP_FILE" ]]; then
    local mapped
    mapped="$(grep -E "^${focused_name}=" "$MAP_FILE" 2>/dev/null | tail -n1 | cut -d= -f2- || true)"
    if [[ -n "$mapped" ]]; then
      echo "$mapped"
      return 0
    fi
  fi

  # 2) fuzzy match against luminance labels
  local list idx label
  while IFS=$'\t' read -r idx label; do
    # case-insensitive match against either connector name or description tokens
    if grep -qi -- "$focused_name" <<<"$label"; then
      echo "$idx"
      return 0
    fi
    if [[ -n "$focused_desc" ]] && grep -qi -- "$focused_desc" <<<"$label"; then
      echo "$idx"
      return 0
    fi
  done < <(list_luminance_displays)

  # 3) give up
  echo ""
}

# --- arg parsing -------------------------------------------------------------

MODE="" # inc|dec|min|max
STEP="" # percentage int
ALL="0"
FORCE_IDX=""

while (("$#")); do
  case "$1" in
  --inc)
    MODE="inc"
    STEP="${2:-}"
    [[ "${STEP:-}" =~ ^[0-9]+$ ]] && shift || STEP="${STEP:-5}"
    ;;
  --dec)
    MODE="dec"
    STEP="${2:-}"
    [[ "${STEP:-}" =~ ^[0-9]+$ ]] && shift || STEP="${STEP:-5}"
    ;;
  --min) MODE="min" ;;
  --max) MODE="max" ;;
  --all | -all) ALL="1" ;;
  --display)
    FORCE_IDX="${2:-}"
    shift
    ;;
  --help | -h)
    sed -n '1,80p' "$0" | sed -n '1,80p' | awk 'NR==1,/# --- config/{print}'
    exit 0
    ;;
  *)
    echo "Unknown arg: $1" >&2
    exit 2
    ;;
  esac
  shift
done

if [[ -z "$MODE" ]]; then
  echo "Usage: $0 --inc [N] | --dec [N] | --min | --max [--all] [--display N]" >&2
  exit 2
fi

# --- execute ----------------------------------------------------------------

# Build the Luminance call based on target (all vs single)
run_all() {
  case "$MODE" in
  min) lum --set-brightness --percentage 0 ;;
  max) lum --set-brightness --percentage 100 ;;
  inc) lum --increase-brightness --percentage "${STEP}" ;;
  dec) lum --decrease-brightness --percentage "${STEP}" ;;
  esac
}

run_one() {
  local idx="$1"
  if [[ -z "$idx" ]]; then
    echo "Could not resolve focused display to a Luminance index." >&2
    echo "Tip: create ${MAP_FILE} with a line like 'DP-3=2' or use --display N." >&2
    exit 3
  fi
  case "$MODE" in
  min) lum --set-brightness "$idx" --percentage 0 ;;
  max) lum --set-brightness "$idx" --percentage 100 ;;
  inc) lum --increase-brightness "$idx" --percentage "${STEP}" ;;
  dec) lum --decrease-brightness "$idx" --percentage "${STEP}" ;;
  esac
}

if [[ "$ALL" == "1" ]]; then
  run_all
else
  idx="$(resolve_display_index "${FORCE_IDX}")"
  run_one "$idx"
fi