Skip to content

Taiwan Real-time Earthquake Monitoring for HA Integration

License

Notifications You must be signed in to change notification settings

gaojiafamily/ha-trem

Repository files navigation

Taiwan Real-time Earthquake Monitoring for HA

Logo

GitHub Release hacs_custom License

Stargazers Issues Contributors

BuyMeCoffee


English | 繁體中文

Screenshots

config_flow_image simulator_earthquake_demo Demo video



Important

The source of earthquake early warning is provided by ExpTech Studio and is for reference only.
The actual results are subject to the content published by CWA.



Feature

  • Isoseismal map image (can also be saved as file).
  • Simulator earthquake service.
  • RTS Notification (Exptech VIP Only).
  • Tsunami Notification (Exptech VIP Only).


Available

Environment Home Assistant OS Home Assistant Core Home Assistant Supervisor
Virtual Machine1 ✔️
Container ✔️ 2
Virtual Environment ✔️
Physics Machine3 4 5 2

✔️ Available
✖️ Unavailable
❓ Untested
➖ See footnotes



Prerequisite (if you're using HAOS)

Manual install dependencies see here.

Important

This custom component installation is considered advanced
should only be used if one is an expert in managing a Linux operating system.

/tmp is mounted noexec on HAOS so it can't compile, A workaround is to do this inside the container.



Installation

Using HACS (recommended)

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Manual

  1. Create config/custom_components folder if not existing.
  2. Copy trem into custom_components folder.


Config

Please use the config flow of Home Assistant.

  1. With GUI. Configuration > Integration > Add Integration > Taiwan Real-time Earthquake Monitoring
    • If the integration didn't show up in the list please REFRESH the page
    • If the integration is still not in the list, you need to clear the browser cache.

A Region code can be search here.



Data Source

  • HTTPS API (or use your self-server)
  • Websocket. (Exptech VIP Only)

HTTPS API

Node Description
tainan_cache_limit The number of requests is limited
tainan_cache Available to all users
taipe_cache_limit The number of requests is limited
taipe_cache Available to all users
taipei_limit The number of requests is limited
taipei The data is real-time but the load is high
taipei_2 The data is real-time but the load is high
pingtung_limit The number of requests is limited
pingtung The data is real-time but the load is high
pingtung_2 The data is real-time but the load is high

Websocket

Exptech VIP Only

You can goto [https://exptech.com.tw/pricing](https://exptech.com.tw/pricing) to subscribe.


An API server can be monitored here.



Known issues

  1. Not support Home Assistant 2024.8 and higher yet.


Contribution

  • ExpTech Studio Data Source
  • watermelon1024 Contributor
  • kukuxx Test Partner

I would like to thank everyone who has helped me and every partner in the community for their generous help.



Donate

Buy me a coffee LINE Bank JAKo Pay
Buy me a coffee Line Bank JAKo Pay


License

AGPL-3.0 license

2024-08-15 Agreement reached with ExpTech Studio.

Footnotes

  1. Virtual Machine may include but not limited to: VirtualBox、Unraid、KVM/Proxmox、UTM...etc.

  2. If your installation method is it. 2

  3. Physics Machine may include but not limited to: Raspberry Pi、Home Assistant Green、Home Assistant Yellow...etc.

  4. So far, only known rpi4 4GB is available.

  5. If your installation method on other systems, Hope you can provide feedback.