py-tgcalls 2.1.0rc6__py3-none-any.whl → 2.1.1__py3-none-any.whl

py_tgcalls-2.1.1.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: py-tgcalls
+Version: 2.1.1
+Summary: Async client API for the Telegram Calls.
+Author-email: Laky-64 <iraci.matteo@gmail.com>
+Project-URL: Homepage, https://pytgcalls.github.io/
+Project-URL: Repository, https://github.com/pytgcalls/pytgcalls.git
+Project-URL: Documentation, https://pytgcalls.github.io/PyTgCalls
+Project-URL: Changelog, https://pytgcalls.github.io/PyTgCalls/Changelogs
+Keywords: audio,python,library,video,telegram,stream,ffmpeg,cpp,webrtc,voice-chat,voip,group-chat,video-calls,calls,video-chat,pytgcalls,ntgcalls,tgcalls,py-tgcalls,pyrogram,telethon,hydrogram
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9.3
+Requires-Dist: ntgcalls<1.4.0,>=1.3.2
+Requires-Dist: deprecation
+Provides-Extra: pyrogram
+Requires-Dist: pyrogram>=1.2.20; extra == "pyrogram"
+Provides-Extra: telethon
+Requires-Dist: telethon>=1.24.0; extra == "telethon"
+Provides-Extra: hydrogram
+Requires-Dist: hydrogram>=0.1.4; extra == "hydrogram"
+Dynamic: license-file
+
+<img src="https://raw.githubusercontent.com/pytgcalls/pytgcalls/master/.github/images/banner.png" alt="pytgcalls logo" />
+<p align="center">
+    <b>A simple and elegant client that allows you to make group voice calls quickly and easily.</b>
+    <br>
+    <a href="https://github.com/pytgcalls/pytgcalls/tree/master/example">
+        Examples
+    </a>
+    •
+    <a href="https://pytgcalls.github.io/">
+        Documentation
+    </a>
+    •
+    <a href="https://pypi.org/project/py-tgcalls/">
+        PyPi
+    </a>
+    •
+    <a href="https://t.me/pytgcallsnews">
+        Channel
+    </a>
+    •
+    <a href="https://t.me/pytgcallschat">
+        Chat
+    </a>
+</p>
+
+# PyTgCalls [![PyPI](https://img.shields.io/pypi/v/py-tgcalls.svg?logo=python&logoColor=%23959DA5&label=pypi&labelColor=%23282f37)](https://pypi.org/project/py-tgcalls/) [![Downloads](https://img.shields.io/pepy/dt/py-tgcalls?logoColor=%23959DA5&labelColor=%23282f37&color=%2328A745)](https://pepy.tech/project/py-tgcalls)
+This project allows making Telegram call using MtProto and WebRTC, this is possible thanks to the power of [NTgCalls] library and [@evgeny-nadymov]
+
+#### Example Usage
+```python
+from pytgcalls import PyTgCalls
+from pytgcalls import idle
+...
+chat_id = -1001185324811
+app = PyTgCalls(client)
+app.start()
+app.play(
+    chat_id,
+    'http://docs.evostream.com/sample_content/assets/sintel1m720p.mp4',
+)
+idle()
+```
+
+## Features
+- Prebuilt wheels for macOS, Linux and Windows.
+- Supporting all type of MTProto libraries: Pyrogram, Telethon and Hydrogram.
+- Work with voice chats in channels and chats.
+- Join as channels or chats.
+- Mute/unmute, pause/resume, stop/play, volume control and more...
+
+## Requirements
+- Python 3.9 or higher.
+- An MTProto Client
+- A [Telegram API key](https://docs.pyrogram.org/intro/setup#api-keys).
+
+## How to install?
+Here's how to install the PyTgCalls lib, the commands are given below:
+
+``` bash
+# With Git
+pip install git+https://github.com/pytgcalls/pytgcalls -U
+
+# With PyPi (Recommended)
+pip install py-tgcalls -U
+```
+
+## Key Contributors
+* <b><a href="https://github.com/Laky-64">@Laky-64</a> (DevOps Engineer, Software Architect):</b>
+    * Played a crucial role in developing PyTgCalls being an ex developer of pyservercall and of tgcallsjs.
+    * Automation with GitHub Actions
+* <b><a href="https://github.com/kuogi">@kuogi</a> (Senior UI/UX designer, Documenter):</b>
+    * As a Senior UI/UX Designer, Kuogi has significantly improved the user interface of our documentation,
+      making it more visually appealing and user-friendly.
+    * Played a key role in writing and structuring our documentation, ensuring that it is clear,
+      informative, and accessible to all users.
+* <b><a href="https://github.com/vrumger">@vrumger</a> (Senior Node.js Developer, Software Architect):</b>
+    * Has made important fixes and enhancements to the WebRTC component of the library,
+      improving its stability and performance.
+    * Main developer of TgCallsJS
+* <b><a href="https://github.com/alemidev">@alemidev</a> (Senior Python Developer):</b>
+    * Has made important fixes and enhancements to the async part of the library
+
+## Junior Developers
+* <b><a href="https://github.com/TuriOG">@TuriOG</a> (Junior Python Developer):</b>
+    * Currently working on integrating NTgCalls into <a href="//github.com/pytgcalls/pytgcalls">PyTgCalls</a>, an important step
+      in expanding the functionality and usability of the library.
+
+## Special Thanks
+* <b><a href="https://github.com/evgeny-nadymov">@evgeny-nadymov</a>:</b>
+  A heartfelt thank you to Evgeny Nadymov for graciously allowing us to use their code from telegram-react.
+  His contribution has been pivotal to the success of this project.
+
+[NTgCalls]: https://github.com/pytgcalls/ntgcalls
+[@evgeny-nadymov]: https://github.com/evgeny-nadymov/

{py_tgcalls-2.1.0rc6.dist-info → py_tgcalls-2.1.1.dist-info}/RECORD

@@ -1,17 +1,19 @@
+py_tgcalls-2.1.1.dist-info/licenses/LICENSE,sha256=46mU2C5kSwOnkqkw9XQAJlhBL2JAf1_uCD8lVcXyMRg,7652
 pytgcalls/__init__.py,sha256=qbfwN7rYwIdCegMOzdcbvwazeNjDzgmowgcqLFNqKIM,308
-pytgcalls/__version__.py,sha256=YPyxmR-EFTwh_mR4LTWTXvH2TQx_pd59MwELo1AmjgI,26
+pytgcalls/__version__.py,sha256=Aht2295j8FswZ-nPYofCYr3fBZ6Uyf0thTfl5Oc2mWA,22
 pytgcalls/environment.py,sha256=ctCHACvG6l8SdpPewSBhOvc70kbwpv18maC0TwLvZ08,1924
-pytgcalls/exceptions.py,sha256=dBKyH--HyEJk6-DzfzXvG3M1fuDSRuF2LWu7XKhV-WY,4263
+pytgcalls/exceptions.py,sha256=CoYSQAzRWIkyJVpHw8Q4zUhM9Sh3uwm6-1AB5ks_2iU,3924
 pytgcalls/ffmpeg.py,sha256=tm6DBxyNfPh3h3an-b2s9x1UyX-cvkCdov9prlXxVZY,8649
 pytgcalls/filters.py,sha256=qTFDlt-23xnMh_Ug2WmmOUf13JPX6_yacrv7c3F9Pp0,6125
 pytgcalls/mtproto_required.py,sha256=6B-31p5qH_6oekUgypV4nK3hqPS6Nr-pA8S81wjnbaY,630
-pytgcalls/mutex.py,sha256=Frjji5Ctzlk4AXEBuBLnDK-7HbtreoV6zuyKpFpMNI4,236
-pytgcalls/pytgcalls.py,sha256=oBcWgBwusnXmjHrLEE99VVXARReVyrXdn9SyeBWHbVo,1479
+pytgcalls/mutex.py,sha256=6hOwGnUTNUJliJ1GGhk47D0A3KEn8eVd-kjZq_1DdZY,670
+pytgcalls/pytgcalls.py,sha256=DxCE0--mb53vyDXLLBAwy1cPrJgLsyC9rba_h2OzR2o,1608
 pytgcalls/pytgcalls_session.py,sha256=_BGJWvf7t3mki2DhlEPjh9cypvYuSFkMSxzTsfepwUk,2719
 pytgcalls/scaffold.py,sha256=SwePuT9V8LdOFy0KRlAnRSbsB2zeGQ4fs9ilrq7HZYI,1353
 pytgcalls/statictypes.py,sha256=CdlqgQNhTZ_uTE8-B8m01fJ7TlD2B42EI2QBPxDdAtA,3842
 pytgcalls/sync.py,sha256=IsOH3TD7cxUg_-zdGt12HoS8sBlXvcGayPZAoxxKM48,3396
 pytgcalls/version_manager.py,sha256=egeGgvb66zWlLTMuw2U-b0x8MfnRzMm1xAEVN87HF5c,296
+pytgcalls/wait_counter_lock.py,sha256=J-KCWUBCt7ktKQKyIseNG0RfXDVRh-h0wKhaZlf4aFs,437
 pytgcalls/ytdlp.py,sha256=jRA-mKQEXleWvaoGv9wtMa77aRjxsyQxn6_0tXI3-sA,2435
 pytgcalls/custom_api/__init__.py,sha256=ZT8d0lc2YrDuw_YSFAXXHHMewoXGFZ-ANOBIAr0vGFQ,60
 pytgcalls/custom_api/custom_api.py,sha256=Ko3aS6psrwPmOhRPxvG0fepXt4STrA0StvINSxz4Cj8,1890
@@ -27,14 +29,14 @@ pytgcalls/methods/__init__.py,sha256=hk1blAT5u_Isemdrg0nqInLsdRzTTZnak5NdAfkBPAk
 pytgcalls/methods/calls/__init__.py,sha256=xg4DZZClEnxwaj-DAq3e8gSR-g-MiYBdUEBth64lSXA,214
 pytgcalls/methods/calls/change_volume_call.py,sha256=xMUszg44Gs1RgTXGCwcWEESnwu3XVkW8Kx9HGLDGSEo,842
 pytgcalls/methods/calls/get_participants.py,sha256=HDEMwZwNZM7KSb76P5XVH46qNONvBEVg4x_e-rgJscI,716
-pytgcalls/methods/calls/leave_call.py,sha256=ay07za5mNKmXGzmpeU6gJJmHVrLeXRtRmFT4QP94pGA,1475
+pytgcalls/methods/calls/leave_call.py,sha256=Q7v0xT_CjbMIUBrugtvKbZqbSgmw5laMQYVhrMcaD1U,1475
 pytgcalls/methods/decorators/__init__.py,sha256=TCGaEVZnHjtOwv-3PNfaCVm0kyFhJApUPUNntt6MwyM,78
 pytgcalls/methods/decorators/on_update.py,sha256=ZTL4YcQk0N4Ru56a5WItUvkSN5SAqr6_RDZvXmZMIHs,316
 pytgcalls/methods/stream/__init__.py,sha256=mAcOih0-NT6T_Gspej6mySpJNPuEe46sUwgKV3vSvYM,336
 pytgcalls/methods/stream/mute.py,sha256=ZrZS_EeNUeUxb6UgbdhwXUdRX826u-qSjH5a6sg7LsE,557
 pytgcalls/methods/stream/pause.py,sha256=-kNvWQuv5VlssNcL-M6rkT5TKFmXlbOzJrDny95qsUc,560
-pytgcalls/methods/stream/play.py,sha256=-Ld5TQWLhU_ktKrb7q1Xrym36UGrWhaenIbjj-3mM3k,7524
-pytgcalls/methods/stream/record.py,sha256=28mFK2azDv6gUziwcj4ybvrYka9P9VXnUXnuAa1aQ5w,1466
+pytgcalls/methods/stream/play.py,sha256=vMmGgqhbHU_N6khfAa3ztil7wFuz_JmhjYTmMGV5CyM,7666
+pytgcalls/methods/stream/record.py,sha256=p9td2tZ4-QMpY8I8LDc1PrFVN3g-vlDINF5I7CmLsvA,1567
 pytgcalls/methods/stream/resume.py,sha256=AUHU3AtpXO2rtp2V1EKSC_KAWTk2KHMiHaqHluYy31M,563
 pytgcalls/methods/stream/send_frame.py,sha256=Kj9R8OqUM-g7pt-FiWP-US7sCFkH5ciPr9S8v-WPtLg,1062
 pytgcalls/methods/stream/time.py,sha256=65Hc5pQaN6z6nxgwT9Zxgsnl_UosvMkcICqE2hisNWA,659
@@ -45,21 +47,21 @@ pytgcalls/methods/utilities/call_holder.py,sha256=MhIbwCG6DROd9_bHGa6aqu-rB0y4sn
 pytgcalls/methods/utilities/compose.py,sha256=Nzdv8orMmka5NIBZ1SW1nsqXRzArZl4m6FdZU7syaR4,334
 pytgcalls/methods/utilities/cpu_usage.py,sha256=Mbga4MFCIwuh7WC8sqBbv1Pa6ALcp5AIDyfYMH_Bix4,162
 pytgcalls/methods/utilities/idle.py,sha256=MDdzHTv1ws2yBhsvhBUnssGdghkZ2KwR0HUCPOwV38o,814
-pytgcalls/methods/utilities/join_presentation.py,sha256=HLpVjhDkbMB6mIsCwdaGy-Ct7IaV44fM5-zOQ9M7bLU,1551
+pytgcalls/methods/utilities/join_presentation.py,sha256=gvxmFVzf6xsQZ4bPOz5wK8oZ0up1QD0DB2HpO5JcpGw,1671
 pytgcalls/methods/utilities/log_retries.py,sha256=6nD9J3350t82I0PKzK1pVx3ZaCBHATReiXYMs3PuVhQ,342
 pytgcalls/methods/utilities/ping.py,sha256=hhIMSHk2BzMB-IKpwLdZFVrsEvGm2ftJwKLs1k4anh8,244
 pytgcalls/methods/utilities/resolve_chat_id.py,sha256=92x2LHbUlnJMm-kS3fXOYmzYpY2TZbqtQD2rw3eBXDY,382
 pytgcalls/methods/utilities/run.py,sha256=cnYQd2xB5Cr_WS0Q2cXJZPGiN6JOCULzj1r4xXVyrlg,152
-pytgcalls/methods/utilities/start.py,sha256=Qc-uP9B6fgHtNOfjKJfgtYnWTY8JeIb6PSLmWPFXLOk,14376
-pytgcalls/methods/utilities/stream_params.py,sha256=OE673Bt1CiyCBFQGMPtC05zv3nObP3zirrh4OD9USdg,3109
+pytgcalls/methods/utilities/start.py,sha256=F6Jkq1R8dRm5yRAPGETbgL9A2QORc66nFYc-snoDiCk,14736
+pytgcalls/methods/utilities/stream_params.py,sha256=fOSloo1A7WTxaZEtOiPXjdexMeoJjq8CZtfHuIFX7Ns,3325
 pytgcalls/methods/utilities/update_sources.py,sha256=ISF6u3rk4IcVrPOEOB-uZUDfnwUp2_y1_2g9GboXpWM,1562
 pytgcalls/mtproto/__init__.py,sha256=X4zvzFG7km7qHyE0fdvA550WcOVO_xl_p__gvIfDGmw,130
-pytgcalls/mtproto/bridged_client.py,sha256=hktnfpfBK7PEL2n7Y0kBZzI7dkLlsdrDwkYliZki8zQ,5915
+pytgcalls/mtproto/bridged_client.py,sha256=oXPEv7pFAgW1PKq__4HS0f-OuNUzE-D3tzmuo2FmRSs,5943
 pytgcalls/mtproto/client_cache.py,sha256=Mt0827e_T8DXJHOTkXhkIQUT9EUBWjoLcFcXP1gBnZY,5973
-pytgcalls/mtproto/hydrogram_client.py,sha256=SbyLIffnexzI6xuSkpqzChT70xGXwti_c5sjKUZFqwQ,23031
-pytgcalls/mtproto/mtproto_client.py,sha256=1C1Cc1GOrKom-70NqUOICKxjfjgpPZBSdKdwFUjZzBc,7616
-pytgcalls/mtproto/pyrogram_client.py,sha256=GFt_2QoSEuRaIkUziZOnpBj8zEPiDGs55IriHU0jXwI,23213
-pytgcalls/mtproto/telethon_client.py,sha256=L91_Zxud-pvtJy36fBi6daowNV2qPZHUEp5dcsu031I,22451
+pytgcalls/mtproto/hydrogram_client.py,sha256=xWcdtknbkvJm0bZWzMDEpkRURus-aTPD8bCCoAS4A9A,23626
+pytgcalls/mtproto/mtproto_client.py,sha256=YOCJlTxDB210R7xbdp6cHBEGy5-dCtU3SBDTSeWrrRM,7674
+pytgcalls/mtproto/pyrogram_client.py,sha256=WYwhm4ESeWKz9BgK36951M-7D3XBYHbiCXYyNBRfIP4,23807
+pytgcalls/mtproto/telethon_client.py,sha256=j7IwOz3cgUmLIfppSWPt8FTV8Qbv98MK5qWE1vpPvgM,23037
 pytgcalls/types/__init__.py,sha256=iXAzXG5WgbICLQV1JT_F4QtOqKWC8X3334-MOv2SXW4,1127
 pytgcalls/types/browsers.py,sha256=47Kr5q96n4Q4WvVhA6IUlS2egEcA9GRLlDeFcQYyc9M,9545
 pytgcalls/types/cache.py,sha256=FfsOcmYnsBGPlJoTPIXXYcUSpGE3rhx6cjIH77hyUL0,1059
@@ -67,7 +69,7 @@ pytgcalls/types/dict.py,sha256=lAo9hu4VlVJa9S7P8Y81BYmKtvz0rH7hwpGcH3ynHUw,78
 pytgcalls/types/flag.py,sha256=dQPcQmTgTQzcOLTvGe8t_e9mY4qsVnCZFrrTk17b2Xw,132
 pytgcalls/types/list.py,sha256=UjP_XxxMpPkLlu6yEy29JYqOM5VITFwwJcDm0wZni1c,78
 pytgcalls/types/participant_list.py,sha256=LmGjU63MK1v3SS2_4xNbk04OOjmukNdAXYLRn2L-730,916
-pytgcalls/types/py_object.py,sha256=VlazuMP0cFpExKimW8BtWR66LDewnNdQSLC7r_t7JIM,842
+pytgcalls/types/py_object.py,sha256=__GNXgffGK4jhdF4QPqIknd0k2myObJf_7fW3pNGpbU,836
 pytgcalls/types/update.py,sha256=wPCzWLhrsScZ3ksRTyt8IuDaaG5YI-ItG_Yw-OqzK2Y,157
 pytgcalls/types/user_agent.py,sha256=sSfeGqUe0v0wqBgdVszNFK0iOC_0Tdyto9CglBXlY4U,1086
 pytgcalls/types/calls/__init__.py,sha256=f0zMKm_mwvNsDRPgs8IopuCEefU3V0-kuHAFsTMBoAc,403
@@ -79,7 +81,7 @@ pytgcalls/types/calls/call_sources.py,sha256=sBhumPgEaN8uAKjBwb1Zf_Ag0qrceti2mUR
 pytgcalls/types/calls/group_call_config.py,sha256=auKH-hZJWj8PhTkyeQ_VK2z9NpNvNC7Scl_IhEUMnQM,353
 pytgcalls/types/calls/raw_call_update.py,sha256=hpNw6HrTW8Z36Lh2HinS-wzprryRtsIxyIFbIfjGgeI,795
 pytgcalls/types/chats/__init__.py,sha256=v8pUp_vbr2kQpyHtAQc80N-YqzmXHe9SbllUsa6njkU,261
-pytgcalls/types/chats/chat_update.py,sha256=wh8v2I-pZxJWGNBjIwWRbhY-ZCI4v8qGabDTpuJaHu0,619
+pytgcalls/types/chats/chat_update.py,sha256=lzrqNDPv4a_yXpKIfUnhocXqZyIy8XgZladOQTYrrYA,730
 pytgcalls/types/chats/group_call_participant.py,sha256=XG4dekFV9GYHASqy_bSE6YnZ1uDunFFif-xLAy_eYGY,1711
 pytgcalls/types/chats/updated_group_call_participant.py,sha256=-KID-z-4e43fhYWQp0pNMKPfmZizbJHXyzn6yLtIGNg,291
 pytgcalls/types/raw/__init__.py,sha256=ROHsKFeUMUtlFbx2rhfrdB-TuVm0zBuvNo29Ccn5614,308
@@ -94,13 +96,12 @@ pytgcalls/types/stream/device.py,sha256=EdoDg6lPE7fgoZI04Nr0E9zbIk-iRIBgYYAzVqoC
 pytgcalls/types/stream/direction.py,sha256=VepLMe-dXg4M5eVdVyIb2uxYvnpB9OJL5fEgPYUFtTI,592
 pytgcalls/types/stream/external_media.py,sha256=RiuSX5tZGdNsQZ8LIRk5Lp4Ksv9oTvaccmInJRZYo4M,114
 pytgcalls/types/stream/frame.py,sha256=TXo5HZVHbbaVNBqulMhTqGODXH3bpBVlN_of1rosNUQ,586
-pytgcalls/types/stream/media_stream.py,sha256=jNWNJppX2ji4CrHdkF2b6FFLeiS9KKjVDGvcWPmPrvc,11917
-pytgcalls/types/stream/record_stream.py,sha256=VEKB2rSnb4U1EyoPdNteWxJ65feV58EGu5QmDEJiB2E,3037
+pytgcalls/types/stream/media_stream.py,sha256=_NJFTAIUdYyTh-gjiqs6aCpAIfSVjE16mBYUapMnDfg,11917
+pytgcalls/types/stream/record_stream.py,sha256=RWeD9U-sqUmb_PuZQxYnExZyoibepU_8oI2yrH2Y18c,3135
 pytgcalls/types/stream/stream_ended.py,sha256=xR_kZwFf03hA6rw_nvI7Be7GwoCKzQf_1MKaGpPDXqY,716
 pytgcalls/types/stream/stream_frames.py,sha256=028ZhNV-mN3BGqMlmxusAV1xDQpXRYCeM0WXBZhRUhA,446
 pytgcalls/types/stream/video_quality.py,sha256=HBfWq005kh-D19MaVE9VzVdnODzrXf4IJUimCfslfiU,231
-py_tgcalls-2.1.0rc6.dist-info/LICENSE,sha256=46mU2C5kSwOnkqkw9XQAJlhBL2JAf1_uCD8lVcXyMRg,7652
-py_tgcalls-2.1.0rc6.dist-info/METADATA,sha256=E22VIEktETvsBUrh_2Fx0U3eNYUGZDAumjRcmIYo5ek,14331
-py_tgcalls-2.1.0rc6.dist-info/WHEEL,sha256=52BFRY2Up02UkjOa29eZOS2VxUrpPORXg1pkohGGUS8,91
-py_tgcalls-2.1.0rc6.dist-info/top_level.txt,sha256=IUDUwn0KkcbUYZbCe9R5AUb2Ob-lmllNUGQqyeXXd8A,10
-py_tgcalls-2.1.0rc6.dist-info/RECORD,,
+py_tgcalls-2.1.1.dist-info/METADATA,sha256=TrhFZ_S_GpSn7T2mGGjfYS5eIodswvwZJm60AYobo74,5280
+py_tgcalls-2.1.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+py_tgcalls-2.1.1.dist-info/top_level.txt,sha256=IUDUwn0KkcbUYZbCe9R5AUb2Ob-lmllNUGQqyeXXd8A,10
+py_tgcalls-2.1.1.dist-info/RECORD,,

{py_tgcalls-2.1.0rc6.dist-info → py_tgcalls-2.1.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (76.0.0)
+Generator: setuptools (78.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pytgcalls/__version__.py

@@ -1 +1 @@
-__version__ = '2.1.0.rc6'
+__version__ = '2.1.1'

pytgcalls/exceptions.py

@@ -37,13 +37,6 @@ class TooOldHydrogramVersion(Exception):
         )
 
 
-class InvalidStreamMode(Exception):
-    def __init__(self):
-        super().__init__(
-            'Invalid stream mode',
-        )
-
-
 class NoMTProtoClientSet(Exception):
     def __init__(self):
         super().__init__(
@@ -72,24 +65,24 @@ class CallDeclined(Exception):
         )
 
 
-class CallDiscarded(Exception):
+class CallBusy(Exception):
     def __init__(self, user_id: int):
         super().__init__(
-            f'Call discarded by {user_id}',
+            f'The user {user_id} is busy',
         )
 
 
-class NotInCallError(Exception):
-    def __init__(self):
+class CallDiscarded(Exception):
+    def __init__(self, user_id: int):
         super().__init__(
-            'The userbot is not in a call',
+            f'Call discarded by {user_id}',
         )
 
 
-class AlreadyJoinedError(Exception):
+class NotInCallError(Exception):
     def __init__(self):
         super().__init__(
-            'Already joined into group call',
+            'The userbot is not in a call',
         )
 
 
@@ -115,16 +108,6 @@ class TooManyCustomApiDecorators(Exception):
         )
 
 
-class GroupCallNotFound(Exception):
-    def __init__(
-            self,
-            chat_id: int,
-    ):
-        super().__init__(
-            f'Group call not found with the chat id {chat_id}',
-        )
-
-
 class InvalidMTProtoClient(Exception):
     def __init__(self):
         super().__init__(

pytgcalls/methods/calls/leave_call.py

@@ -11,9 +11,9 @@ from ...statictypes import statictypes
 
 
 class LeaveCall(Scaffold):
-    @mutex
     @statictypes
     @mtproto_required
+    @mutex
     async def leave_call(
         self,
         chat_id: Union[int, str],

pytgcalls/methods/stream/play.py

@@ -29,9 +29,9 @@ py_logger = logging.getLogger('pytgcalls')
 
 
 class Play(Scaffold):
-    @mutex
     @statictypes
     @mtproto_required
+    @mutex
     async def play(
         self,
         chat_id: Union[int, str],
@@ -125,6 +125,8 @@ class Play(Scaffold):
                                 chat_id,
                                 data.g_a_or_b,
                                 self._binding.get_protocol(),
+                                media_description.camera is not None or
+                                media_description.screen is not None,
                             )
 
                         try:

pytgcalls/methods/stream/record.py

@@ -1,10 +1,12 @@
 import logging
+from pathlib import Path
 from typing import Optional
 from typing import Union
 
 from ntgcalls import FileError
 from ntgcalls import StreamMode
 
+from ...media_devices import SpeakerDevice
 from ...mtproto_required import mtproto_required
 from ...scaffold import Scaffold
 from ...statictypes import statictypes
@@ -22,7 +24,7 @@ class Record(Scaffold):
     async def record(
         self,
         chat_id: Union[int, str],
-        stream: Optional[Stream] = None,
+        stream: Optional[Union[str, Path, Stream, SpeakerDevice]] = None,
         config: Optional[Union[CallConfig, GroupCallConfig]] = None,
     ):
         chat_id = await self.resolve_chat_id(chat_id)

pytgcalls/methods/utilities/join_presentation.py

@@ -1,5 +1,6 @@
 from typing import Union
 
+from ntgcalls import ConnectionError
 from ntgcalls import TelegramServerError
 
 from ...scaffold import Scaffold
@@ -40,7 +41,10 @@ class JoinPresentation(Scaffold):
                     self._log_retries(retries)
                 finally:
                     self._wait_connect.pop(chat_id, None)
-        elif chat_id in self._call_sources:
-            await self._binding.stop_presentation(chat_id)
-            await self._app.leave_presentation(chat_id)
+        elif chat_id in self._presentations:
+            try:
+                await self._binding.stop_presentation(chat_id)
+                await self._app.leave_presentation(chat_id)
+            except ConnectionError:
+                pass
             self._presentations.discard(chat_id)

pytgcalls/methods/utilities/start.py

@@ -13,6 +13,7 @@ from ntgcalls import StreamMode
 from ntgcalls import StreamType
 from ntgcalls import TelegramServerError
 
+from ...exceptions import CallBusy
 from ...exceptions import CallDeclined
 from ...exceptions import CallDiscarded
 from ...exceptions import PyTgCallsAlreadyRunning
@@ -53,6 +54,10 @@ class Start(Scaffold):
                         if update.status & ChatUpdate.Status.DISCARDED_CALL:
                             self._wait_connect.pop(chat_id, None)
                             p2p_config.wait_data.set_exception(
+                                CallBusy(
+                                    chat_id,
+                                ) if update.status &
+                                ChatUpdate.Status.BUSY_CALL else
                                 CallDeclined(
                                     chat_id,
                                 ),
@@ -197,6 +202,10 @@ class Start(Scaffold):
 
         async def clear_call(chat_id) -> bool:
             res = False
+            if chat_id in self._wait_connect:
+                self._wait_connect[chat_id].set_exception(
+                    TelegramServerError(),
+                )
             try:
                 await self._binding.stop(chat_id)
                 res = True
@@ -282,9 +291,7 @@ class Start(Scaffold):
                     self._wait_connect[chat_id].set_exception(
                         TelegramServerError(),
                     )
-                    await clear_cache(chat_id)
-
-            if state != ConnectionState.CONNECTED:
+            elif state != ConnectionState.CONNECTED:
                 if chat_id > 0:
                     await self._app.discard_call(chat_id)
                 await clear_cache(chat_id)

pytgcalls/methods/utilities/stream_params.py

@@ -7,6 +7,7 @@ from ntgcalls import MediaDescription
 from ntgcalls import VideoDescription
 
 from ...media_devices.input_device import InputDevice
+from ...media_devices.speaker_device import SpeakerDevice
 from ...types import RecordStream
 from ...types.raw import AudioStream
 from ...types.raw import Stream
@@ -75,12 +76,14 @@ class StreamParams:
 
     @staticmethod
     async def get_record_params(
-        stream: Optional[Stream],
+        stream: Optional[Union[str, Path, Stream, SpeakerDevice]],
     ) -> MediaDescription:
         if stream is not None:
+            if isinstance(stream, (str, Path, SpeakerDevice)):
+                stream = RecordStream(stream)
             if isinstance(stream, MediaStream):
                 raise ValueError(
                     'Stream should be an instance of '
                     'RecordStream or a raw Stream',
                 )
-        return StreamParams._parse_stream_description(stream)
+        return StreamParams._parse_stream_description(stream)  # type: ignore

pytgcalls/mtproto/bridged_client.py

@@ -25,7 +25,7 @@ class BridgedClient(HandlersHolder):
         chat_id: int,
         json_join: str,
         invite_hash: str,
-        have_video: bool,
+        video_stopped: bool,
         join_as: Any,
     ):
         pass
@@ -48,6 +48,7 @@ class BridgedClient(HandlersHolder):
         user_id: int,
         g_a_hash: bytes,
         protocol: Protocol,
+        has_video: bool,
     ):
         pass
 

pytgcalls/mtproto/hydrogram_client.py

@@ -42,6 +42,7 @@ from hydrogram.raw.types import PeerChat
 from hydrogram.raw.types import PhoneCall
 from hydrogram.raw.types import PhoneCallAccepted
 from hydrogram.raw.types import PhoneCallDiscarded
+from hydrogram.raw.types import PhoneCallDiscardReasonBusy
 from hydrogram.raw.types import PhoneCallDiscardReasonHangup
 from hydrogram.raw.types import PhoneCallDiscardReasonMissed
 from hydrogram.raw.types import PhoneCallProtocol
@@ -129,10 +130,16 @@ class HydrogramClient(BridgedClient):
                         self._cache.drop_phone_call(
                             user_id,
                         )
+                        reason = ChatUpdate.Status.DISCARDED_CALL
+                        if isinstance(
+                            update.phone_call.reason,
+                            PhoneCallDiscardReasonBusy,
+                        ):
+                            reason |= ChatUpdate.Status.BUSY_CALL
                         await self._propagate(
                             ChatUpdate(
                                 user_id,
-                                ChatUpdate.Status.DISCARDED_CALL,
+                                reason,
                             ),
                         )
                 if isinstance(update.phone_call, PhoneCallRequested):
@@ -388,7 +395,7 @@ class HydrogramClient(BridgedClient):
         chat_id: int,
         json_join: str,
         invite_hash: str,
-        have_video: bool,
+        video_stopped: bool,
         join_as: InputPeer,
     ) -> str:
         chat_call = await self._cache.get_full_chat(chat_id)
@@ -399,7 +406,7 @@ class HydrogramClient(BridgedClient):
                     params=DataJSON(data=json_join),
                     muted=False,
                     join_as=join_as,
-                    video_stopped=have_video,
+                    video_stopped=video_stopped,
                     invite_hash=invite_hash,
                 ),
             )
