Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ttytm/wthrr-the-weathercrab

🌞 🦀 🌙 Weather companion for the terminal. Rust app.
https://github.com/ttytm/wthrr-the-weathercrab

cli-tool rust weather

Last synced: 12 days ago
JSON representation

🌞 🦀 🌙 Weather companion for the terminal. Rust app.

Host: GitHub
URL: https://github.com/ttytm/wthrr-the-weathercrab
Owner: ttytm
License: mit
Created: 2022-07-12T12:45:42.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-05-05T09:52:51.000Z (6 months ago)
Last Synced: 2024-05-19T11:10:53.278Z (6 months ago)
Topics: cli-tool, rust, weather
Language: Rust
Homepage: https://crates.io/crates/wthrr
Size: 2.7 MB
Stars: 323
Watchers: 3
Forks: 22
Open Issues: 12
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

awesome-rust - wthrr - Weather companion for the terminal. [![crates.io](https://img.shields.io/crates/v/wthrr?logo=rust)](https://crates.io/crates/wthrr) (Applications / Utilities)
fucking-awesome-rust - wthrr - Weather companion for the terminal. [![crates.io](https://img.shields.io/crates/v/wthrr?logo=rust)](https://crates.io/crates/wthrr) (Applications / Utilities)
fucking-awesome-rust - wthrr - Weather companion for the terminal. [![crates.io](https://img.shields.io/crates/v/wthrr?logo=rust)](https://crates.io/crates/wthrr) (Applications / Utilities)

README

        # 🦀 wthrr-the-weathercrab

[![][ci_shield]](https://github.com/ttytm/wthrr-the-weathercrab/actions/workflows/ci.yml?query=branch%3Amain)

[![][last_commit_shield]](https://github.com/ttytm/wthrr-the-weathercrab/commits/main)

[![][crates_io_shield]](https://crates.io/crates/wthrr)

[![][msrv_shield]](https://github.com/ttytm/wthrr-the-weathercrab)



[![][preview]][preview]



`wthrr` lives in your terminal and her passion is meteorology.

If you spend time in the TUI, you'll have a little companion nearby who knows about the weather.

## Contents

- [How to use?](https://github.com/ttytm/wthrr-the-weathercrab#how-to-use)

- [Showcase](https://github.com/ttytm/wthrr-the-weathercrab#showcase)

- [Config](https://github.com/ttytm/wthrr-the-weathercrab#config)

- [Installation](https://github.com/ttytm/wthrr-the-weathercrab#installation)

- [Outlook](https://github.com/ttytm/wthrr-the-weathercrab#outlook)

- [Credits](https://github.com/ttytm/wthrr-the-weathercrab#credits)

## How to use?

**Just call**

```

wthrr

```

Without having added an address or options, wthrr uses the [config](https://github.com/ttytm/wthrr-the-weathercrab#config) saved as default.


If you haven't configured anything as default yet, wthrr can try to search for a weather station near you and save the searched location as default.

**It's always possible to specify an address.** E.g.,

```

wthrr melbourne

```

Depending on the place you are looking for, you might need to be more specific.

For example, the above call will get Melbourne in Australia. If you are aiming for Melbourne in the US, ask for `melbourne,florida`.

If the address contains spaces, separate them with a hyphen or enclose them in quotation marks (e.g., `new-york` or `"new york"`).

To search explicitly for a weather station in the vicinity, call

```

wthrr auto

```

As a final example, we instruct wthrr to use Fahrenheit and mph as units and add the hourly forecast for the day

```

wthrr -u f,mph -f d

```

### Find further usage parameters in the help information

```

> wthrr -h

Usage: wthrr [OPTIONS] [ADDRESS]

Arguments:

  [ADDRESS]

          Address to check the weather

Options:

  -f, --forecast 

          [e.g.: -f w,d] [possible values: disable, (w)eek, to(d)ay, (t)omorrow, mo, tu, we, th, fr, sa, su]

  -F, --historical-weather <%Y-%m-%d,...>

          [e.g.: -F 2021-12-31]

  -u, --units 

          [e.g.: -u f,12h,in] [possible values: (c)elsius, (f)ahrenheit, kmh, mph, (kn)ots, ms, 12h, 24h, %, mm, (in)ch]

  -l, --language 

          Output language [e.g.: en_US]

  -s, --save

          Save the supplied values as default

  -r, --reset

          Wipe wthrr's configuration data

  -h, --help

          Print help

  -V, --version

          Print version

```

## Showcase

|                                         |                                         |

| :-------------------------------------: | :-------------------------------------: |

|              **First Run**              |           **Hourly Forecast**           |

|       [![][first_run]][first_run]       | [![][hourly_forecast]][hourly_forecast] |

|            **Week Forecast**            |          **\*Terminal Colors**          |

| [![][weekly_forecast]][weekly_forecast] | [![][terminal_colors]][terminal_colors] |

|                                         |                                         |

^{\*Rendering and colors are influenced by the terminal used and its theme and font.


E.g., the first of the above screenshots show wthrr in nvim(toggleterm) using kitty as terminal with a Dracula theme and JetBrainsMono Nerd font. The last screenshot shows wthrr in Yakuake/Konsole, also with a Dracula color scheme.}

## Config

The address, units and default forecast can be saved as default values in wthrr's config file by adding the `-s` flag to a run. This will save the config in `wthrr.ron`.

**Platform locations:**


Lin: `~/.config/weathercrab/`


Mac: `~/Library/Application Support/weathercrab/`


Win: `%USERPROFILE%\AppData\Roaming\weathercrab\`

**Default values**

```rust

(

    address: "", // Address to check the weather, e.g.: "Berlin,DE"

    language: "en_US", // Language code of the output language

    forecast: [], // Forecast to display without adding the `-f` option: `[day]` | `[week]` | `[day, week]`

    units: (

        temperature: celsius, // Temperature units: `celsius` | `fahrenheit`

        speed: kmh, // (Wind)speed units: `kmh` | `mph` | `knots` | `ms`

        time: military, // Time Format: `military` | `am_pm`

        precipitation: probability, // Precipitation units: `probability` | `mm` | `inch`

    ),

    gui: (

        border: rounded, // Border style: `rounded` | `single` | `solid` | `double`

        color: default, // Color: `default` | `plain`

        graph: (

            // Graph style: lines(solid) | lines(slim) | lines(dotted) | dotted | custom((char; 8))

            // `custom` takes exactly 8 chars. E.g. using a set of 4 chars: `custom(('⡀','⡀','⠄','⠄','⠂','⠂','⠁','⠁'))`,

            style: lines(solid),

            rowspan: double, // Graph height: `double` | `single`

            time_indicator: true, // Indication of the current time in the graph: `true` | `false`

        ),

        greeting: true, // Display greeting message: `true` | `false`

    ),

)

```

## Installation

Use rusts package manger to install wthrr.

**From crates.io**

|             |                       |

| ----------- | --------------------- |

| **Version** | **Command**           |

| release     | `cargo install wthrr` |

|             |                       |

| development | _not available_       |

|             |                       |

**From git source**

|             |                                                                                   |

| ----------- | --------------------------------------------------------------------------------- |

| **Version** | **Command**                                                                       |

| release     | `cargo install --git https://github.com/ttytm/wthrr-the-weathercrab --tag v1.1.1` |

|             |                                                                                   |

| development | `cargo install --git https://github.com/ttytm/wthrr-the-weathercrab`              |

|             |                                                                                   |

**Requirements and alternative, platform-specific installation instructions can be found in [`INSTALL.md`](https://github.com/ttytm/wthrr-the-weathercrab/blob/main/INSTALL.md).**

> **Important**

> To display symbols correctly, the used terminal must be configured to use a NerdFont.

## Outlook

The [issues](https://github.com/ttytm/wthrr-the-weathercrab/issues) section lists some of the features that are being worked on.

Contributions like 🐛bug reports, ⭐️stars and 💡suggestions are welcome alike!

A simple changelog can be found on the [releases page](https://github.com/ttytm/wthrr-the-weathercrab/releases).

## Contributors



  



## Credits

- The app uses the open-source weather API for non-commercial use provided by [Open Meteo](https://open-meteo.com/en)




[preview]: https://github.com/ttytm/wthrr-the-weathercrab/assets/34311583/58780205-816b-4cfd-95f8-9453e754eb94

[crates_io_shield]: https://img.shields.io/crates/v/wthrr?style=flat-square&color=DEA584

[ci_shield]: https://img.shields.io/github/actions/workflow/status/ttytm/wthrr-the-weathercrab/ci.yml?branch=main&style=flat-square

[last_commit_shield]: https://img.shields.io/github/last-commit/ttytm/wthrr-the-weathercrab?style=flat-square

[msrv_shield]: https://img.shields.io/badge/MSRV-1.74.0-DEA584?style=flat-square

[first_run]: https://user-images.githubusercontent.com/34311583/219735581-8036590f-8354-47fb-a31f-055be79c9229.png

[hourly_forecast]: https://user-images.githubusercontent.com/34311583/219735474-d8e2899d-c209-46d3-a5cd-bea4ed41ac3c.png

[weekly_forecast]: https://user-images.githubusercontent.com/34311583/219735452-9766d692-a79b-4a5a-a903-30a3339cc684.png

[terminal_colors]: https://user-images.githubusercontent.com/34311583/219735417-6376c599-4b90-4066-8808-d9bd8649ae64.png