https://github.com/mr-r0ot/baleaccountapi

A Python library for control Bale Account.
https://github.com/mr-r0ot/baleaccountapi

account-control bale bale-api

Last synced: 8 days ago
JSON representation

A Python library for control Bale Account.

• Host: GitHub
• URL: https://github.com/mr-r0ot/baleaccountapi
• Owner: mr-r0ot
• License: mit
• Created: 2026-06-10T08:03:39.000Z (16 days ago)
• Default Branch: main
• Last Pushed: 2026-06-10T16:11:55.000Z (16 days ago)
• Last Synced: 2026-06-10T18:07:27.528Z (16 days ago)
• Topics: account-control, bale, bale-api
• Language: Python
• Homepage:
• Size: 18.6 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# چیست و چرا؟

کتابخانه های زیادی برای اتصال و ساخت ربات بله که به آن بازوی بله هم می گویند وجود دارد.

اما تا کنون هیچ کتابخانه رو ندیدم که امکان کنترل خود اکانت رو فراهم بکنه و بله هم مستندات در این باره منتشر نکرده.

برای یه پروژه به کنترل حساب بله نیاز پیدا کردم پس این کتابخانه رو ساختم

در مراحل آزمایشی هست و گسترده و پشتیبانی از تمام امکانات رو نداره چون در حد نیازه پروژه خودم نوشته شده

اگر کسی مایل بود می تونه درخواست های توسعه رو به گیت هاب بفرسته و د گسترش این کتابخانه کمک کنه

https://github.com/mr-r0ot/BaleAccountApi

# مستندات

### نصب

```

pip install BaleAccountApi

```

### استفاده

```

#افزودن

from BaleAccountApi import BaleAccountApi

# ساخت یک سشن جدید

home = BaleAccountApi.start(hide=False) # اگر می خواید نمایش داده بشه

#home = BaleAccountApi.start(hide=True) # اگر می خواهید مرورگر مخفی بشه 

# ارسال یه کد تایید(سشن همواره باید به تابع ها پاس داده شود)

if BaleAccountApi.send_otp_code(home, "09123456789"):

    print("با موفقیت ارسال شد")

else:

    print("خطا")

# گرفتن کد تایید و ورود به حساب

while True:

    code = input("Enter code: ")

    if BaleAccountApi.login(home, code):

        print("خوش اومدی :)")

        break

    else:

        print("کد اشتباه بود")

# در بله دو نوع id وجود دارد:

# یکی به صورت متنی و رشته است و یکی آیدی ععدی

# برای استفاده در این کتابخانه نیاز به آیدی عددی داریم پس با این تابع می توانیم:

# تبدیل آیدی رشته   به    آیدی ععدی قابل استفاده

ID='EnterYourBaleStringID' 

chat_uid = BaleAccountApi.convert_id_to_uid(home, ID)

print(f' Caht UID : {chat_uid}')

# باز کردن یه چت با آیدی عددی

# می تواند گروه کانال پیوی و... باشد

BaleAccountApi.open_chat(home, chat_uid=chat_uid)

# مثال خواندن پیام ها

out = BaleAccountApi.readmessages(home)

print(out)

# مثال ارسال پیام

# نکته: شما باید حتما دسترسی نوشتن داشته باشید!

if BaleAccountApi.send_message(home, 'HIII :) '):

    print("Sended :)")

else:

    print('My bad :(')

```

# تست