@@ -455,14 +462,22 @@ class HydrogramClient(BridgedClient):
         user_id: int,
         g_a_hash: bytes,
         protocol: Protocol,
+        has_video: bool,
     ):
-        await self._app.invoke(
+        update = await self._app.invoke(
             RequestCall(
                 user_id=await self.resolve_peer(user_id),
                 random_id=self.rnd_id(),
                 g_a_hash=g_a_hash,
                 protocol=self.parse_protocol(protocol),
-                video=False,
+                video=has_video,
+            ),
+        )
+        self._cache.set_phone_call(
+            user_id,
+            InputPhoneCall(
+                id=update.phone_call.id,
+                access_hash=update.phone_call.access_hash,
             ),
         )
 

pytgcalls/mtproto/mtproto_client.py

@@ -55,7 +55,7 @@ class MtProtoClient:
         chat_id: int,
         json_join: str,
         invite_hash: str,
-        have_video: bool,
+        video_stopped: bool,
         join_as: Any,
     ) -> str:
         if self._bind_client is not None:
@@ -63,7 +63,7 @@ class MtProtoClient:
                 chat_id,
                 json_join,
                 invite_hash,
-                have_video,
+                video_stopped,
                 join_as,
             )
         else:
@@ -98,12 +98,14 @@ class MtProtoClient:
         user_id: int,
         g_a_hash: bytes,
         protocol: Protocol,
+        has_video: bool,
     ):
         if self._bind_client is not None:
             return await self._bind_client.request_call(
                 user_id,
                 g_a_hash,
                 protocol,
+                has_video,
             )
         else:
             raise InvalidMTProtoClient()

pytgcalls/mtproto/pyrogram_client.py

@@ -44,6 +44,7 @@ from pyrogram.raw.types import PeerChat
 from pyrogram.raw.types import PhoneCall
 from pyrogram.raw.types import PhoneCallAccepted
 from pyrogram.raw.types import PhoneCallDiscarded
+from pyrogram.raw.types import PhoneCallDiscardReasonBusy
 from pyrogram.raw.types import PhoneCallDiscardReasonHangup
 from pyrogram.raw.types import PhoneCallDiscardReasonMissed
 from pyrogram.raw.types import PhoneCallProtocol
@@ -137,10 +138,16 @@ class PyrogramClient(BridgedClient):
                         self._cache.drop_phone_call(
                             user_id,
                         )
+                        reason = ChatUpdate.Status.DISCARDED_CALL
+                        if isinstance(
+                            update.phone_call.reason,
+                            PhoneCallDiscardReasonBusy,
+                        ):
+                            reason |= ChatUpdate.Status.BUSY_CALL
                         await self._propagate(
                             ChatUpdate(
                                 user_id,
-                                ChatUpdate.Status.DISCARDED_CALL,
+                                reason,
                             ),
                         )
                 if isinstance(update.phone_call, PhoneCallRequested):
@@ -396,7 +403,7 @@ class PyrogramClient(BridgedClient):
         chat_id: int,
         json_join: str,
         invite_hash: str,
-        have_video: bool,
+        video_stopped: bool,
         join_as: InputPeer,
     ) -> str:
         chat_call = await self._cache.get_full_chat(chat_id)
@@ -407,7 +414,7 @@ class PyrogramClient(BridgedClient):
                     params=DataJSON(data=json_join),
                     muted=False,
                     join_as=join_as,
-                    video_stopped=have_video,
+                    video_stopped=video_stopped,
                     invite_hash=invite_hash,
                 ),
             )
@@ -463,14 +470,22 @@ class PyrogramClient(BridgedClient):
         user_id: int,
         g_a_hash: bytes,
         protocol: Protocol,
+        has_video: bool,
     ):
-        await self._app.invoke(
+        update = await self._app.invoke(
             RequestCall(
                 user_id=await self.resolve_peer(user_id),
                 random_id=self.rnd_id(),
                 g_a_hash=g_a_hash,
                 protocol=self.parse_protocol(protocol),
-                video=False,
+                video=has_video,
+            ),
+        )
+        self._cache.set_phone_call(
+            user_id,
+            InputPhoneCall(
+                id=update.phone_call.id,
+                access_hash=update.phone_call.access_hash,
             ),
         )
 

pytgcalls/mtproto/telethon_client.py

@@ -39,6 +39,7 @@ from telethon.tl.types import PeerChat
 from telethon.tl.types import PhoneCall
 from telethon.tl.types import PhoneCallAccepted
 from telethon.tl.types import PhoneCallDiscarded
+from telethon.tl.types import PhoneCallDiscardReasonBusy
 from telethon.tl.types import PhoneCallDiscardReasonHangup
 from telethon.tl.types import PhoneCallDiscardReasonMissed
 from telethon.tl.types import PhoneCallProtocol
@@ -128,10 +129,16 @@ class TelethonClient(BridgedClient):
                         self._cache.drop_phone_call(
                             user_id,
                         )
+                        reason = ChatUpdate.Status.DISCARDED_CALL
+                        if isinstance(
+                            update.phone_call.reason,
+                            PhoneCallDiscardReasonBusy,
+                        ):
+                            reason |= ChatUpdate.Status.BUSY_CALL
                         await self._propagate(
                             ChatUpdate(
                                 user_id,
-                                ChatUpdate.Status.DISCARDED_CALL,
+                                reason,
                             ),
                         )
                 if isinstance(update.phone_call, PhoneCallRequested):
@@ -380,7 +387,7 @@ class TelethonClient(BridgedClient):
         chat_id: int,
         json_join: str,
         invite_hash: str,
-        have_video: bool,
+        video_stopped: bool,
         join_as: TypeInputPeer,
     ) -> str:
         chat_call = await self._cache.get_full_chat(chat_id)
