A collection of Pyrogram plugins made by the community

Pyrogram Smart Plugins allow users to create and easily share modular framework's components with minimal boilerplate code. This repository is meant to collect awesome Pyrogram plugins.

• Create a new folder in your working directory (e.g.: plugins).
• Download and copy the desired plugin(s) into your plugins folder.
• Enable plugins in your Client by telling Pyrogram to search on your folder with plugins=dict(root="plugins"):

  from pyrogram import Client
  
  app = Client("my_account", plugins=dict(root="plugins"))

• Done! Run your client with app.run(), the plugins will be automatically loaded.

More details

• Understand how Smart Plugins work.
• Create an awesome plugin.
  • Make a folder for your plugin and choose a meaningful name.
  • Create a python file named the same inside your plugin folder.
  • If necessary, create a requirements.txt file and add all the dependencies your plugin needs.
• Open a new Pull Request to propose adding your plugin inside the plugins directory.
  • Make sure you add a proper license and your name to it.
  • Also edit the readme to add the plugin in the list below.

You found a bug on a plugin or want to extend one? Or maybe you have ideas on how the plugin system can be improved? That's great! Open a new GitHub Issue and let's discuss about it.