```

>python

Python 3.10.9 (, Dec  6 2022, 20:01:21) [MSC v.1934 64 bit (AMD64)] on win32

Type "help", "copyright", "credits" or "license" for more information.

>>> from BaleAccountApi import BaleAccountApi

>>>

>>> home = BaleAccountApi.start(hide=False)

>>> BaleAccountApi.send_otp_code(home, "09xxxxxxxx")

True

>>> BaleAccountApi.login(home, '58837')

False

>>> BaleAccountApi.login(home, '588379')

False

>>> BaleAccountApi.login(home, '874431')

True

>>> chat_uid = BaleAccountApi.convert_id_to_uid(home, "chessteach") # یک چنل کاملا نمونه هست و من هیچگونه ارتباطی با این شخص یا چنل ندارم

>>> chat_uid

'5679544311'

>>> BaleAccountApi.open_chat(home, chat_uid=chat_uid)

>>> BaleAccountApi.readmessages(home)

{'number': 13, 'messages': [{'id': '5450135393923202981-1779539711634-2029119805', 'date': '1779539711634', 'text': 'فواید شطرنج\n🔵\n🎯\n🌀\n1. تقویت تفکر استراتژیک: شطرنج به شما کمک می\u200cکند تا مهارت\u200cهای برنامه\u200cریزی و پیش\u200cبینی را تقویت کنید.\n2. افزایش تمرکز: بازی شطرنج نیاز به تمرکز بالا دارد و می\u200cتواند به بهبود توجه شما کمک کند.\n3. تقویت حافظه: یادگیری حرکات و استراتژی\u200cها می\u200cتواند حافظه شما را تقویت کند.\n4. توسعه مهارت\u200cهای حل مسئله: شطرنج به شما می\u200cآموزد که چگونه مسائل را تحلیل کرده و راه\u200cحل\u200cهای خلاقانه پیدا کنید.\n5. تقویت روابط اجتماعی: بازی با دیگران می\u200cتواند روابط اجتماعی شما را تقویت کند و فرصتی برای تعامل فراهم کند.'}, {'id': '7541243601219060335-1779540158311-2029119805', 'date': '1779540158311', 'text': 'پات چیست؟\nپات یک اصطلاح شطرنج و نوعی مساوی است. که مهره ها در حالتی قرار میگیرند.که نمی توانند حرکت کنند (شاه کیش نیست).'}, {'id': '-2821741083332188470-1779878351047-2029119805', 'date': '1779878351047', 'text': 'سلام و درود\nبلاخره بعد حدودا ۹۰ روز لیچس وصل شد و از فردا مسابقه میذاریم هر هفته\nفرا رسیدن عید قربان رو هم به تک تک شما تبریک میگم'}, {'id': '-4073044772460267988-1780516009664-2029119805', 'date': '1780516009664', 'text': 'سلام و درود بعد حدودا ۱ هفته فعالیت دوباره اغاز میشه عذر میخوام بابت فعالیت کم بزودی جبران میشه'}, {'id': '-4377032359728325890-1780516193066-2029119805', 'date': '1780516193066', 'text': 'یون لودویگ هامر، کارشناس TV2، در واکنش به این بازی گفت: «مگنوس کارلسن خودش هم نمی\u200cفهمد چطور توانست این موقعیت را از دست بدهد.»'}, {'id': '305087914504632659-1780516235302-2029119805', 'date': '1780516235302', 'text': 'خود کارلسن نیز پس از بازی کاملاً ناراحت و متعجب به نظر می\u200cرسید. او گفت: «چند حرکت بد بازی کردم و کمی هم کند بودم. چند چیز را اشتباه ارزیابی کردم. در پایان فکر می\u200cکردم دارم جلوی یک طرح را می\u200cگیرم. واقعاً حس می\u200cکردم اوضاع برایم نسبتاً راحت است، بنابراین خیلی ناامیدکننده است که فقط طی چند حرکت ببازم.» او البته پیروزی فیروزجا را شایسته دانست و اضافه کرد: «کاملاً حقش بود. چیزهای زیادی را ندیدم.»'}, {'id': '3934365852728266558-1780516246635-2029119805', 'date': '1780516246635', 'text': 'با این حال، این وضعیت مانع درخشش او نشد. فیروزجا پس از بازی گفت: «مسابقه سختی بود. خیلی پراسترس بود، اما از پایان آن خوشحالم.» او در پاسخ به این سؤال که آیا همچنان کارلسن را بهترین بازیکن جهان می\u200cداند، بدون تردید جواب داد: «بله، قطعاً او بهترین است.»'}, {'id': '-3213601262566243257-1780516262562-2029119805', 'date': '1780516262562', 'text': 'این برد باعث شد فیروزجا پس از دور نخست در صدر جدول قرار بگیرد؛ چرا که تنها پیروزی کلاسیک روز افتتاحیه را به نام خود ثبت کرد.'}, {'id': '-1080843452411067990-1780517214474-2029119805', 'date': '1780517214474', 'text': 'بهای موفقیت\n🔹\nروزی فریتس کرایسلر، هنرمند اتریشی، در پایان یکی از کنسرت\u200cهای بزرگش با تشویق بی\u200cامان و ایستادهٔ تماشاگران مواجه شد.\n🔹\nپس از پایان برنامه، کرایسلر درحال جمع\u200cآوری وسایل خود در پشت صحنه بود.\n🔹\nدر همین لحظه یکی از طرفدارانش به سراغ او آمد و گفت: «استاد! من حاضرم نصف عمرم را بدهم تا بتوانم مثل شما به این زیبایی ویولن بزنم!»\n🔹\nکرایسلر گفت: «من هم دقیقاً همین کار را کرده\u200cام! نصف عمرم را داده\u200cام.»\n------------'}, {'id': '-734626105106278119-1780518041294-2029119805', 'date': '1780518041294', 'text': 'شبتون خوش ادامه فعالیت رو فردا میریم'}, {'id': '5751189827295608344-1781036054548-2029119805', 'date': '1781036054548', 'text': '♟️\nقانون طلایی شروع بازی در شطرنج\n🔥\nاول توسعه مهره\u200cها، بعد حمله\n❌\nیکی از اشتباهات رایج مبتدی\u200cها این است که فکر می\u200cکنند باید خیلی زود حمله کنند و سریع به مات برسند.\nاما در بیشتر موقعیت\u200cهای استاندارد شروع بازی، این رویکرد معمولاً به ضررشان تمام می\u200cشود.\n⚠️\nوقتی بدون آماده\u200cسازی وارد حمله می\u200cشوی:\nبا تعداد کمی مهره فعال وارد موقعیتی می\u200cشوی که هنوز کامل توسعه پیدا نکرده\u200cای.\nدر حالی که بخش مهمی از نیروهای تو هنوز وارد بازی نشده\u200cاند.\n🛡️\nنتیجه معمولاً این است:\nحریف دفاع می\u200cکند، مهره\u200cهایش را توسعه می\u200cدهد و در ادامه ضدحمله می\u200cزند.\nچون او آرام\u200cتر و اصولی\u200cتر پیش رفته است.\n🤔\nقبل از شروع هر حمله از خودت بپرس:\n• آیا همه مهره\u200cهایم را توسعه داده\u200cام؟\n• آیا شاه من در امنیت نسبی است؟\n• آیا این حمله پشتوانه کافی دارد؟\n📌\nیک اصل مهم:\nدر شروع بازی، اولویت با فعال\u200cسازی مهره\u200cهاست\nو حمله زمانی مؤثر است که این مرحله به\u200cدرستی انجام شده باشد.\n🔴\nشطرنج سخت نیست اگر\nقدم به قدم\nو\nاصولی\nیاد گرفته شود.'}, {'id': '8757586284003975640-1781036297759-2029119805', 'date': '1781036297759', 'text': 'B×c5\nQ×c5\nA×b4\nجوابش اینه\n👆'}, {'id': '7901605133832628233-1781036310647-2029119805', 'date': '1781036310647', 'text': 'افرین به کسایی که درست گفتند'}]}

>>>

# نکته: هر پیام یک شناسه دارد با آن شناسه می توان آخرین پیام را شناسایی کرد(در خزش ها کاربرد دارد)

```