@@ -391,7 +398,7 @@ class TelethonClient(BridgedClient):
                     params=DataJSON(data=json_join),
                     muted=False,
                     join_as=join_as,
-                    video_stopped=have_video,
+                    video_stopped=video_stopped,
                     invite_hash=invite_hash,
                 ),
             )
@@ -447,14 +454,22 @@ class TelethonClient(BridgedClient):
         user_id: int,
         g_a_hash: bytes,
         protocol: Protocol,
+        has_video: bool,
     ):
-        return await self._app(
+        update = await self._app(
             RequestCallRequest(
                 user_id=await self.resolve_peer(user_id),
                 random_id=self.rnd_id(),
                 g_a_hash=g_a_hash,
                 protocol=self.parse_protocol(protocol),
-                video=False,
+                video=has_video,
+            ),
+        )
+        self._cache.set_phone_call(
+            user_id,
+            InputPhoneCall(
+                id=update.phone_call.id,
+                access_hash=update.phone_call.access_hash,
             ),
         )
 

pytgcalls/mutex.py

@@ -1,10 +1,22 @@
 from functools import wraps
 
+from .wait_counter_lock import WaitCounterLock
+
 
 def mutex(func):
     @wraps(func)
     async def async_wrapper(*args, **kwargs):
         self = args[0]
+        chat_id = await self.resolve_chat_id(args[1])
+        async with self._lock:
+            self._calls_lock[chat_id] = self._calls_lock.get(
+                chat_id,
+            ) or WaitCounterLock()
+        async with self._calls_lock[chat_id]:
+            result = await func(*args, **kwargs)
+
         async with self._lock:
-            return await func(*args, **kwargs)
+            if not self._calls_lock[chat_id].waiters():
+                self._calls_lock.pop(chat_id, None)
+        return result
     return async_wrapper

pytgcalls/pytgcalls.py

@@ -2,6 +2,7 @@ import asyncio
 import os
 from concurrent.futures import ThreadPoolExecutor
 from typing import Any
+from typing import Dict
 
 from ntgcalls import NTgCalls
 
@@ -11,6 +12,7 @@ from .mtproto import MtProtoClient
 from .scaffold import Scaffold
 from .statictypes import statictypes
 from .types import Cache
+from .wait_counter_lock import WaitCounterLock
 
 
 class PyTgCalls(Methods, Scaffold):
@@ -42,6 +44,7 @@ class PyTgCalls(Methods, Scaffold):
         self.loop = asyncio.get_event_loop()
         self.workers = workers
         self._lock = asyncio.Lock()
+        self._calls_lock: Dict[str, WaitCounterLock] = {}
         self.executor = ThreadPoolExecutor(
             self.workers,
             thread_name_prefix='Handler',

pytgcalls/types/chats/chat_update.py

@@ -13,7 +13,14 @@ class ChatUpdate(Update):
         INVITED_VOICE_CHAT = auto()
         DISCARDED_CALL = auto()
         INCOMING_CALL = auto()
-        LEFT_CALL = KICKED | LEFT_GROUP | CLOSED_VOICE_CHAT | DISCARDED_CALL
+        BUSY_CALL = auto()
+        LEFT_CALL = (
+            KICKED |
+            LEFT_GROUP |
+            CLOSED_VOICE_CHAT |
+            DISCARDED_CALL |
+            BUSY_CALL
+        )
 
     def __init__(
         self,

pytgcalls/types/py_object.py

@@ -13,16 +13,15 @@ class PyObject:
             return repr(obj)
         if isinstance(obj, Enum):
             return repr(obj)
-        if hasattr(obj, '__dict__'):
-            return {
-                '_': obj.__class__.__name__,
-                **{
-                    attr: vars(obj)[attr]
-                    for attr in vars(obj)
-                    if not attr.startswith('_')
-                },
-            }
-        return {}
+        return {
+            '_': obj.__class__.__name__,
+            **{
+                attr: getattr(obj, attr)
+                for attr in dir(obj)
+                if not attr.startswith('_') and
+                not callable(getattr(obj, attr)) and not attr == 'default'
+            },
+        }
 
     def __str__(self) -> str:
         return dumps(

pytgcalls/types/stream/media_stream.py

@@ -47,7 +47,7 @@ class MediaStream(Stream):
         video_parameters: Union[
             VideoParameters,
             VideoQuality,
-        ] = VideoQuality.SD_480p,
+        ] = VideoQuality.HD_720p,
         audio_path: Optional[
             Union[
                 str, Path,

pytgcalls/types/stream/record_stream.py

@@ -1,3 +1,4 @@
+from pathlib import Path
 from typing import Union
 
 from ntgcalls import MediaSource
@@ -16,7 +17,7 @@ class RecordStream(Stream):
     @statictypes
     def __init__(
         self,
-        audio: Union[bool, str, SpeakerDevice] = False,
+        audio: Union[bool, str, Path, SpeakerDevice] = False,
         audio_parameters: Union[
             AudioParameters,
             AudioQuality,
@@ -46,6 +47,8 @@ class RecordStream(Stream):
                 path='',
                 parameters=raw_audio_parameters,
             )
+        if isinstance(audio, Path):
+            audio = str(audio)
         if isinstance(audio, str):
             is_lossless = raw_audio_parameters.bitrate > 48000
             commands = [

pytgcalls/wait_counter_lock.py

@@ -0,0 +1,20 @@
+import asyncio
+
+
+class WaitCounterLock:
+    def __init__(self):
+        self._lock = asyncio.Lock()
+        self._waiters = 0
+
+    def waiters(self):
+        return self._waiters
+
+    async def __aenter__(self):
+        self._waiters += 1
+        await self._lock.acquire()
+        self._waiters -= 1
+        return self
+
+    async def __aexit__(self, exc_type, exc, tb):
+        if self._lock.locked():
+            self._lock.release()

py_tgcalls-2.1.0rc6.dist-info/METADATA

@@ -1,292 +0,0 @@
-Metadata-Version: 2.2
-Name: py-tgcalls
-Version: 2.1.0rc6
-Summary: Async client API for the Telegram Calls.
-Author-email: Laky-64 <iraci.matteo@gmail.com>
-License:                    GNU LESSER GENERAL PUBLIC LICENSE
-                               Version 3, 29 June 2007
-        
-         Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
-         Everyone is permitted to copy and distribute verbatim copies
-         of this license document, but changing it is not allowed.
-        
-        
-          This version of the GNU Lesser General Public License incorporates
-        the terms and conditions of version 3 of the GNU General Public
-        License, supplemented by the additional permissions listed below.
-        
-          0. Additional Definitions.
-        
-          As used herein, "this License" refers to version 3 of the GNU Lesser
-        General Public License, and the "GNU GPL" refers to version 3 of the GNU
-        General Public License.
-        
-          "The Library" refers to a covered work governed by this License,
-        other than an Application or a Combined Work as defined below.
-        
-          An "Application" is any work that makes use of an interface provided
-        by the Library, but which is not otherwise based on the Library.
-        Defining a subclass of a class defined by the Library is deemed a mode
-        of using an interface provided by the Library.
-        
-          A "Combined Work" is a work produced by combining or linking an
-        Application with the Library.  The particular version of the Library
-        with which the Combined Work was made is also called the "Linked
-        Version".
-        
-          The "Minimal Corresponding Source" for a Combined Work means the
-        Corresponding Source for the Combined Work, excluding any source code
-        for portions of the Combined Work that, considered in isolation, are
-        based on the Application, and not on the Linked Version.
-        
-          The "Corresponding Application Code" for a Combined Work means the
-        object code and/or source code for the Application, including any data
-        and utility programs needed for reproducing the Combined Work from the
-        Application, but excluding the System Libraries of the Combined Work.
-        
-          1. Exception to Section 3 of the GNU GPL.
-        
-          You may convey a covered work under sections 3 and 4 of this License
-        without being bound by section 3 of the GNU GPL.
-        
-          2. Conveying Modified Versions.
-        
-          If you modify a copy of the Library, and, in your modifications, a
-        facility refers to a function or data to be supplied by an Application
-        that uses the facility (other than as an argument passed when the
-        facility is invoked), then you may convey a copy of the modified
-        version:
-        
-           a) under this License, provided that you make a good faith effort to
-           ensure that, in the event an Application does not supply the
-           function or data, the facility still operates, and performs
-           whatever part of its purpose remains meaningful, or
-        
-           b) under the GNU GPL, with none of the additional permissions of
-           this License applicable to that copy.
-        
-          3. Object Code Incorporating Material from Library Header Files.
-        
-          The object code form of an Application may incorporate material from
-        a header file that is part of the Library.  You may convey such object
-        code under terms of your choice, provided that, if the incorporated
-        material is not limited to numerical parameters, data structure
-        layouts and accessors, or small macros, inline functions and templates
-        (ten or fewer lines in length), you do both of the following:
-        
-           a) Give prominent notice with each copy of the object code that the
-           Library is used in it and that the Library and its use are
-           covered by this License.
-        
-           b) Accompany the object code with a copy of the GNU GPL and this license
-           document.
-        
-          4. Combined Works.
-        
-          You may convey a Combined Work under terms of your choice that,
-        taken together, effectively do not restrict modification of the
-        portions of the Library contained in the Combined Work and reverse
-        engineering for debugging such modifications, if you also do each of
-        the following:
-        
-           a) Give prominent notice with each copy of the Combined Work that
-           the Library is used in it and that the Library and its use are
-           covered by this License.
-        
-           b) Accompany the Combined Work with a copy of the GNU GPL and this license
-           document.
-        
-           c) For a Combined Work that displays copyright notices during
-           execution, include the copyright notice for the Library among
-           these notices, as well as a reference directing the user to the
-           copies of the GNU GPL and this license document.
-        
-           d) Do one of the following:
-        
-               0) Convey the Minimal Corresponding Source under the terms of this
-               License, and the Corresponding Application Code in a form
-               suitable for, and under terms that permit, the user to
-               recombine or relink the Application with a modified version of
-               the Linked Version to produce a modified Combined Work, in the
-               manner specified by section 6 of the GNU GPL for conveying
-               Corresponding Source.
-        
-               1) Use a suitable shared library mechanism for linking with the
-               Library.  A suitable mechanism is one that (a) uses at run time
-               a copy of the Library already present on the user's computer
-               system, and (b) will operate properly with a modified version
-               of the Library that is interface-compatible with the Linked
-               Version.
-        
-           e) Provide Installation Information, but only if you would otherwise
-           be required to provide such information under section 6 of the
-           GNU GPL, and only to the extent that such information is
-           necessary to install and execute a modified version of the
-           Combined Work produced by recombining or relinking the
-           Application with a modified version of the Linked Version. (If
-           you use option 4d0, the Installation Information must accompany
-           the Minimal Corresponding Source and Corresponding Application
-           Code. If you use option 4d1, you must provide the Installation
-           Information in the manner specified by section 6 of the GNU GPL
-           for conveying Corresponding Source.)
-        
-          5. Combined Libraries.
-        
-          You may place library facilities that are a work based on the
-        Library side by side in a single library together with other library
-        facilities that are not Applications and are not covered by this
-        License, and convey such a combined library under terms of your
-        choice, if you do both of the following:
-        
-           a) Accompany the combined library with a copy of the same work based
-           on the Library, uncombined with any other library facilities,
-           conveyed under the terms of this License.
-        
-           b) Give prominent notice with the combined library that part of it
-           is a work based on the Library, and explaining where to find the
-           accompanying uncombined form of the same work.
-        
-          6. Revised Versions of the GNU Lesser General Public License.
-        
-          The Free Software Foundation may publish revised and/or new versions
-        of the GNU Lesser General Public License from time to time. Such new
-        versions will be similar in spirit to the present version, but may
-        differ in detail to address new problems or concerns.
-        
-          Each version is given a distinguishing version number. If the
-        Library as you received it specifies that a certain numbered version
-        of the GNU Lesser General Public License "or any later version"
-        applies to it, you have the option of following the terms and
-        conditions either of that published version or of any later version
-        published by the Free Software Foundation. If the Library as you
-        received it does not specify a version number of the GNU Lesser
-        General Public License, you may choose any version of the GNU Lesser
-        General Public License ever published by the Free Software Foundation.
-        
-          If the Library as you received it specifies that a proxy can decide
-        whether future versions of the GNU Lesser General Public License shall
-        apply, that proxy's public statement of acceptance of any version is
-        permanent authorization for you to choose that version for the
-        Library.
-        
-Project-URL: Homepage, https://pytgcalls.github.io/
-Project-URL: Repository, https://github.com/pytgcalls/pytgcalls.git
-Project-URL: Documentation, https://pytgcalls.github.io/PyTgCalls
-Project-URL: Changelog, https://pytgcalls.github.io/PyTgCalls/Changelogs
-Keywords: audio,python,library,video,telegram,stream,ffmpeg,cpp,webrtc,voice-chat,voip,group-chat,video-calls,calls,video-chat,pytgcalls,ntgcalls,tgcalls,py-tgcalls,pyrogram,telethon,hydrogram
-Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiohttp>=3.9.3
-Requires-Dist: ntgcalls<1.4.0,>=1.3.0b15
-Requires-Dist: deprecation
-Provides-Extra: pyrogram
-Requires-Dist: pyrogram>=1.2.20; extra == "pyrogram"
-Provides-Extra: telethon
-Requires-Dist: telethon>=1.24.0; extra == "telethon"
-Provides-Extra: hydrogram
-Requires-Dist: hydrogram>=0.1.4; extra == "hydrogram"
-
-<img src="https://raw.githubusercontent.com/pytgcalls/pytgcalls/master/.github/images/banner.png" alt="pytgcalls logo" />
-<p align="center">
-    <b>A simple and elegant client that allows you to make group voice calls quickly and easily.</b>
-    <br>
-    <a href="https://github.com/pytgcalls/pytgcalls/tree/master/example">
-        Examples
-    </a>
-    •
-    <a href="https://pytgcalls.github.io/">
-        Documentation
-    </a>
-    •
-    <a href="https://pypi.org/project/py-tgcalls/">
-        PyPi
-    </a>
-    •
-    <a href="https://t.me/pytgcallsnews">
-        Channel
-    </a>
-    •
-    <a href="https://t.me/pytgcallschat">
-        Chat
-    </a>
-</p>
-
-# PyTgCalls [![PyPI](https://img.shields.io/pypi/v/py-tgcalls.svg?logo=python&logoColor=%23959DA5&label=pypi&labelColor=%23282f37)](https://pypi.org/project/py-tgcalls/) [![Downloads](https://img.shields.io/pepy/dt/py-tgcalls?logoColor=%23959DA5&labelColor=%23282f37&color=%2328A745)](https://pepy.tech/project/py-tgcalls)
-This project allows making Telegram call using MtProto and WebRTC, this is possible thanks to the power of [NTgCalls] library and [@evgeny-nadymov]
-
-#### Example Usage
-```python
-from pytgcalls import PyTgCalls
-from pytgcalls import idle
-...
-chat_id = -1001185324811
-app = PyTgCalls(client)
-app.start()
-app.play(
-    chat_id,
-    'http://docs.evostream.com/sample_content/assets/sintel1m720p.mp4',
-)
-idle()
-```
-
-## Features
-- Prebuilt wheels for macOS, Linux and Windows.
-- Supporting all type of MTProto libraries: Pyrogram, Telethon and Hydrogram.
-- Work with voice chats in channels and chats.
-- Join as channels or chats.
-- Mute/unmute, pause/resume, stop/play, volume control and more...
-
-## Requirements
-- Python 3.9 or higher.
-- An MTProto Client
-- A [Telegram API key](https://docs.pyrogram.org/intro/setup#api-keys).
-
-## How to install?
-Here's how to install the PyTgCalls lib, the commands are given below:
-
-``` bash
-# With Git
-pip install git+https://github.com/pytgcalls/pytgcalls -U
-
-# With PyPi (Recommended)
-pip install py-tgcalls -U
-```
-
-## Key Contributors
-* <b><a href="https://github.com/Laky-64">@Laky-64</a> (DevOps Engineer, Software Architect):</b>
-    * Played a crucial role in developing PyTgCalls being an ex developer of pyservercall and of tgcallsjs.
-    * Automation with GitHub Actions
-* <b><a href="https://github.com/kuogi">@kuogi</a> (Senior UI/UX designer, Documenter):</b>
-    * As a Senior UI/UX Designer, Kuogi has significantly improved the user interface of our documentation,
-      making it more visually appealing and user-friendly.
-    * Played a key role in writing and structuring our documentation, ensuring that it is clear,
-      informative, and accessible to all users.
-* <b><a href="https://github.com/vrumger">@vrumger</a> (Senior Node.js Developer, Software Architect):</b>
-    * Has made important fixes and enhancements to the WebRTC component of the library,
-      improving its stability and performance.
-    * Main developer of TgCallsJS
-* <b><a href="https://github.com/alemidev">@alemidev</a> (Senior Python Developer):</b>
-    * Has made important fixes and enhancements to the async part of the library
-
-## Junior Developers
-* <b><a href="https://github.com/TuriOG">@TuriOG</a> (Junior Python Developer):</b>
-    * Currently working on integrating NTgCalls into <a href="//github.com/pytgcalls/pytgcalls">PyTgCalls</a>, an important step
-      in expanding the functionality and usability of the library.
-
-## Special Thanks
-* <b><a href="https://github.com/evgeny-nadymov">@evgeny-nadymov</a>:</b>
-  A heartfelt thank you to Evgeny Nadymov for graciously allowing us to use their code from telegram-react.
-  His contribution has been pivotal to the success of this project.
-
-[NTgCalls]: https://github.com/pytgcalls/ntgcalls
-[@evgeny-nadymov]: https://github.com/evgeny-nadymov/