Metadata-Version: 2.1
Name: Range_Announcer
Version: 1.0.8
Summary: Announce range closure as sunset approaches
Home-page: https://github.com/CrazyVikingProductions/range_announcer
Author: Michael J. Swenson
Author-email: mikswenson@gmail.com
Project-URL: Bug Reports, https://github.com/CrazyVikingProductions/range_announcer/issues
Project-URL: Source, https://github.com/CrazyVikingProductions/range_announcer
Keywords: sunset closure announce
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Other Audience
Classifier: Topic :: Other/Nonlisted Topic
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Description-Content-Type: text/markdown; charset=UTF-8
License-File: LICENSE

# Announce that the range is closing.

** The application is designed to run on Raspberry Pi 3B or newer. **

Between Midnight and Noon the application synchronizes the time on the Raspberry Pi with an atomic time server.
It calculates the sunset for the day given the date from the OS and the longetude and latitude values provided in the ini file.
It calculates the amount of time between now and one hour, one minute before sunset then goes to sleep for that long an interval.


## Features

* Calculates the sunset for the current date and location.
* Uses a Shelly 1PM switch to turn the power on and off for an external amplifier.
* Plays recorded messages announcing impending range closure at:
  * 1 hour before sunset
  * 30 minutes before sunset
  * 15 minutes before sunset
  * 5 minutes before sunset
  * at sunset
* Can be started at any time and it will play the required messages.
* Loops indefinitely...start it once and let it run.
    * Note: The application spends almost all of the time performing a sleep operation so it is not using CPU or resources. 
* Logs information to Range_Announcer_Log.txt


## Requirements:

The application is intended to be run on Raspberry Pi 3B or newer with a wireless network interface and sound output jack.

The program requires inputs for:
1.  The longitude and latitude of the location.
2.  The IP address for the Shelly 1PM switch.
3.  The URLs to turn the Shelly switch on and off.
4.  A delay time to account for the delay between when the amp is powered on and when it is functioning.

These inputs are stored in the file rangeannouncer.json


## History

Range Announcer is the first python application written and released by Michael J. Swenson.  Built using PyCharm 2022.3.1 Community edition.


## License

Range Announcer is licensed under the BSD-3-Clause license (see `LICENSE`).
