Telegram integration plugin for chatwire
Project description
chatwire-telegram
Telegram integration plugin for chatwire — the macOS iMessage relay bridge.
Renders inbound iMessage events into a single Telegram chat with From <name>: prefixes, and turns Telegram messages back into outbound iMessage sends (replies, /send, /<contact-slug>, photo uploads, inline whitelist search).
Requirements
- chatwire >= 0.7.0 (installed and configured on macOS)
- Python >= 3.10
- A Telegram bot token from @BotFather
Install
# If chatwire is managed via pipx:
pipx inject chatwire chatwire-telegram
# Otherwise:
pip install chatwire-telegram
Configure
Add to your config.json under integrations.telegram:
{
"integrations": {
"telegram": {
"enabled": true,
"bot_token": "123456:abc...",
"allowed_user_ids": [12345678]
}
}
}
The first allowed_user_id is the delivery target — all relayed iMessage events are sent to that Telegram chat.
Enable inline mode on your bot via BotFather (/setinline) for the whitelist search typeahead to work.
Bot commands
| Command | Description |
|---|---|
/start |
Help / status |
/whoami |
Show your Telegram user_id and chat_id |
/handles |
Show relay scope (SELF handles + whitelist) |
/refresh_contacts |
Reload Contacts.app lookup |
/mute <duration> |
Silence relay (e.g. 30m, 2h, 1d) |
/unmute |
Resume relay |
/send <handle> <body> |
Send an iMessage |
/whitelist |
List whitelisted handles and groups |
/whitelist_add <handle or name> |
Add to whitelist |
/whitelist_remove <handle or name> |
Remove from whitelist |
/check [handle or name] |
Show iMessage/SMS capability |
/<slug> |
Select a contact or group as sticky target |
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file chatwire_telegram-0.1.0.tar.gz.
File metadata
- Download URL: chatwire_telegram-0.1.0.tar.gz
- Upload date:
- Size: 19.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6f9cbc1c275176f003a8da7ebbbc14ecacb8a3d79f49a1ae38e421f704786623
|
|
| MD5 |
26847344dbd092cba047558889fd474d
|
|
| BLAKE2b-256 |
2ab3b1a3f1193b1117920991d1745d4f95a6d83c03b57f47c486fea7d81e7dc9
|
Provenance
The following attestation bundles were made for chatwire_telegram-0.1.0.tar.gz:
Publisher:
publish.yml on allenbina/chatwire-telegram
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
chatwire_telegram-0.1.0.tar.gz -
Subject digest:
6f9cbc1c275176f003a8da7ebbbc14ecacb8a3d79f49a1ae38e421f704786623 - Sigstore transparency entry: 1464216598
- Sigstore integration time:
-
Permalink:
allenbina/chatwire-telegram@9de1618b9151420d6c401222d14b7d57a1638172 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/allenbina
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@9de1618b9151420d6c401222d14b7d57a1638172 -
Trigger Event:
push
-
Statement type:
File details
Details for the file chatwire_telegram-0.1.0-py3-none-any.whl.
File metadata
- Download URL: chatwire_telegram-0.1.0-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f14f91db25e2f1de958c54754cbacc6037cb5ca4a2000543960b842f7e05c620
|
|
| MD5 |
a7f979f9cd6650ac6b06eb64f738a273
|
|
| BLAKE2b-256 |
b3215741b956180b410ec4074c4125542705e78bbe54518fc62051b3f3361db3
|
Provenance
The following attestation bundles were made for chatwire_telegram-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on allenbina/chatwire-telegram
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
chatwire_telegram-0.1.0-py3-none-any.whl -
Subject digest:
f14f91db25e2f1de958c54754cbacc6037cb5ca4a2000543960b842f7e05c620 - Sigstore transparency entry: 1464216795
- Sigstore integration time:
-
Permalink:
allenbina/chatwire-telegram@9de1618b9151420d6c401222d14b7d57a1638172 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/allenbina
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@9de1618b9151420d6c401222d14b7d57a1638172 -
Trigger Event:
push
-
Statement type: