<p align="center">
<img src="src/images/icon128x128.png"></img>
<br>
<strong>wimi</strong>
</p>

wimi relays information about your public IP address
from
[clean.myip.wtf/json](https://clean.myip.wtf/json)
to your browser. The primary development and runtime
dependencies are
[TypeScript](https://www.typescriptlang.org/),
[preact](https://preactjs.com/),
and
[webpack](https://webpack.js.org/).
The extension can be built locally and installed as a
developer extension / addon on both Chromium and FireFox.
There are XPI files provided for FireFox users as well.

## Install

**Chromium|Chrome**

* Produce the `build/` directory

        $ git clone https://github.com/0x1eef/wimi
        $ cd wimi
        $ npm i
        $ npm run build:production

* Load the extension
    * Visit `chrome://extensions`
    * Check `Developer mode` (top right hand corner)
    * Click `Load unpacked extension`
    * Choose the `build/production/` directory from the file dialog
    * Done

**Firefox**

wimi can be installed [from mozilla's store](https://addons.mozilla.org/en-US/firefox/addon/97c865f874d543128d35/).
The add-on can also be built locally and side-loaded - similar
to the process that was described for **Chromium|Chrome** users.

## Sources

* [GitHub](https://github.com/0x1eef/wimi#readme)
* [GitLab](https://gitlab.com/0x1eef/wimi#about)
* [brew.bsd.cafe/@0x1eef](https://brew.bsd.cafe/0x1eef/wimi)

## Credit

The extension includes icons that have been downloaded
via my premium account on [flaticon](https://www.flaticon.com).
Credit to the original graphic artists

## License

[The MIT License](https://choosealicense.com/licenses/MIT/)
<br>
See [LICENSE](./share/wimi/LICENSE)