Acuparse

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.

Live Example Station

See Acuparse in action via ghwx.ca

How it Works

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.

Direct to WiFi Consoles

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.

Features

• 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.

What's Missing

• 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.
• 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.

Installation

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 Bullseye (11)/Buster (10) or Ubuntu Jammy (22.04)/Focal (20.04) or using Docker are the only officially supported and tested install methods.

After installing and adding your sensors, you 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.

Quick Install

• 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
  

Docker Compose

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
  

Updating

See docs/UPDATING.md for detailed update instructions.

Release Notes

See CHANGELOG.md for detailed release notes.

Additional Outputs

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

Additionally, you can request Bootstrap 5 formatted HTML, JSON array(s), or plain text formatted for watermarking.

• See the API Guide for details.

Troubleshooting

See docs/TROUBLESHOOTING.md for common troubleshooting steps.

Donations

If you like Acuparse, please consider supporting the project with a donation.

Licencing

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.

Included 3rd party scripts are located in src/pub/lib.

See LICENSE for more details.

Support and Discussion

Join the discussion on Slack

• Support for the core application/bugs is handled via GitLab Issues.
  • You may also open a new issue by mailing [email protected].
• Community support is also provided via the Users Mailing List.

If you require advanced or commercial support, send mail to [email protected].

Contributing

See CONTRIBUTING.md for more details.