Skip to content

Captures, stores, and displays data from an AcuRite ‎Iris/Atlas weather station and towers via an Access/smartHUB. Uploads data to Weather Underground, CWOP, Weathercloud, PWS Weather, Windy, Windguru, and OpenWeatherMap. *** MIRROR REPO | See: https://gitlab.com/acuparse/acuparse ***

License

acuparse/acuparse

stable
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
cam
 
 
 
 
 
 
 
 
 
 
sql
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.

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

UPDATING TO VERSION 3

See the Version 3 Update Guide for detailed instructions.

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

To update Docker Compose, run

sudo acuparse update && sudo acuparse update_compose

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.

Troubleshooting

See docs/TROUBLESHOOTING.md.

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.

Donations

If you like Acuparse, please support the project by buying me a coffee!

Buy Me a Coffee

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.

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

See LICENSE for more details.

Support and Discussion

Join the discussion on Slack

If you require advanced or commercial support, send mail to hello@acuparse.com.

Release Notes

See CHANGELOG.md for detailed release notes.

Contributing

See CONTRIBUTING.md for more details.