Skip to main content

Autosel is a Python package that automates sending emails, Whatsapp text, images, videos, and audio messages along with other functionalities like creating a group and spam bot.

Project description

Autosel

Autosel is a Python package that automates sending emails, Whatsapp text, images, videos, and audio messages along with other functionalities like creating a group and spam bot.

Libraries Used: Selenium, gTTS
 


Main Features

  1.   Bolding Functionality in Emails
    • Specific Parts of an Email can now be bolded using autosel.
  2.   Spam Bot in Whatsapp
    • Using autosel, we can send a message multiple times (spam) to a user(s).
  3.   Audio Sender in Whatsapp
    • Text messages can now be sent as voice clip using autosel
  4.   automate sending all types of media in Whatsapp in Whatsapp
    • Using autosel, we can automate sending Text, Images, Videos, Documents, and Audio Clips.
  5.   Group Creator in Whatsapp
    • Process of creating a group and adding participants, and sending invites is automated by autosel

 


Table of Contents


Prerequisites

  • Chrome Driver
    Download the suitable version of your chrome driver from here which is similar to the version of your Chrome browser. The Chrome version can be found in Settings/About Chrome

  • Selenium

     pip install selenium
    
  • gTTs

    pip install gtts
    

Installation

  • Using PIP
    pip install autosel 
    
  • Using Conda
    conda install autosel
    

What Classes are present in this Library?

Email Class

A. Description

This Class automates the process of sending E-mails to multiple recipients. Using the sender_mail and sender_password credentials as input along with mail_subject and mail_body as input, Mails can be sent to Multiple recipients individually.

There's an additional functionality of Bolding the content in the body. This feature can be used by alternatively giving the texts in the mail_body list with normal and bold texts [ "Normal text1", "Bold Text 1", "Normal text 2", "Bold Text 2" ....]

Note:

  • To input Multiple lines of string, use triple quotes.
  • It is advised to use organization-specific sender_email that (or) gmail that aren't created on this device to avoid security issues with Google verification.

B. What Methods do we Offer?

C. Importing and assigning Email class

  • Importing the Email Class

    from autosel import Email
    
  • Assign Email Class to a Class Variable:
    The Email Sender Class takes inputs as sender_email, sender_password, mail_subject, mail_body

    The Bolding Functionality can be use in body of the Email by alternatively giving the texts in mail_body variable as shown below.
    [ "Normal text1", "Bold Text 1", "Normal text 2", "Bold Text 2" ....]

    Input Parameters:

    sender_email      : str, Mail ID of the sender
    sender_password : str, Password of the sender
    mail_subject      : str, Subject of the Email
    mail_body           : list, List of stings alternatively given with Normal and bolding texts.

    var = Email(sender_email= "abc@gmail.com", sender_password= "12345678", mail_subject= "Hello World!", mail_body= ["""This is a Normal Text, ""","""This is a Bolded Text"""])
    

D. Methods

  • send_mails

    This method automatically sends emails to the recipients.
    Mails can be sent to Multiple recipients individually by adding their names in the emails list.

    Input Parameters:

    driver_path: str, Chrome Driver Address.
    emails         : list, List of Emails to which emails are to be sent.

    var.send_mails(driver_path= "", emails= ["",""]) 
    

    Demo : To watch a quick demo, Click here


Whatsapp Class

A. Description

B. What Methods Do we have?

C. Importing and assigning Email class

  • Importing the Whatsapp Class

    from autosel import Whatsapp
    
  • Assign Whatsapp Class to a variable

    To initialize the chrome driver and to login got whatsapp. The usage_data_directory is used to store the QR code information to avoid multiple scanning.

    Input Parameters :

    driver_address           : str, Address of Chrome Driver.
    usage_data_directory : str, Stores data to help logging multiple times seamless by passing QR code.

    Code:

    var = Whatsapp(driver_address="", usage_data_directory= "")
    

