imsg 0.1.0

Linux CLI for accessing an iPhone over Bluetooth — messages, contacts, and notifications via MAP and PBAP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# imsg

Linux CLI for accessing an iPhone over Bluetooth — read and send messages
(SMS, MMS, iMessage), browse contacts, and stream live notifications.
Uses MAP (Message Access Profile) and PBAP (Phone Book Access Profile).
No Mac required.

> **Early development** — not yet ready for general use.

## Features

- List, read, and send messages (SMS, MMS, iMessage)
- Browse and search contacts / phonebook
- Reverse lookup a phone number to a contact name
- Stream live message notification events (`watch`)

## Usage

```bash
imsg config set-device <IPHONE_MAC>

imsg list
imsg list --unread
imsg get <handle>
imsg send <number> "hello"

imsg contacts --list
imsg contacts --lookup "+14085551234"

imsg watch
```

## Status

Core commands work. Persistence, local encryption, and full notification
support are in progress.

## License

MIT