https://github.com/tryhardfifi/breathe

breathe is a (distraction-free) peripheral breath trainer, it helps you breathe correctly so you can stay calm and focus on what matters.
https://github.com/tryhardfifi/breathe

breathing calm productivity swift

Last synced: 4 days ago
JSON representation

breathe is a (distraction-free) peripheral breath trainer, it helps you breathe correctly so you can stay calm and focus on what matters.

• Host: GitHub
• URL: https://github.com/tryhardfifi/breathe
• Owner: tryhardfifi
• Created: 2020-07-31T14:01:46.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-02-27T13:50:42.000Z (over 1 year ago)
• Last Synced: 2024-10-30T06:58:10.790Z (17 days ago)
• Topics: breathing, calm, productivity, swift
• Language: Swift
• Homepage:
• Size: 29 MB
• Stars: 266
• Watchers: 5
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# breathe: peripheral breath trainer 💨💨

breathe is a (distraction-free) peripheral breath trainer, it helps you breathe correctly so you can stay calm and focus on what matters. Breathe's window is small and it always stays on top so you can look at it peripherally, while doing other stuff.

![Alt Text](./github.gif)

## Features

- ✅ Custom exercises

- ✅ Custom window color for each step

- ✅ Anchoring selector

- ✅ Transport between spaces and works on fullscreen

- ✅ Progressively increase time intervals

- ✅ Open at login

- 🚧 Fluid color change between steps

## Motivation

I created this project after reading some hn articles on how breathing correctly can help you focus and can calm you. I don't expect this to work for everyone but it does indeed work for me. Some of the articles:

- https://quietkit.com/box-breathing/

- https://www.theguardian.com/lifeandstyle/2020/jul/26/every-breath-you-take-the-lost-art-of-breathing

- https://www.wsj.com/articles/the-healing-power-of-proper-breathing-11590098696

If you want to see the Show HN thread: https://news.ycombinator.com/item?id=24008678

## Installation

### Mac

You can download the app [here](https://github.com/filipeisho/breathe/releases).

### Linux

Right now breathe doesn't run on linux but [@amar-laksh](https://github.com/amar-laksh) provided an awesome KISS solution:

- Install imv: https://github.com/eXeC64/imv (really lightweight viewer)

- Download this gif breathe.gif: https://quietkit.com/img/box-breathing-4x-v03.gif

- run imv breathe.gif

- Set it to a custom shortcut and press q to close window.

## Contributing

Feel free to Contribute to this project!

## Contributors

-   [@filipeisho](https://github.com/filipeisho)

-   [@amar-laksh](https://github.com/amar-laksh)

-   [@guimcaballero](https://github.com/guimcaballero)

## License

The MIT License (MIT).