aiodot 1.0.0

Async Python client for MyDot.one social platform

aiodot 🚀

Async Python client for MyDot.one social platform
Build bots, automation, and tools with ease.

---

aiodot is an asynchronous Python library for MyDot.one. Built with aiohttp — fast, async-first, session-based like aiogram.

---

✨ Features

• ⚡ Async-first — Built on aiohttp
• 💾 Session persistence — Login once, auto-loads next time
• 🔄 Auto token refresh — Handles 401 gracefully
• 📦 50+ endpoints — Full API coverage
• 🎯 Type hints — Full type annotations

---

📦 Installation

pip install aiodot

---

💡 Quick Start

import asyncio
from aiodot import MyDotClient

TOKEN = "your-token"  # F12 → Cookies → __Secure-access_token

async def main():
    async with MyDotClient(token=TOKEN, session_file="user.session.json") as client:
        me = await client.get_me()
        print(f"@{me.username}")

        dot = await client.create_dot("Hello aiodot! 🚀")
        print(dot.url)

asyncio.run(main())

---

🤖 Echo Bot

import asyncio
from aiodot import MyDotClient

TOKEN = "your-token"

async def main():
    processed = set()
    async with MyDotClient(token=TOKEN, session_file="bot.session.json") as c:
        print(f"🤖 @{(await c.get_me()).username} started!")
        while True:
            for n in (await c.get_notifications(10)).get("results", []):
                if n.get("id") in processed: continue
                processed.add(n.get("id"))
                if n.get("type") == "mention":
                    d = n.get("dot", {})
                    if d.get("id"):
                        await c.reply(d["id"], "Hello! 🤖")
            await asyncio.sleep(15)

asyncio.run(main())

---

📖 API Reference

Category	Methods
Profile	get_me(), update_profile(), set_visibility()
Dots	create_dot(), get_dot(), reply(), repost(), quote(), like(), bookmark(), edit_dot(), delete_dot()
Social	follow(), unfollow(), block(), unblock(), mute(), unmute()
Users	search_users(), get_user_followers(), get_user_following(), get_user_dots()
Feed	home_feed(), following_feed(), follow_suggestions()
Notifications	get_notifications(), mark_all_read(), get_notification_preferences()
Trending	get_trending_hashtags(), get_trending_media()

---

⚠️ Disclaimer

Unofficial library. Use responsibly per MyDot.one Terms of Service.

---

📡 Community

• 📢 Telegram: @aiodotlib
• 💬 Bale: ble.ir/aiodot
• 🌐 Website: karbaladev.ir

---

📄 License

MIT © karbaladev.ir