{"id":15498288,"url":"https://github.com/parthjadhav/immat","last_synced_at":"2025-04-22T22:29:17.804Z","repository":{"id":51371943,"uuid":"365439598","full_name":"ParthJadhav/IMMAT","owner":"ParthJadhav","description":"iMessage Mac Automation Tool","archived":false,"fork":false,"pushed_at":"2021-06-10T05:43:42.000Z","size":1030,"stargazers_count":18,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T19:34:27.612Z","etag":null,"topics":["automation","control","imessage","ios","iphone","macos","macosapp","message","sms"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ParthJadhav.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-05-08T06:40:49.000Z","updated_at":"2024-12-07T23:01:10.000Z","dependencies_parsed_at":"2022-08-28T14:01:50.759Z","dependency_job_id":null,"html_url":"https://github.com/ParthJadhav/IMMAT","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/ParthJadhav%2FIMMAT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParthJadhav%2FIMMAT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParthJadhav%2FIMMAT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParthJadhav%2FIMMAT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ParthJadhav","download_url":"https://codeload.github.com/ParthJadhav/IMMAT/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250333682,"owners_count":21413435,"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":["automation","control","imessage","ios","iphone","macos","macosapp","message","sms"],"created_at":"2024-10-02T08:43:15.036Z","updated_at":"2025-04-22T22:29:17.761Z","avatar_url":"https://github.com/ParthJadhav.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IMMAT (iMessage Mac Automation Tool)\n\n\u003c!--- These are examples. See https://shields.io for others or to customize this set of shields. You might want to include dependencies, project status and licence info here ---\u003e\n![GitHub contributors](https://img.shields.io/github/contributors/ParthJadhav/IMMAT)\n![GitHub stars](https://img.shields.io/github/stars/ParthJadhav/IMMAT)\n![GitHub repo issues](https://img.shields.io/github/issues/ParthJadhav/IMMAT?label=issues)\n\nIMMAT is a tool developed to control the MacOS operating system using iMessage from any iMessage supported devices.\n\nIMMAT is created using Python and AppleScript.\n\n## 🔖 Prerequisites\n\nBefore you begin, ensure you have met the following requirements:\n\u003c!--- These are just example requirements. Add, duplicate or remove as required ---\u003e\n* You have installed Python3 and have it working.\n* You have a MacOS machine which has used iMessage on it atleast once.\n* Any iMessage supported device.\n* Installed the dependencies from requirements.txt.\n\n## 📦 Using IMMAT Through Executable (Recommended)\n\nTo Use IMMAT download the file by :-\n\n[Clicking Here !](https://drive.google.com/uc?export=download\u0026id=1RnxwMt9TH0rgXC9NZvk-Wg2JilLhGofb)\n\nOpen Terminal and type :-\n```\nchmod +x (Drag the file here and press enter)\n```\n\nNow you can run IMMAT by opening the file.\n\n## 🐍 Using IMMAT Through Python\n\nTo install IMMAT, follow these steps:\n\nInstalling requirements :-\n```\ngit clone https://github.com/ParthJadhav/IMMAT.git\n\ncd IMMAT\n\npip3 install -r requirements.txt\n```\nFor Bluetooth Functionality to Work\n```\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n\nbrew install blueutil\n```\n\nRunning IMMAT (Foreground) :\n\n❗️It is mandatory that you run it in foreground at first run.❗\n```\npython3 Immat.py\n```\n\nRunning IMMAT (Background) :-\n```\ncd IMMAT\n\nchmod +x Immat.py\n\nnohup python3 /path/to/Immat.py \u0026\n```\nTo stop the background process:-\n```\npkill -f Immat.py\n```\n\n## 🔨 Troubleshooting\n\nIf you are encountering errors like :- \n\n```\nsqlite3.OperationalError: unable to open database file\n```\n\nThen try giving full disk access to the terminal by :-\n\nhttps://support.avast.com/en-in/article/Mac-full-disk-access/\n\nInstead of avast add Terminal to full-disk access.\n\n## 🦋 Usage\n\nIMMAT will only be running on Mac the commands would be given from iMessage on other devices.\n\nExample - \n\nPassword - $\\\nCommand - ts (Take Screenshot)\n\nMessage the below command through iMessage to Mac.\n```\n$ Ts\n```\n\nThis will reply you with the screenshot of the Mac.\n\nThese are the available commands :-\n\n\u003cimg width=\"467\" alt=\"Help\" src=\"https://github.com/ParthJadhav/IMMAT/blob/master/resources/Help.png?raw=true\"\u003e\n\n## 💻 MacOS Demo\n\nInstead of main.py enter Immat.py\n\n\u003cimg width=\"467\" alt=\"Help\" src=\"https://user-images.githubusercontent.com/42001064/117545382-30071500-b043-11eb-8586-35e49c7a7489.GIF\"\u003e\n\n## 📱 iPhone Demo\n\u003cimg width=\"467\" alt=\"Help\" src=\"https://user-images.githubusercontent.com/42001064/117545641-4366b000-b044-11eb-9227-0ece0ee45303.gif\"\u003e\n\n## 💠 How does it work?\n\niMessage on MacOS saves all messages it got to **chat.db** database. and the messages are saved in messages table of that database.\n\nWhenever a new message is received; IMMAT checks if it has the password which you have entered while running IMMAT and checks for a matching command.\n\nIf the message matches the command then the following function is executed. \n\nAll of these happens locally so there is no need to worry about the privacy and security.\n\n## 📝 Contact\n\nIf you want to contact me you can reach me at Jadhavparth99@gmail.com\n\n## 📄 License\n\u003c!--- If you're not sure which open license to use see https://choosealicense.com/---\u003e\n\nThis project uses MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparthjadhav%2Fimmat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparthjadhav%2Fimmat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparthjadhav%2Fimmat/lists"}