Temperature Alarm

This application monitors the temperature from a PASCO BLE sensor and triggers an alarm when the temperature reaches a user-defined target. It features a Textual-based user interface (TUI) for easy interaction and a graphical display of the temperature data.

Installation

1. Install Python: Ensure you have Python 3.11 or later installed.

2. Install Required Packages:

   pip install -r requirements.txt

3. Configure Notifications: Create a config/config.toml file with your settings:

   [ntfy]
   enabled = true
   server = "https://ntfy.sh"
   topic = "your-topic-name"
   username = ""
   password = ""
   priority = "high"
   tags = ["thermometer"]
   
   [voice]
   enabled = true
   
   [data_recording]
   enabled = true
   path = "data/temperature_logs.db"

Running the Application

1. Connect the PASCO BLE Sensor: Make sure your PASCO BLE sensor is powered on and within range of your computer.

2. Run the Application:

   python main.py

Usage

1. Scan for Devices: Click the "Scan for Devices" button to discover available PASCO BLE sensors.

2. Select a Device: Choose the desired sensor from the dropdown list.

3. Set Target Temperature: Enter the target temperature in the input field.

4. Start Monitoring: Click the "Start Monitoring" button to begin monitoring the temperature.

5. Stop Monitoring: Click the "Stop Monitoring" button to pause monitoring.

6. Exit: Click the "Exit" button to shut down the application.

Features

• Textual User Interface (TUI): Provides a user-friendly interface for interacting with the application.
• Temperature Monitoring: Continuously monitors the temperature from the selected PASCO BLE sensor.
• Target Temperature Alarm: Triggers an alarm when the temperature reaches the set target.
• Graphical Display: Shows a real-time graph of the temperature data.
• Audio Notifications: Plays text-to-speech announcements of temperature changes and alarm events.
• Push Notifications: Sends notifications via ntfy when temperature targets are reached.
• Data Recording: Configurable temperature data recording to SQLite database

Screenshot

The Temperature Alarm application interface showing the temperature graph and controls

Notifications

The application uses ntfy for push notifications. When the target temperature is reached, you'll receive:

• Mobile/desktop notifications through the ntfy service
• Customizable notification priority and tags
• Optional authentication for private ntfy topics
• Real-time temperature updates with configurable settings

Notes

• The application requires a PASCO BLE sensor to function.
• The config/config.toml file contains notification settings.

Configuration Details:

[ntfy]

• enabled: Set to true to enable notifications, false to disable

• server:

  • Default is "https://ntfy.sh"
  • Can be set to your self-hosted ntfy server
  • Must include the protocol (http:// or https://)

• topic:

  • Your notification topic (default: "your-topic-name")
  • Keep this private to prevent unauthorized notifications
  • Used in the URL: {server}/{topic}

• username/password:

  • Optional authentication for private topics
  • Leave empty for public topics
  • Both must be set if authentication is needed

• priority:

  • Set to "high" by default
  • Controls notification importance
  • Other options: "default", "low", "urgent"

• tags:

  • List of emoji tags shown in notifications
  • Currently configured for: 🌡️ (thermometer)
  • Displayed as icons in mobile notifications

[voice]

• enabled: Set to true to enable voice features

[data_recording]

• enabled: Set to true to enable data logging
• path: Specifies the SQLite database location (default: "data/temperature_logs.db")

Mobile Device Setup

Subscribe to Notifications

1. Install the Official App:

   • Android:
     • Google Play Store
     • F-Droid (Firebase-free version)
   • iOS:
     • App Store

2. Subscribe to Your Topic:

   • Open the ntfy app or PWA
   • Add a new subscription
   • Enter your topic URL: https://ntfy.sh/your-topic-name or just your-topic-name if using ntfy.sh
   • If using authentication, enter your username and password

Testing the Connection

1. Send a test notification:

   curl -d "Test notification" ntfy.sh/your-topic-name

2. You should receive the notification on your mobile device immediately.

Security Considerations

• Keep your topic name private to prevent unauthorized notifications
• Use authentication for sensitive topics
• Consider using a self-hosted ntfy server for additional security
• Topic names are case-sensitive and should be unique

Contributing

Contributions are welcome! Please feel free to open issues or submit pull requests.

Contributors

• @Håkan Niska

License

This project is licensed under the MIT License.

Acknowledgments

• ntfy - A simple pub-sub notification service that powers our push notifications. Thank you to @binwiederhier for creating this excellent open-source tool.
  • Documentation
  • GitHub Repository