nibble0101 / breathing

A simple browser extension to help calm your nerves by just breathing in and out. It will help you breath your way to wellness.

Breathing

Relax, meditate and breathe your way to wellness

Breathing is a simple application to help you relax. We all face unnerving situations sometimes. Perhaps you are preparing for an exam, an interview, your first conference talk, or a life-changing activity which makes you nervous. We all experience that feeling. Sometimes just breathing in and out is what you need. It helps calm you down and soothe your nerves. And that is the purpose of this application. Breathing helps you relax by breathing in and out.

This is the browser extension version of the linux desktop application Breathing which, was created and designed by Dave Patrick. You can also download the desktop application on Flathub if you use GNOME desktop environment.

Contributing

If you find this app useful, do consider contributing. If you are wondering how, you can contribute in the following ways.

• You can translate to your local language. Be sure to first check whether your language is supported.
• You can rate us on the app store or star the project repository on GitHub.
• Report bugs if you encounter some. There are probably a handful of them.
• You can also contribute code. If it is a bug fix do open a pull request(PR). However, if it is a new feature, first open an issue so that we discuss before opening a PR.

Run project locally

To run this project locally, clone this repository and load the unpacked extension in a chromium-based browser like Chrome, Opera, Edge or Brave. You can follow this guide on loading upacked extension in chrome.

Be aware the process might be slightly different for the other browsers and be sure to load the extension in the chromium directory for chromium-based browsers. Similarly, you can also load the unpacked extension in the firefox directory to test the extension in Firefox.

License

Breathing is a free software and will always be free. It is released under the terms of the GNU General Public License v3.0.

Copyright

Copyright © Joseph Mawa and Dave Patrick.

breathing's Issues

Use SVG icons

Use SVG icons instead of HTML entity codes,

Add option for including soothing nature sound

It helps to include soothing nature sound during relaxation. Need to add that feature.

Aborting during breath out doesn't stop transition animation

Currently stopping the breathing exercise during breathe out doesn't stop the transition animation in Firefox. Find a solution for it. It should behave like Chromium-based browsers.