D. Methods

  • spam_bot

    • This method is used to send repeated texts (Spam) to the same person.
    • Messages can be sent to Multiple recipients also by the contact names in name list.

    Input Parameters :

    name  : list, Names of the person to whom these messages are to be sent.
    msg    : str, Message.
    count : int, Number of Messages.

    Code :

    var.spam_bot(name= ["",""], msg= "", count=)
    

    Demo : To watch a quick demo, Click here


  • send_text

    • This method is used to automatically send messages to the recipient.
    • Multiple messages can be sent by adding messages into the msg list.
    • The same set of images, videos can be even sent to Multiple people by adding names into the name list.

    Input Parameters :

    name    : list, List of all contacts to which it should be sent in string format.
    msg      : str, Message to be sent.
    select : bool, Confirm if a particular command should be there on not. It has a Default Value true

    Code :

    var.send_text(name= ["",""], msg= "")
    

    Demo : To watch a quick demo, Click here


  • send_image

    • This method is used to automatically send image or video to the recipient.
    • Multiple Images, Videos can be sent by adding the file address with extension in the file_address list.
    • The same set of images, videos can be even sent to Multiple people by adding names into the name list.
    • Accepts all formats of image and videos.

    Input Parameters :

    name                : list, List of all contacts to which it should be sent in string format.
    files_address : list, Contains strings of address of files to be sent stored in list.
    select             : bool, Confirm if a particular command should be there on not. It has a Default Value true

    Code :

    var.send_image(name= ["", ""], files_address= ["",""], select: bool = True)
    

    Demo : To watch a quick demo, Click here


  • send_document

    • This method is used to automatically send files as documents to the recipient.
    • Multiple Documents can also be sent to the recipient by adding the files address in file_address list.
    • This same set of documents can be even sent to Multiple people by adding names into the name list.
    • Accepts all formats.

    Input Parameters :

    name                : list, List of all contacts to which document should be sent.
    files_address : list, Contains strings of address of files to be sent stored in list.
    select             : bool, Confirm if a particular command should be there on not. It has a Default Value of true

    Code :

    var.send_image(name= ["", ""], files_address= ["",""], select: bool = True)
    

    Demo : To watch a quick demo, Click here

  • send_audio

    • This method converts the given message into an audio recording and will send to the recipient.
    • The audio file can be sent to multiple recipients by adding recipients into name list.

    Input Parameters:

    name         : list, List of all contacts to which it should be sent in string format.
    msg           : str, Stores the message in string format.
    file_name : list, Name of the Audio File.
    file_dir   : str, name of file directory.
    select      : bool, Confirm if a particular command should be there on not. It has a Default Value of true

    Code :

    var.send_audio(name= ["", ""], files_address= ["",""])
    

    Demo : To watch a quick demo, Click here


  • create_group

    • This method is used to create a whatsapp group.
    • Using the contact names given in group_list and group name in group_name the whatsapp group is made.

    Input Parameters:

    group_list : list, Stores the list of names(str) to be added in group in a list.
    group_name : str, Name of the group.
    text_dir    : str, This is an alternate way of giving the list of group members and the group name by storing in a .txt file. Each line in the text file denotes one contact name and teh name at the end of text file denote Group name. Default filename is take as group_name.txt in the project directory

    Code :

    var.create_group(group_list= ["",""], group_name= "")
    

    Demo : To watch a quick demo, Click here


  • close_whatsapp

    • This method is used to close the running chrome driver.

    Input Parameters: None

    Code :

    var.close_whatsapp()
    

License

MIT

Contact

Made with <3 from unKNOWN-G

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autosel-0.0.6.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

autosel-0.0.6-py3-none-any.whl (11.6 kB view details)

Uploaded Python 3

File details

Details for the file autosel-0.0.6.tar.gz.

File metadata

  • Download URL: autosel-0.0.6.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.4.2 requests/2.25.1 setuptools/52.0.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.5

File hashes

Hashes for autosel-0.0.6.tar.gz
Algorithm Hash digest
SHA256 2a350e8f962ce23855eee3826aab5b2c5ae12463bed96d99ff29a404fc3b4962
MD5 60e772c3eff20e902d94f9b1fc06174d
BLAKE2b-256 6db3626a53424db52e9aa36c67d512362c44b8fd70ec39c156629a656ed00bb8

See more details on using hashes here.

File details

Details for the file autosel-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: autosel-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 11.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.4.2 requests/2.25.1 setuptools/52.0.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.5

File hashes

Hashes for autosel-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 007e1d972125fb84282cc5fff382eccc743076b7b6d9ad88550f2af4232a5b9b
MD5 a86c5d3e47f0f9ca8f5e23042f274a86
BLAKE2b-256 efd8b78be4324c8425667bd5869c6c24ce234120e49dd90f4447d89591935c30

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page