SPlusthon
SPlusthon is an asyncio Python 3 MTProto library to interact with Soroush Plus’s API as a user or through a bot account (bot API alternative).
SPlusthon is a fork of Telethon adapted to work with the Soroush Plus messenger. It uses Soroush-specific TL schema (layer 182), DC routing, RSA keys, and WebSocket transport.
What is this?
Soroush Plus is a popular messaging application. This library is meant to make it easy for you to write Python programs that can interact with Soroush Plus. Think of it as a wrapper that has already done the heavy job for you, so you can focus on developing an application.
Installing
pip3 install splusthonCreating a client
SPlusthon includes default API credentials for Soroush Plus, so you can create a client without obtaining your own keys:
from splusthon import SoroushClient, events, sync
from splusthon.sessions import StringSession
# No api_id or api_hash needed - defaults are included
client = SoroushClient(StringSession())
client.start()Doing stuff
print(client.get_me().stringify())
client.send_message('username', 'Hello! Talking to you from SPlusthon')
client.send_file('username', '/home/myself/Pictures/holidays.jpg')
client.download_profile_photo('me')
messages = client.get_messages('username')
messages[0].download_media()
@client.on(events.NewMessage(pattern='(?i)hi|hello'))
async def handler(event):
await event.respond('Hey!')Using an existing session
If you have a saved session string, you can restore it:
from splusthon import SoroushClient
from splusthon.sessions import StringSession
session_string = '1AwA...' # from a previous run
with SoroushClient(StringSession(session_string)) as client:
print(client.get_me())Links
Soroush Plus: https://web.splus.ir
1 maintainer
Metadata
1 maintainer
Release files for SPlusthon 1.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| splusthon-1.1.4.tar.gz | 575.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| splusthon-1.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.2 MB
Release files / splusthon-1.1.4.tar.gz
| Download URL | splusthon-1.1.4.tar.gz |
|---|---|
| Size | 575.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bd5d7068863b26fbc679ffe1ea32c8a9f679500348c2583e2ce5d3937a6d4c16
|
|
BLAKE2b-256 checksum How to use checksums |
5df790d286a4fb014a784eca7e5c74eb83ef34feae1af5919e5c460d34ce2309
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 12, 2026.
Transparency logRelease files / splusthon-1.1.4-py3-none-any.whl
| Download URL | splusthon-1.1.4-py3-none-any.whl |
|---|---|
| Size | 651.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ce5630fd298fa9ef5bca145b00b2aaf79a3c6f117dc2f3538e1d4a1f218a459f
|
|
BLAKE2b-256 checksum How to use checksums |
c459459ffd0ebb3e9dc9a27e9cf058d93528ba1d81fde9cc54601565ff5ac5fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 12, 2026.
Transparency log
