From a6b2b4f9f55c0b1ea2debba1173b116746c63097 Mon Sep 17 00:00:00 2001 From: Ivan Storck Date: Mon, 10 Oct 2022 15:18:53 -0700 Subject: [PATCH] Add README --- README.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 74 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..c04e762 --- /dev/null +++ b/README.md @@ -0,0 +1,74 @@ + +# I am here + +A menubar app that keeps the mouse moving on your computer + +- to watch a movie without the screensaver turning on +- to read a long article +- to show others you are still there. + +## Authors + +Developed by Ivan Storck +- [@ivanoats on github](https://www.github.com/ivanoats) +- [@ivanoats on linkedin](https://www.linkedin.com/ivanoats) + +## Development Dependencies + +- [PyAutoGUI](https://github.com/asweigart/pyautogui) +- [Py2App](https://py2app.readthedocs.io/en/latest/index.html) +- [Rumps](https://rumps.readthedocs.io/en/latest/) + + +## Run Locally + +Clone the project: + +```bash + git clone https://github.com/ivanoats/i-am-here.git +``` + +Go to the project directory: + +```bash + cd i-am-here +``` + +Install dependencies: + +```bash + python3 -m pip install -r requirements.txt +``` + +Start the app in development mode: + +```bash + python3 i-am-here.py +``` + +or build the app with alias mode: + +```bash +python3 setup.py py2app -A +``` + + +## Build and Install + +Build the app with: + +```bash + python3 setup.py py2app +``` + +Install the app (MacOS) with: + +```bash + cp -r dist/i-am-here.app /Applications +``` + +Then allow accessibilty in system preferences. + +## Badges + +[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)