Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CamHenlin/imessagebot
Who wouldn't want to iMessage a bot?
https://github.com/CamHenlin/imessagebot
Last synced: 3 months ago
JSON representation
Who wouldn't want to iMessage a bot?
- Host: GitHub
- URL: https://github.com/CamHenlin/imessagebot
- Owner: CamHenlin
- Created: 2015-03-13T06:30:07.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T21:48:49.000Z (about 2 years ago)
- Last Synced: 2024-08-02T15:51:19.968Z (6 months ago)
- Language: JavaScript
- Size: 383 KB
- Stars: 92
- Watchers: 9
- Forks: 7
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- project-awesome - CamHenlin/imessagebot - Who wouldn't want to iMessage a bot? (JavaScript)
README
# iMessage Bot for Mac OS X
## requirements:
- nodejs
- Apple iMessages account signed in to Messages.app
## How to run on your Mac:
Firstly, at the very minimum, you will have to enable assistive access to Terminal.app or iTerm2. If you want to run this over ssh, you will also need to enable access to sshd-keygen-wrapper. Next:
```bash
git clone https://github.com/CamHenlin/imessagebot.git
cd imessagebot
npm install
create .env and add necessary env variables
node app
```
## How to use:
Send an iMessage to the logged in iMessage account, or add the account to an existing group chat.
The bot will then respond to a list of commands:
- ```.g some search term``` will search for "some search term" in google, and return the first result to the chat
- ```.t some search term``` will search twitter for "some search term", and return the first result to the chat (twitter api key must be set up at top of app.js)
- ```.follow @some username``` will follow @some username on twitter
- ```.fav link to some tweet``` will fav a link to some tweet
- ```.tweet some text``` will tweet some text (twitter api key must be set up at top of app.js)
- ```.twimg some text``` will tweet some text AND the last image sent in the current chat (twitter api key must be set up at top of app.js)
- ```.reply somestatusurl @someperson some text``` will a reply to @someperson's somestatusurl some text (twitter api key must be set up at top of app.js)
- ```.wea some location``` will return the weather for "some location" to the chat
- ```.u some text``` will look up some text on urbandictionary
- ```.i some imessage address some text``` will send an iMessage directly to some imessage address with the contents some text
- the bot will also check the title of any web page that has its url pssted into the chat
- the bot will also report status updates that mention the user set on line 57 if the twitter api keys are set up.
`Note: Sometimes using AppleScript to send iMessages can be unreliable and cause an error dialog to pop up in Messages.app, which will in turn prevent future messages from being sent. If you suspect this has happened, you can send the message '.r', which will cause the bot to attempt to clear error messages in Messages.app.`
## This is clunky!
It seems to me that there is a way to access private APIs within OS X to send messages without the use of Messages.app, but I haven't figured out how to do so yet. Maybe you can help out and contribute? You can make this less clunky by helping out with this project [nodeprivatemessageskit](https://github.com/camhenlin/nodeprivatemessageskit)
## Why did you make this?
To get more people interested in hacking around with iMessages! This project is much more simple than the other iMessages projects listed below, and is more accessible for people to hack on and extend!
Based on code from: [iMessageWebClient](https://github.com/CamHenlin/iMessageWebClient)
And: [iMessageClient](https://github.com/CamHenlin/imessageclient)
Uses [iMessageModule](https://github.com/CamHenlin/iMessageModule).
