AcuRite Access/smartHUB and IP Camera Data Processing, Display, and Upload.
Notice: This program is open source 3rd party software. It is neither written nor supported by AcuRite.
See Acuparse in action via ghwx.ca
Acuparse is a PHP/MySQL program that captures, stores, and displays weather data from an AcuRite Iris (5-in-1) or Atlas (7-in-1) weather station and tower sensors, via your Access/smartHUB. It uploads weather data to Weather Underground, CWOP, Weathercloud, PWS Weather, Windy, Windguru, OpenWeather, and MQTT Brokers.
It also processes and stores images from a local network camera for display and external linking.
Built for weather geeks and designed to be clean, simple, and mobile friendly. It uses a minimal UI with a focus on data, not flashy graphics. Designed to compliment MyAcuRite and other 3rd party's sites and tools.
Acuparse requires a working AcuRite Access/smartHUB. You redirect weather data from your Access/smartHUB to your Acuparse server. It is captured, stored, and then passed along to MyAcuRite untouched. The response received from MyAcuRite is sent back to your Access/smartHUB. If sending data to MyAcuRite is disabled or when using a smartHUB, Acuparse creates the response.
Acuparse does not directly support the new AcuRite direct to WiFi Consoles. You may have success configuring these as an Access & Atlas/Iris sensor. Keep in mind, they do not support Tower sensors and there has been no official testing of these devices with Acuparse.
If you have one of these consoles and want to assist in adding support to Acuparse, connect with us using the Support channels below. We'll work with you to grab a capture of the data they send, allowing for future direct support.
- Your weather data belongs to you, stored on your OWN server.
- Display live camera images, and link from other sites like Weathercloud.
- Uploads weather data from your Iris/Atlas and Tower sensors to external providers.
- Publish weather data to an MQTT Broker Server.
- Customizable barometer readings.
- Southern Hemisphere Wind Direction Support.
- Light and Dark Themes.
- Display data in both ℉ and ℃. Selectable default.
- Multiple tower sensors; public or private.
- Multiple admin or regular user accounts.
- Regular users can only view private sensor data.
- Archived data display.
- Watch RAW data flow using the systems syslog.
- Stays online even when MyAcuRite is not.
- Does not require Internet access. Can be deployed independently of MyAcuRite.
- Export API with JSON and formatted HTML output for use in external applications.
- Customizable email outage notifications with Mailgun support.
- Matomo and Google Analytics support as well as Google reCAPTCHA form protection.
Note: If you are not using an Access, you will need to setup a DNS redirect using a DNS server on your local network.
Access Users: The AcuRite Access sends data to MyAcuRite using an SSL connection. By Default Apache will use the snake oil cert to serve over HTTPS. For most users, this should be sufficient. If you use a hostname, you will need to install and configure an SSL certificate. The installer will ask and attempt to generate a Lets Encrypt cert for you.
See docs/INSTALL.md for detailed installation instructions.
Installing on a fresh instance of a Debian/Rasbian Buster(10)/Bullseye(11) or Ubuntu 18.04/20.04 are the only officially supported and tested install method.
After installing and adding your sensors, you will may receive a "No Data Received!" message on your dashboard. Acuparse will need to receive readings from your Access/Hub before weather data can be displayed. See Initial Readings for more details.
See the Version 3 Update Guide for detailed instructions.
-
Install the base Debian/Ubuntu operating system and update.
-
Download and run the installer.
curl -O https://gitlab.com/acuparse/installer/raw/master/install && sudo bash install | tee ~/acuparse.log
See docs/DOCKER.md for detailed installation instructions.
On a newly installed Debian/Ubuntu System
-
Download and run the installer.
- If you already have Docker installed, see the Docker guide.
curl -O https://gitlab.com/acuparse/installer/raw/master/install_docker && \ sudo bash install_docker full | tee ~/acuparse.log
To update Docker Compose, run
sudo acuparse update && sudo acuparse update_compose
The primary user interface uses AJAX to pull the most recent HTML formatted data every minute.
Acuparse includes a Display mode for better viewing while in full-screen.
- Display Mode:
http(s)://<yourip/domain>/display
- Force light theme:
http(s)://<yourip/domain>/display?light
- Force dark theme:
http(s)://<yourip/domain>/display?dark
- Force light theme:
Additionally, you can request Bootstrap 5 formatted HTML, JSON array(s), or plain text formatted for watermarking.
- See the API Guide for details.
- Advanced Data Reporting.
- Reports can be run against the database. Open issues for custom report requests and tag them with the reports tag.
- phpMyAdmin is an excellent tool for advanced manual reporting on your station.
- Reports can be run against the database. Open issues for custom report requests and tag them with the reports tag.
- Charts and Graphing.
- Since this is available at most external weather sites.
- Multiple Access/smartHUB/Iris/Atlas sensors.
- The current framework built around a single Access/smartHUB and Iris/Atlas sensor.
If you like Acuparse, please support the project by buying me a coffee!
Acuparse is open-source software. Released with an AGPL-3.0+ license. It also uses several other open source scripts. Their licences included where available.
3rd party scripts located in src/pub/lib
.
See LICENSE for more details.
- Support for the core application/bugs is handled via GitLab Issues.
- You may also open a new issue by mailing support@acuparse.com.
- Community support is also provided via the Users Mailing List.
If you require advanced or commercial support, send mail to hello@acuparse.com.
See CHANGELOG.md for detailed release notes.
See CONTRIBUTING.md for more details.