Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chatwire_telegram-0.1.0.tar.gz (19.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chatwire_telegram-0.1.0-py3-none-any.whl (15.8 kB view details)

Uploaded Python 3

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

Hashes for chatwire_telegram-0.1.0.tar.gz
Algorithm Hash digest
SHA256 6f9cbc1c275176f003a8da7ebbbc14ecacb8a3d79f49a1ae38e421f704786623
MD5 26847344dbd092cba047558889fd474d
BLAKE2b-256 2ab3b1a3f1193b1117920991d1745d4f95a6d83c03b57f47c486fea7d81e7dc9

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatwire_telegram-0.1.0.tar.gz:

Publisher: publish.yml on allenbina/chatwire-telegram

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chatwire_telegram-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for chatwire_telegram-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f14f91db25e2f1de958c54754cbacc6037cb5ca4a2000543960b842f7e05c620
MD5 a7f979f9cd6650ac6b06eb64f738a273
BLAKE2b-256 b3215741b956180b410ec4074c4125542705e78bbe54518fc62051b3f3361db3

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatwire_telegram-0.1.0-py3-none-any.whl:

Publisher: publish.yml on allenbina/chatwire-telegram

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page