Giter VIP home page Giter VIP logo

neowx-material's Introduction

NeoWX Material

The most versatile and modern weewx skin

You want a modern UI for your weather station and its archive?

Including translation, customization, great appearance on tablets and smartphones, and even a dark mode?

Then this skin is the one you're looking for!

This is the new version of the famous NeoWX (based on Sofaskin), including a modern Material Design UI, full weather data archive, and many more new features.

Key features

  • beautiful Material Design
  • many color schemes to choose from
  • interactive and zoomable charts
  • wind direction + speed visualization as a wind rose
  • accessible HTML + NOAA TXT file archive for all years and months
  • easy translation - provides many languages out of the box! (or add your own translation)
  • auto dark mode - works great on mobile and desktop
  • responsive design - optimized for modern tablets and smartphones
  • support for all available sensors
  • many options to customize your reports even more - have a look at the skin.conf
  • ...and much more!

Learn more about all features on our project page: NeoWX Material | Neoground Projects.

Installation

See the official documentation for more information.

  1. Download the latest version
  2. Install the extension: wee_extension --install=path/to/neowx-material.zip
  3. restart weewx: sudo service weewx restart

If your skin doesn't change edit the weewx.conf and set skin = neowx-material in the [StdReport] section, after that reload weewx: sudo service weewx reload.

This skin works best with the python ephem module installed (needed for the almanac). Install pyephem via pip, or the python3-ephem package via package manager.

Contribution

Feel free to add your own improvements. Contributions are always welcome!

Our previous skin, NeoWX, was used all over the world in many countries. We hope that this skin will do the same. Please consider translating our skin in your language.

If you want to provide any improvements, feel free to create a pull request. We use Gitmoji commit messages.

Development

Setting up the development environment is easy:

  • clone / download repository
  • install npm packages (yarn install / npm install)
  • for easy testing create a symlink from your WEEWX_HOME/skins/neowx-material to the src directory

For basic tasks npm / yarn scripts are available.

Styling is done via SCSS, compile it to css/style.css by: yarn run build-css.

Available scripts

Script Description
build-css Create css/style.css from SCSS files
build-minify-css Create minified css/style.min.css from SCSS files
cleanup-build Remove development files from dist directory
copy-directories Copy directories from src to dist (for building)
copy-files Copy files from src to dist (for building)
delete-build Remove files inside dist/skins/neowx-material
build Build job: delete-build, build-minify-css, copy files + dirs, cleanup
create-zip Creates a zip file of the dist directory. Use this after build

Building

To create a dist package run yarn run build. This will clean up the dist environment and copy all files, directories and create the minified CSS.

You find the final skin at dist/skins/neowx-material. Create a zip-file of the dist directory to create the final package which you can easily install with wee_extension.

You may need to adjust the values if you add / change file names. In this case you may also need to adjust the dist/install.py script which contains a list of all files which should be copied to the weewx skin directory on installation.

Building is currently only supported on linux systems due to system commands used in the npm scripts. On other systems this needs to be adjusted or done manually.

Thank You!

This config and some parts of the skin are based on the template code
of the original "Standard" skin of weewx. Many thanks to Tom Keffer and
the weewx contributors. One of the best solutions for your weather station under linux!

The design is based on Material Design for Bootstrap (MDB) Free.

The NOAA reports, and some parts of the configuration are based on the Standard weewx skin as well.

These 3rd party libraries are used:

neowx-material's People

Contributors

chrismiceli avatar dtalens avatar iiseppi avatar mbouyer avatar neoground avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.