configure-> monitors.sh
Assuming that an x-windowing system is in use on the machine, a universal interface API was developed to access and modify connected display outputs. This script can be used to reestablish your desired screen output, customize it, change outputs for various use cases, and more. You can also provide a hook upon login to source and run this file to setup a custom display environment for a user. You will need to develop a way to get an ideal display-output defined using other tools and methods and then establish a baseline preset. This preset can be used to reduce flickering, tighting display properties, and more. If the display becomes mangled during operations, you can also hook it to a source runner command which can reestablish the correct baseline display-output. The most left screen always takes the 0x0 position regardless of if the display-output program chosen, and the rest of the monitors are set from that in an (X)x(Y) fashion.
#!/bin/sh
###############################################################################
## COPYRIGHT (C) 2022-2023 NEW ENTITY OPERATIONS INC. ALL RIGHTS RESERVED
## CREATED: 2022/02/13
## INSTANCE: configure/monitors.sh
## MODIFIED: 2023/12/31
## OVERVIEW: Use this script to reestablish your desired screen output.
## You can also provide a hook upon login to source and run this file to setup
## a custom display environment for a user. If it becomes mangled during
## operations you can also hook it to a source runner command. The most left
## screen always takes the 0x0 position and the rest of the monitors are set
## from that!
## HISTORY: VERSION 1.3
## -> 2022/02/13 (VERSION 1.0) Development
## -> 2023/11/19 (VERSION 1.1)
## -> 2023/12/15 (VERSION 1.2)
## -> 2023/12/19 (VERSION 1.3)
## -> 2023/12/31 (VERSION 1.4) Production
###############################################################################
# Screen Output: Settings
###############################################################################
## Run xrandr --auto regardless of the tyupe of connected display to set
## the default resolution
## Enable basic non-HDPI resolution
## $(xrandr --auto)
## If you only have a MAIN_monitor at 4K resolution or above 1920x, set it here
## *Note, your --pos will be relative to the 0x0 bit and if you're not set at
## the top left corner, you will need to offset from there to get the correct
## layout
## If only one screen has been setup, we always set the main screen back to pos 0x0
if [ -z "${SECOND_monitor}" ] && [ -z "${THIRD_monitor}" ]; then
xrandr --output "${MAIN_monitor}" --primary --mode "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}" --pos "${PIN_MARK_HORIZONTAL}${PIN_MARK_VERTICLE}" --rotate "${ROTATION_NORMAL}" ;
echo "--------------------"
printf "%b%s%b-> enabled\n" "${tmodDisplay}" "${MAIN_monitor}" "${tmodReset}"
echo "--------------------"
printf "Offset set to: %s\n" "${STRING_MODE_SECONDARY_OFFSET_HORIZONTAL}"
printf "Offset Verticle set to: %s\n" "${STRING_MODE_SECONDARY_OFFSET_VERTICLE}"
printf " %b:::mode->%b %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}"
printf " %b:::pos->%b %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${PIN_MARK_HORIZONTAL}${PIN_MARK_VERTICLE}"
printf " %b:::rotate->%b %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${ROTATION_NORMAL}"
echo "Additional Options: None..."
else
printf "%bMultiple Monitors were provided, checking them for configuration now.\n" "${tmodReset}"
fi
###############################################################################
## The following section is disabled if their is no secondary monitor provided
## or detected by xrandr. The first monitor defaults to a workstation grade
## 4K display, or above = 1920x, or greater
## Configure additional outputs for additional monitors by utilizing
## xrandr | grep '$X_monitor' connected; then
## Position this inside of if statements searching for their connectivity
## Connect your MAIN_ and SECOND_ monitor and put them where you want, i.e.
## --left-of $MAIN_
CONDITION="${SECOND_monitor} connected"
MONITOR_CHECK=$(xrandr | grep "${CONDITION}")
STRING_MONITOR="${MONITOR_CHECK}"
printf "MONITOR: Test is-> %s\n" "${STRING_MONITOR}"
if [ -z "${STRING_MONITOR}" ]; then
xrandr --output "${MAIN_monitor}" --primary --mode "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}" --pos "${PIN_MARK_HORIZONTAL}${PIN_MARK_VERTICLE}" --rotate "${ROTATION_NORMAL}" ;
echo "--------------------"
printf "%b%s%b-> enabled\n" "${tmodDisplay}" "${MAIN_monitor}" "${tmodReset}"
echo "--------------------"
printf " :::mode-> %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}"
printf " :::pos-> %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${PIN_MARK_HORIZONTAL}${PIN_MARK_VERTICLE}"
printf " :::rotate-> %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${ROTATION_NORMAL}"
printf "%bAdditional Options: None...\n%b" "${tmodWarningText}" "${tmodReset}"
printf "%s -> not found\n" "${SECOND_monitor}"
else
echo "--------------------"
printf "%b%s%b-> enabled\n" "${tmodDisplay}" "${MAIN_monitor}" "${tmodReset}"
echo "--------------------"
printf " %b:::mode->%b %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}"
printf " %b:::pos->%b %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${PIN_MARK_HORIZONTAL_SECONDARY}${PIN_MARK_VERTICLE_SECONDARY}"
printf " %b:::rotate->%b %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${ROTATION_NORMAL}"
echo "Additional Options: None..."
echo "--------------------"
printf "%b%s%b-> enabled\n" "${tmodDisplay}" "${SECOND_monitor}" "${tmodReset}"
echo "--------------------"
printf " %b:::mode->%b %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${MODE_SECONDARY_WIDTH}${MODE_SECONDARY_HEIGHT}"
printf " %b:::pos->%b %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${PIN_MARK_HORIZONTAL}${PIN_MARK_VERTICLE}"
printf " %b:::rotate->%b %s\n" "${tmodDisplayAttribute}" "${tmodReset}" "${ROTATION_LEFT}"
echo "Additional Options: None..."
xrandr --output "${MAIN_monitor}" --primary --mode "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}" --size "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}" --pos "${PIN_MARK_HORIZONTAL_SECONDARY}${PIN_MARK_VERTICLE_SECONDARY}" --rotate "${ROTATION_NORMAL}" --output "${FOURTH_monitor}" --off --output "${FIFTH_monitor}" --off --output "${SECOND_monitor}" --mode "${MODE_SECONDARY_WIDTH}${MODE_SECONDARY_HEIGHT}" --size "${MODE_SECONDARY_WIDTH}${MODE_SECONDARY_HEIGHT}" --pos "${PIN_MARK_HORIZONTAL}${PIN_MARK_VERTICLE}" --rotate "${ROTATION_LEFT}" --scale "${SCALE_TWO}" --output "${SIXTH_monitor}" --off --output "${SEVENTH_monitor}" --off ;
if [ "$EXPECTED_MONITOR_VALUE_PREFERRED" = "xrandr --output ${MAIN_monitor} --primary --mode ${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT} --size ${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT} --pos ${PIN_MARK_HORIZONTAL_SECONDARY}${PIN_MARK_VERTICLE_SECONDARY} --rotate ${ROTATION_NORMAL} --output ${FOURTH_monitor} --off --output ${FIFTH_monitor} --off --output ${SECOND_monitor} --mode ${MODE_SECONDARY_WIDTH}${MODE_SECONDARY_HEIGHT} --size ${MODE_SECONDARY_WIDTH}${MODE_SECONDARY_HEIGHT} --pos ${PIN_MARK_HORIZONTAL}${PIN_MARK_VERTICLE} --rotate ${ROTATION_LEFT} --scale ${SCALE_TWO} --output ${SIXTH_monitor} --off --output ${SEVENTH_monitor} --off" ]; then
echo "--------------------"
printf "%bYour expect monitor value met the summary value:\n%b" "${tmodSuccess}" "${tmodReset}"
printf "EXPECTED: %s\n" "${EXPECTED_MONITOR_VALUE_PREFERRED}"
printf "SUMMARY: xrandr --output %s --primary --mode %s --size %s --pos %s --rotate %s --output %s --off --output %s --off --output %s --mode %s --size %s --pos %s --rotate %s --scale %s --output %s --off --output %s --off\n%b" "${MAIN_monitor}" "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}" "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}" "${PIN_MARK_HORIZONTAL_SECONDARY}${PIN_MARK_VERTICLE_SECONDARY}" "${ROTATION_NORMAL}" "${FOURTH_monitor}" "${FIFTH_monitor}" "${SECOND_monitor}" "${MODE_SECONDARY_WIDTH}${MODE_SECONDARY_HEIGHT}" "${MODE_SECONDARY_WIDTH}${MODE_SECONDARY_HEIGHT}" "${PIN_MARK_HORIZONTAL}${PIN_MARK_VERTICLE}" "${ROTATION_LEFT}" "${SCALE_TWO}" "${SIXTH_monitor}" "${SEVENTH_monitor}" "${tmodReset}"
echo "--------------------"
else
echo "--------------------"
printf "%bYou expect monitor value was different than the summary value generated by this program.\n%b" "${tmodFailure}" "${tmodReset}"
printf "EXPECTED: %s\n" "${EXPECTED_MONITOR_VALUE_PREFERRED}"
printf "SUMMARY: xrandr --output %s --primary --mode %s --size %s --pos %s --rotate %s --output %s --off --output %s --off --output %s --mode %s --size %s --pos %s --rotate %s --scale %s --output %s --off --output %s --off\n%b" "${MAIN_monitor}" "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}" "${MODE_MAIN_WIDTH}${MODE_MAIN_HEIGHT}" "${PIN_MARK_HORIZONTAL_SECONDARY}${PIN_MARK_VERTICLE_SECONDARY}" "${ROTATION_NORMAL}" "${FOURTH_monitor}" "${FIFTH_monitor}" "${SECOND_monitor}" "${MODE_SECONDARY_WIDTH}${MODE_SECONDARY_HEIGHT}" "${MODE_SECONDARY_WIDTH}${MODE_SECONDARY_HEIGHT}" "${PIN_MARK_HORIZONTAL}${PIN_MARK_VERTICLE}" "${ROTATION_LEFT}" "${SCALE_TWO}" "${SIXTH_monitor}" "${SEVENTH_monitor}" "${tmodReset}"
echo "--------------------"
fi
fi
###############################################################################
## For additional monitors, copy the above block, and add in a check for the
## Nth monitor you need to automate detection for