{"id":19637076,"url":"https://github.com/timothymiller/imessage-scheduler","last_synced_at":"2025-10-07T18:08:28.707Z","repository":{"id":111391954,"uuid":"216403578","full_name":"timothymiller/iMessage-scheduler","owner":"timothymiller","description":" Finally a free iMessage scheduler that just works.","archived":false,"fork":false,"pushed_at":"2019-12-06T19:24:33.000Z","size":24,"stargazers_count":16,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-05T08:04:34.596Z","etag":null,"topics":["app","es6","imessage","imessage-apps","imessage-bot","javascript","messaging","messaging-services","node","node-scheduler","react","scheduler","self-hosted","texting","web","web-app","yarn"],"latest_commit_sha":null,"homepage":"https://timknowsbest.com/free-imessage-scheduler","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timothymiller.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["timothymiller"],"patreon":"timknowsbest","custom":["https://timknowsbest.com/donate"]}},"created_at":"2019-10-20T17:55:26.000Z","updated_at":"2025-02-02T10:18:49.000Z","dependencies_parsed_at":"2023-03-13T13:41:11.398Z","dependency_job_id":null,"html_url":"https://github.com/timothymiller/iMessage-scheduler","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothymiller%2FiMessage-scheduler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothymiller%2FiMessage-scheduler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothymiller%2FiMessage-scheduler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timothymiller%2FiMessage-scheduler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timothymiller","download_url":"https://codeload.github.com/timothymiller/iMessage-scheduler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251284880,"owners_count":21564688,"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":["app","es6","imessage","imessage-apps","imessage-bot","javascript","messaging","messaging-services","node","node-scheduler","react","scheduler","self-hosted","texting","web","web-app","yarn"],"created_at":"2024-11-11T12:33:06.279Z","updated_at":"2025-10-07T18:08:28.702Z","avatar_url":"https://github.com/timothymiller.png","language":"JavaScript","funding_links":["https://github.com/sponsors/timothymiller","https://patreon.com/timknowsbest","https://timknowsbest.com/donate"],"categories":[],"sub_categories":[],"readme":"# :iphone: iMessage Scheduler\n\nOne of the last remaining features Android phones have which has no iOS equivalent is scheduled text messages. Samsung phones have this feature built into the stock texting app. While iOS 13 brings capabilities for scheduled automation, the Messages app remains secluded in the walled garden.\n\n## :hamburger: Tech Stack\n\n- Node.js\n- Yarn\n- ES6\n\n## :wrench: How it works\n\nEdit contacts.txt with one contact per line using the following csv format.\n\n```plain text\nfull name,phone number,birthday eg. MM-DD,time zone eg. America/New_York,group name eg. associate\n```\n\nAn example value would look like this\n\n```plain text\nchad brad,12345678901,01-15,America/New_York,associate\n```\n\nEdit events.txt with one event per line using the following csv format.\n\n```plain text\nevent date eg. MM-DD,message,timeOfDay (see types in Events.js),target group name\n```\n\nAn example value would look like this\n\n```plain text\n12-25,Merry Christmas! 🎄,morning,associate\n```\n\n## :running: Running\n\nInstructions on running, including disabling SIP can be [found here](https://timknowsbest.com/free-imessage-scheduler)\n\n## :construction: Roadmap\n\nThis scheduler currently supports recurring dates only. This does not support holidays like Thanksgiving, Easter, Memorial Day (last day in May), Mother's Day or Father's Day.\nReact frontend for scheduling messages from a web browser.\n\n## :clap: Special Thanks\n\n- [osa-imessage](https://www.npmjs.com/package/osa-imessage)\n- [node-scheduler](https://github.com/node-schedule/node-schedule)\n\n## Disclaimer\n\nThis open source project is an independent project and has not been authorized, sponsored, or otherwise approved by Apple Inc.\n\niMessage, iOS, Mac, El Capitan, and Apple are registered trademarks of Apple Inc.\n\n## License \n\nThis Template is licensed under the [GNU General Public License, version 3 (GPLv3)](http://www.gnu.org/licenses/gpl-3.0.html) and is distributed free of charge.\n\n## Author\n\nTimothy Miller\n\n* GitHub: [https://github.com/timothymiller](https://github.com/timothymiller) :bulb:\n\n* Website: [https://timknowsbest.com](https://timknowsbest.com) :computer:\n\n* Donation: [https://timknowsbest.com/donate](https://timknowsbest.com/donate) :money_with_wings:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimothymiller%2Fimessage-scheduler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimothymiller%2Fimessage-scheduler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimothymiller%2Fimessage-scheduler/lists"}