summaryrefslogtreecommitdiffstats
path: root/audio/clockchimes/clockchimes
blob: fb406f9ecab9c19bf2093fface80986613341a03 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
#!/bin/sh

# Play audio script for ClockChimes

# Copyright 2018 - Stu Miller - Colorado, USA
# All rights reserved.
#
# Redistribution and use of this script, with or without modification, is
# permitted provided that the following conditions are met:
#
# 1. Redistributions of this script must retain the above copyright
#    notice, this list of conditions and the following disclaimer.
#
#  THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
#  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO
#  EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
#  PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
#  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
#  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
#  OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
#  ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

# Function - input: UC - output: LC
lowercase () {
  LC=$(echo $UC | tr [:upper:] [:lower:])
} # END lowercase

# function - input: ARRAY, KEY - output: VALUE
read_array(){
  # indirect reference method
  TMP=${ARRAY}[KEY]
  VALUE=${!TMP}
} # END read_array

# Function - input: CHIME, STRIKE - output: sox audio
play_chimestrike(){
#echo "play_chimestrike - #1:"$chime$strike":"
  # check chimestrike null
  if [ "$CHIME$STRIKE" != "" ]; then
    # determine user based on 1st local display
    # last - reads /var/log/wtmp file
    # grep - looks for ":0" followed by "still logged in"
    # awk - uses 1st line and 1st field, ignores remaining lines
    USER=$(last | grep -E :0.*"still logged in" | awk 'NR==1{print $1}')

    # play as default root user or user currently logged in
    # for play commands, see: man sox
    # functionaly equivalent to: sox -q $CHIME$STRIKE -d
    if [[ "$USER" == "" || "$USER" == "root" ]]; then
      # play as root
      /usr/bin/play -q $CHIME$STRIKE
    else
      # play as user currently logged in
      su -l $USER -c "/usr/bin/play -q $CHIME$STRIKE"
    fi # END play as root or user
  fi # END chimestrike null
#echo "play_chimestrike - :end:"
} # END play_chimestrike

# Function - requires: read_array - input: CONTROL[], MINUTE, LOOP - output: STRIKE
set_strike(){
#echo "START set_strike - #1:play_strike:"${CONTROL[2]}":minute:"$MINUTE":loop:"$LOOP":"
  # check play strike
  if [ ${CONTROL[2]} == "yes" ]; then
    # check min 00
    if [[ "$MINUTE" == "00" || "$MINUTE" == "0" ]]; then
      # set strike to play, minus last
      while [ "$LOOP" -gt "1" ]; do
        # concatenate pre & strike
        ARRAY=${CONTROL[0]}; KEY="4"; read_array
        STRIKE=$STRIKE" "$PRE$VALUE
        # decrement loop counter
        LOOP=$(($LOOP-1))
      done # END strike loop
      # concatenate last pre & strike
      ARRAY=${CONTROL[0]}; KEY="5"; read_array
      STRIKE=$STRIKE" "$PRE$VALUE
    fi # END min 00
  fi # END play strike
#echo "END set_strike - strike:"$STRIKE":"
} # END set_strikes

# Function - requires: read_array - input: CONTROL[], MINUTE - output: CHIME
set_chime(){
#echo "START set_chime - #1:play_chime:"${CONTROL[1]}":minute:"$MINUTE":"
  # check play chimes
  if [ "${CONTROL[1]}" == "yes" ]; then
    # check minute on the quarter hour
    if [ "$MINUTE" == "00" ]; then
      ARRAY=${CONTROL[0]}; KEY="0"; read_array
      CHIME=$PRE$VALUE
    elif [ "$MINUTE" == "15" ]; then
      ARRAY=${CONTROL[0]}; KEY="1"; read_array
      CHIME=$PRE$VALUE
    elif [ "$MINUTE" == "30" ]; then
      ARRAY=${CONTROL[0]}; KEY="2"; read_array
      CHIME=$PRE$VALUE
    elif [ "$MINUTE" == "45" ]; then
      ARRAY=${CONTROL[0]}; KEY="3"; read_array
      CHIME=$PRE$VALUE
    fi # END minute on the quarter hour
  fi # END play chimes
#echo "END set_chime - chime:"$CHIME":"
} # END set_chime

# Function - input: $1, $2, $3 - output: LOOP, MINUTE
test(){
#echo "START test_script - #1:"$1":"$2":"$3":"
  USAGE="TEST FAILED: requires 2nd & 3rd integer arguments"
  # check for arguments
  if [[ "$2" != "" && "$3" != "" ]]; then
    USAGE="TEST FAILED: 2nd argument represents hours. It must be an integer <= 24"
    # check hour argument is integer
    if [ "$2" -eq "$2" ] 2>/dev/null; then
      # check hour argument is -le 24
      if [ $2 -le 12 ]; then
        LOOP=$2
      elif [ $2 -le 24 ]; then
        LOOP=$(($2-12))
      else
        echo $USAGE; exit
      fi # END hour argument is -le 24
    else
      echo $USAGE; exit
    fi # END hour argument is integer
    USAGE="TEST FAILED: 3rd argument represents minutes. It must be an integer <= 45"
    # check minute argument is integer
    if [ "$3" -eq "$3" ] 2>/dev/null; then
      # check minute argument -le 45
      if [ $3 -le 45 ]; then
        MINUTE=$3
      else
        echo $USAGE; exit
      fi # END minute argument -le 45
    else
      echo $USAGE; exit
    fi # END minute argument is integer
  else
    echo $USAGE; exit
  fi # END check for arguments
#echo "END test_script - loop:"$LOOP":minute:"$MINUTE":"
  echo "NOTE: requires logged in user password if NOT running as root"
} # END test

# source config file
. /etc/clockchimes.conf

# sound directory
SND_DIR="/usr/share/sounds/clockchimes/"

# prefix volume factor, sound directory & chime name
UC=${CONTROL[0]}; lowercase
PRE="-v "${CONTROL[3]}" "$SND_DIR$LC"/"

# system minute
MINUTE=$(date +"%M")

# system hour, 12 hour clock
HOUR=$(date +"%I")

# loop counter, strip leading "0" from system hour
LOOP=$((10#$HOUR))

# version language
VERSION="clockchimes v0.2
Copyright 2018 - Stu Miller - Colorado, USA
All rights reserved."

# usage language
USAGE="Usage: $0 [OPTION]
Play clock chimes and hour strikes.

  --help        display this help and exit
  --test        test sample time, add hour & minute
  --version     display version information and exit

Report bugs to <slackbuilds@go4it2day.com>."

# Main routine
# check for options
case $1 in
  '--help')
    printf '%s\n' "$USAGE" || exit
  ;;
  '--test')
    # must pass script arguments to funtions
    test $1 $2 $3
  ;;
  '--version')
    printf '%s\n' "$VERSION" || exit
  ;;
esac

set_chime
set_strike
play_chimestrike