Initial Commit

README.md

@@ -0,0 +1,19 @@
+# ChatterBox
+
+Chatterbox allows users to set up a web interface into their iMessages.
+
+## Setup
+- Make sure your `/Users/<USERNAME>/Library/Messages/{chat.db,chat.db-wal}` files are all-readable, and the folders above it are all read/execute-able.
+- Enable Apache and PHP
+- Set the `CHAT_DB_SRC` and `ADDR_DB_SRC` variables in `chatterbox.php`
+- Move this all into `/Library/WebServer/Documents` (or test it out with the PHP standalone server)
+
+## Limitations
+This is honestly a pretty insecure implementation of a web server, so please use at your own risk
+- There's no authentication
+- There's no SSL/encryption
+- It requires all execute/read permissions on your chat and address book databases
+
+Additionally, there's no functionality yet to send messages or view attachments. I'm working on that part. AppleScript is just so atrocious to work with.
+
+This works well for hosting an OSX VM on a local network, so I can use a Windows or Linux box and still have a real screen to read messages on. I'm hoping to set it up to send messages and view attachments to further limit the number of times I have to take my phone out of my pocket or type using my thumbs. `DO NOT USE THIS ON INTERNET-FACING SYSTEMS`