Diegaosx / CanvaAutomationSuite

CanvaBot: Selenium-based automation scripts for Canva image and video editing. This repository includes Python scripts utilizing Selenium, Beautiful Soup, and other libraries to automate tasks on Canva, such as logging in, changing text and images, and manipulating design elements. Enhance your Canva workflow with these automation tools

CanvaBot

CanvaBot is a Python script designed for automating tasks on Canva, such as login, text and image manipulation, and other actions.

Table of Contents

• Features
• Getting Started
  • Prerequisites
• Usage
  • CanvaBot
  • CanvaImage
  • CanvaVideo
• License

Features

• Automated login to Canva using Google Sign-In.
• Automated editing Image.
• Automated editing Video.
• Uploading and downloading images and videos on Canva.

Getting Started

Prerequisites

• Required Python packages:
  • undetected-chromedriver
  • selenium
  • beautifulsoup4
  • shutil

Usage

CanvaBot

from CanvaBot import CanvaBot

# Create an instance of CanvaBot to automate login
bot = CanvaBot()

The CanvaBot class is initialized to automate the login process on Canva using a preconfigured Google account. It includes methods to connect to Google, open a new browser window, and navigate to the Canva login page.

# Close the CanvaBot instance
bot.Close()

Creating an instance of CanvaBot will only automate login, nothing more.

CanvaImage

The CanvaImage class is a subclass of the CanvaBot class and represents a specialized instance for working with Canva's image workspace. It provides automation features for tasks related to Canva's image editing functionalities.

Initialization

from CanvaBot import CanvaImage

# Create an instance of CanvaImage to automate login to the Canva image workspace
image_bot = CanvaImage()

Upon initialization, the CanvaImage instance inherits the login automation features from the CanvaBot class and navigates to the Canva image workspace.

Actions and Methods

change_text(text: str) -> bool

Change the text content on a Canva design element.

Parameters

• text: The new text content to be set.

Returns

• True if the text change is successful; False otherwise.

Example

success = image_bot.change_text("New Text Content")

change_photo(pictures: str, btn=0) -> dict

Change the photo on a Canva design by uploading and downloading a new image.

Parameters

• pictures: The path to the image file to be uploaded.
• btn (optional): A parameter indicating whether a specific (save) button is clicked or not. 'btn' must be parsed when using this function in an iteration.

Returns

A dictionary containing edited image download link and button click status.

Example

result = image_bot.change_photo("~path/to/your/image.jpg")

Additional Notes

• The CanvaImage class utilizes the CanvaBot functionalities for login and navigation to the image workspace.
• Image-related actions, such as changing text content and uploading images, can be performed using the provided methods.

Closing the Instance

# Close the CanvaImage instance
image_bot.Close()

The Close method is called to quit the Chrome webdriver and close the browser window associated with the CanvaImage instance.

Single use Example

from CanvaBot import CanvaImage

bot = CanvaImage()

change_text = bot.change_text("New Text Content")

change_image = bot.change_photo(".path/to/image.jpg")

print(change_image["imagelink"])

bot.Close()

Used in iteration

from CanvaBot import CanvaImage

texts = ["Former Text Content", "Latter Text Content"]
image_paths = ["path/to/image1.jpg", "path/to/image2.jpg"]
bot = CanvaImage()

for text, image_path in zip(texts, image_paths):
  change_text = bot.change_text(text)
  if not change_text:
    print("Error while changing a text")
    break

  change_image = bot.change_photo(image_path)
  if change_image["imagelink"]:
    # do something with download link
  else:
    print("Error while changing a image")
    break

bot.Close()

CanvaVideo

The CanvaVideo class is an extension of the CanvaBot class and represents a specialized instance for working with Canva's video workspace. It provides automation features for tasks related to Canva's video editing functionalities.

Initialization

from CanvaBot import CanvaVideo

# Create an instance of CanvaVideo to automate login to the Canva video workspace
video_bot = CanvaVideo()

Upon initialization, the CanvaVideo instance inherits the login automation features from the CanvaBot class and navigates to the Canva video workspace.

Actions and Methods

change_video_text(text: str) -> bool

Change the text caption of a video element in Canva, adjusting the font size as needed.

Parameters

• text: The new text to be set as the caption.

Returns

• True if the text caption is successfully changed, False otherwise.

Example

success = video_bot.change_video_text("New Text Content")

change_video(video_path: str, foldername=None) -> bool

Upload a video to Canva, set it as a background, and transfer the edited video to a designated folder.

Parameters

• video_path: The path to the video file to be uploaded.
• foldername (optional): The name of the google drive folder. Should be provided if DriveUpload lines are not commented.

Returns

• True if the video is successfully processed and transferred, False otherwise.

Example

success = video_bot.change_video('~path/to/your/video.mp4', 'custom_folder')

Additional Notes

• The CanvaVideo class utilizes the CanvaBot functionalities for login and navigation to the video workspace.
• Video-related actions, such as changing text captions and uploading videos, can be performed using the provided methods.

Closing the Instance

# Close the CanvaVideo instance
video_bot.Close()

The Close method is called to quit the Chrome webdriver and close the browser window associated with the CanvaVideo instance.

Single Use Example

from CanvaBot import CanvaVideo

bot = CanvaVideo()

change_text = bot.change_video_text("Video Text Content")

change_video = bot.change_video(".path/to/video.mp4")

bot.Close()

Used in iteration

from CanvaBot import CanvaVideo

texts = ["Former Text Content", "Latter Text Content"]
video_paths = ["path/to/video1.mp4", "path/to/video2.mp4"]
bot = CanvaVideo()

for text, video_path in zip(texts, video_paths):
  change_text = bot.change_text(text)
  if not change_text:
    print("Error while changing a text")
    break

  change_video = bot.change_video(image_path)
  if not change_video:
    print("Error while changing a video")
    break

bot.Close()

License

This project is licensed under the MIT License.