Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/FergusYip/DrinkMoreApp
MacOS menu bar application to remind you to drink more water
https://github.com/FergusYip/DrinkMoreApp
Last synced: 26 days ago
JSON representation
MacOS menu bar application to remind you to drink more water
- Host: GitHub
- URL: https://github.com/FergusYip/DrinkMoreApp
- Owner: FergusYip
- License: mit
- Created: 2020-05-26T07:55:55.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-08-15T06:08:30.000Z (over 3 years ago)
- Last Synced: 2024-08-03T09:04:10.698Z (4 months ago)
- Language: Python
- Homepage:
- Size: 1.35 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- Mac-Menubar-Megalist - DrinkMore
README
# DrinkMore
DrinkMore is a Python 3 app for Mac to remind you to drink more water. When it's open you can choose whether or not to be reminded and change the frequency of which you would like to be reminded.
# Running the app
## Pre-Bundled
Download the latest pre-bundled version of the app - [here](https://github.com/FergusYip/DrinkMoreApp/releases).
Note: If you are running MacOS 10.15 or later, it will display a [popup](https://raw.githubusercontent.com/FergusYip/DrinkMoreApp/master/images/security_warning/warning.png) and prevent you from opening the app. You can still [open](https://raw.githubusercontent.com/FergusYip/DrinkMoreApp/master/images/security_warning/preferences.png) it by going to the _General_ tab of the _Security & Privacy_ section in _System Preferences_.
## Bundle it yourself
Clone the repository
```sh
git clone https://github.com/FergusYip/DrinkMoreApp.git
```
Enter the directory
```sh
cd DrinkMoreApp
```
Install requirements
```sh
pip3 install -r requirements.txt
```
Bundle app
```sh
python setup.py py2app
```
The compiled app will be found in the `dist` folder
## Run from source
Clone the repository
```sh
git clone https://github.com/FergusYip/DrinkMoreApp.git
```
Enter the directory
```sh
cd DrinkMoreApp
```
Install requirements
```sh
pip3 install -r requirements.txt
```
Run the app
```sh
python3 app.py
```
Note: The settings window will not display the app icon as it is the python interpreter that is running the application.
# Dependencies
[rumps](https://pypi.org/project/rumps/) by Jared Suttles and Dan Palmer
[py2app](https://pypi.org/project/py2app/) by Bob Ippolito and Ronald Oussoren
# Credits
Developed by Fergus Yip, 2020
[Droplet, of, water Free Icon](https://icon-icons.com/icon/droplet-of-water/83794) by [Daniel Bruce](www.danielbruce.se), reused under the [CC BY License](https://creativecommons.org/licenses/by/4.0/). Modifications to the color and the addition of an outline and drop shadow have been made.