{"id":16359450,"url":"https://github.com/alexanderepstein/sandman","last_synced_at":"2025-04-05T23:07:45.769Z","repository":{"id":20358115,"uuid":"89555278","full_name":"alexanderepstein/Sandman","owner":"alexanderepstein","description":"An Application Built With Late Night Developers In Mind","archived":false,"fork":false,"pushed_at":"2022-06-16T23:59:28.000Z","size":73299,"stargazers_count":514,"open_issues_count":6,"forks_count":29,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-03-29T22:05:43.857Z","etag":null,"topics":["cross-platform","electron","insomnia","javascript","productivity","sleep"],"latest_commit_sha":null,"homepage":"https://alexanderepstein.github.io/Sandman/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexanderepstein.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"License.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-27T04:22:55.000Z","updated_at":"2025-03-23T10:40:49.000Z","dependencies_parsed_at":"2022-09-20T21:50:29.886Z","dependency_job_id":null,"html_url":"https://github.com/alexanderepstein/Sandman","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexanderepstein%2FSandman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexanderepstein%2FSandman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexanderepstein%2FSandman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexanderepstein%2FSandman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexanderepstein","download_url":"https://codeload.github.com/alexanderepstein/Sandman/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247411234,"owners_count":20934653,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cross-platform","electron","insomnia","javascript","productivity","sleep"],"created_at":"2024-10-11T02:08:22.762Z","updated_at":"2025-04-05T23:07:45.739Z","avatar_url":"https://github.com/alexanderepstein.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n # ![Sandman](https://github.com/alexanderepstein/Sandman/blob/master/assets/sleep_github.png) Sandman ![Sandman](https://github.com/alexanderepstein/Sandman/blob/master/assets/sleep_github.png)\n\n ####  an application built with late night developers in mind\n\n![Version](https://img.shields.io/github/release/alexanderepstein/Sandman/all.svg) [![Github All Releases](https://img.shields.io/github/downloads/alexanderepstein/Sandman/total.svg)]() [![Build Status](https://travis-ci.org/alexanderepstein/Sandman.svg?branch=master)](https://travis-ci.org/alexanderepstein/Sandman) [![Libraries.io for GitHub](https://img.shields.io/librariesio/github/alexanderepstein/Sandman.svg)]()\n\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/12b7f0ba50924e73b3efba2927a8c3ea)](https://www.codacy.com/app/alexanderepstein/Sandman?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=alexanderepstein/Sandman\u0026amp;utm_campaign=Badge_Grade)  ![framework](https://img.shields.io/badge/framework-electron-blue.svg)  ![platform](https://img.shields.io/badge/platform-crossplatform-lightgrey.svg)  [![license](https://img.shields.io/github/license/mashape/apistatus.svg?style=plastic)]()\n\n\n ![Counting Sheep](https://github.com/alexanderepstein/Sandman/blob/master/assets/giphy.gif)\n\n ## Lightweight bash version can be found \u003ca href=\"https://github.com/alexanderepstein/Sandman-Lite\"\u003ehere\u003c/a\u003e\n\n Sandman will remind you to take a rest and that you can always come back to the work tomorrow.\n\nA sleep cycle is a 90-minute chunk of time where your body transitions through various phases of sleep — all the way down to deep REM sleep — then back again. Some health experts believe that these 90-minute sleep cycles are the key to restful sleep. They recommend trying to sleep exactly 7.5 hours — or even 9 hours, if you have the time.\n\n\nBased on your wakeup time and the sleep algorithm Sandman calculates the best times for you to sleep. It will notify you throughout the night when the optimal times to shutdown your computer and start to head to sleep and provide a button to do just that.\n\nThis application works well with https://justgetflux.com/\n\nInspired by http://sleepyti.me\n\n\u003c/div\u003e\n\n## In Action\n\n![Usage](https://github.com/alexanderepstein/Sandman/blob/master/assets/Usage.gif)\n\n\n\n## Install\n\n### Mac\nHomebrew casks are the preferred method of installations (easiest to upgrade Sandman with brew cask update)\n\n#### Homebrew install\n```bash\nbrew tap caskroom/cask # add homebrew casks if you havent already\nbrew update\nbrew cask install sandman\n```\n#### Manual install\nDownload your respective platforms release from the downloads section.\n\nDrag the Sandman.app from the Sandman dmg to the Applications folder. Double Clicking on the app should run it and it could be kept in the dock from here.\n\n### Linux\nOpen up a terminal and navigate to the folder containing the downloaded installer files and run\n#### Debian\nFirst make sure you have the dependency libappindicator1\n```bash\nsudo apt-get install libappindicator1\n```\nthen depending on your system architecture either run\n\n```bash\nsudo dpkg -i Sandman_1.9.2_amd64.deb\n```\nOr:\n```bash\nsudo dpkg -i Sandman_1.9.2_x86.deb\n```\n#### RedHat\n```bash\nsudo rpm -i Sandman.rpm\n```\n This will actually install Sandman as a utility application which can be accessed from your respective distributions application launchpad.\n\n### Windows\n\n#### Scoops install\nIf you use scoops https://github.com/lukesampson/scoop\nYou can download and install sandman with\n```bash\nscoop buckets add extras\nscoop install sandman\n```\n#### Manual install\nDownload your respective architectures release from the downloads section.\n\nOpen up another windows explorer and navigate to your program files folder (x86 or 64 bit is irrelevant). Now drag the entire Sandman Windows folder you extracted from the downloaded zip in the previous step over to the program files folder. Go into the folder that was just dragged over and find the Sandman.exe and run it. Now the application will show up in the dock where it can be pinned.\n\n## Downloads\nTo get the full sourced version run in terminal:\n```bash\ngit clone https://github.com/alexanderepstein/Sandman\n```\n\nOtherwise to just get the application click the link before to head to the latest release page and download your respective platform.\n##### [Version 1.9.2 Release](https://github.com/alexanderepstein/Sandman/releases/tag/v1.9.2)\n\n\n## Uninstall\n\n### Mac\n\n#### Homebrew\n```bash\nbrew cask uninstall sandman\n```\n#### Manual uninstall\nGo to the applications folder and delete the Sandman application.\n\n### Linux\nOpen up a terminal and run:\n#### Debian\n\n```bash\nsudo dpkg --remove Sandman\n```\n#### RedHat\n\n```bash\nsudo rpm -e Sandman.rpm\n```\n\n### Windows\n\n#### Scoops\n```bash\nscoop uninstall sandman\n```\n\n#### Manual uninstall\nOpen up the program files folder and delete the Sandman folder.\n\n## Reviews Of Sandman\n\n\u003ca href=\"http://www.addictivetips.com/windows-tips/get-bed-time-alerts-based/\"\u003eAddictive Tips Review\u003c/a\u003e\n\n\u003ca href=\"http://www.softpedia.com/get/Desktop-Enhancements/Clocks-Time-Management/Insomnia.shtml\"\u003eSoftpedia Windows Review\u003c/a\u003e\n\n\u003ca href=\"http://mac.softpedia.com/get/Utilities/Epstein-Insomnia.shtml\"\u003eSoftpedia Mac Review\u003c/a\u003e\n\n\n## Helping Out\nIt is assumed you already have node installed and therefore npm.\n\nTo download the full source code and install the Dependencies run the following lines:\n```bash\ngit clone https://github.com/alexanderepstein/Sandman\ncd Sandman\nnpm install\ncd ..\nnpm start dev # this will run the application with all of the devtools open\n```   \n\nIf you get some error and the application wont run try running the following lines and see if that works.\n\n### Linux/Mac\n```bash\ncd Sandman\nsudo npm install -g\n```\n\n### Windows\nRight click on the start menu icon at the bottom left and click on the option to open a command prompt in developer mode\ncd to the Sandman directory then run\n```bash\nnpm install -g\n```\n### CSS Compilation\n\nThe app styling was made with: [Sass](http://sass-lang.com/) `v3.3.14`  [Ruby](https://www.ruby-lang.org/) `v2.3.1p112`.\n\n To compile the stylesheet you'll only need to run the following command:\n ```bash\n sass --watch scss:css --style compressed\n ```\n\n\n### To Compile Source To Application\n\n### Linux\nOpen a terminal to the Sandman directory\n```bash\ncd build\nchmod a+x linux.sh\n./linux.sh\n```\nThis will build installers for Debian 32/64 bit and Redhat linux in the build/dist/installers folder\n\n### Mac\nOpen a terminal to the Sandman directory\n```bash\ncd build\nchmod a+x mac.sh\n./mac.sh\n```\nThis will build a dmg in the build folder\n\n### Windows\nRight click on the start menu icon at the bottom left and click on the option to open a command prompt in developer mode\nthen run\n```bash\nnpm install -g electron-packager\n```\nThen once electron packager is installed to package your electron application open up a terminal and cd into the Sandman folder then run\n\nFor 64 Bit Binary:\n```bash\nelectron-packager . Sandman --platform win32 --arch x64 --out dist/\n```\nFor 32 Bit Binary\n```bash\nelectron-packager . Sandman --platform win32 --arch ia32 --out dist/\n```\n\n\n\nIf you have a feature you would like to add or optimizations to the original code\n* Feel free to fork this repository and submit a pull request\n* Add an issue labeled as an enhancement and if I think its a good idea I will do my best to implement it myself\n\n```bash\n( •_•)\n( •_•)\u003e⌐■-■\n(⌐■_■)\n```\n## Donate\nIf this project helped you in any way and you feel like buying a broke college kid a cup of coffee\n\n[![Donate](https://img.shields.io/badge/Donate-Venmo-blue.svg)](https://venmo.com/AlexanderEpstein)\n[![Donate](https://img.shields.io/badge/Donate-SquareCash-green.svg)](https://cash.me/$AlexEpstein)\n\n## License\n\nMIT License\n\nCopyright (c) 2017 Alex Epstein\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexanderepstein%2Fsandman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexanderepstein%2Fsandman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexanderepstein%2Fsandman/lists"}