SnapBot

SnapBot is a simple automation tool for interacting with Snapchat using Puppeteer. This bot logs into a Snapchat account, captures a snap with a caption, takes a screenshot, and sends the snap to specified contacts. It also includes a logout feature for switching accounts without closing the browser.

Here’s what it can do:

• Auto Login: No more manually logging in! It handles the login process for you every time, saving you time and effort.
• Multiple Accounts: Got more than one account? No worries! The bot can handle multiple Snapchat accounts and keep streaks going for all of them simultaneously.
• Snapstreak Maintenance: The bot will make sure your streaks never break again! It sends snaps on time and ensures that your streak is always intact.
• Custom Captions: The bot lets you send snaps with captions of your choice. You can even integrate APIs to make your snaps more dynamic! For example, you could connect a quote API to send daily motivational quotes, or a sports API to automatically send live football match scores. The possibilities are endless! ⚽📜

Installation

1. Clone the repository:

git clone https://github.com/Emmanuel-Rods/SnapBot

2. Navigate to the project folder:

cd SnapBot

3. Install the necessary dependencies:

npm install

4. Copy the .env.example file to create a .env file:

cp .env.example .env

5. Open the .env file and add your Snapchat credentials:

USER_NAME=<Your Snapchat Username>
USER_PASSWORD=<Your Snapchat Password>

Usage

To run the bot, use the following command:

npm run bot

This command will start SnapBot, logging into Snapchat, capturing a snap, and sending it to your specified contacts.

Methods

The following methods are available in SnapBot:

• launchSnapchat({ headless }): Opens Snapchat in a browser, set to visible with { headless: false }.
• login(credentials): Logs into Snapchat using the provided credentials.
• captureSnap({ caption }): Takes a snap and applies a caption.
• screenshot({ path }): Saves a screenshot of the current screen state.
• send(recipients): Sends the snap to the specified recipients:
  • "BestFriends" for best friends,
  • "friends" for all active friends and best friends,
  • "groups" for group chats.
• wait(milliseconds): Pauses the script for a specified duration.
• logout(): Logs out of the current Snapchat account, allowing you to log in with another account without closing the browser.
• closeBrowser(): Closes the browser session.