Installation : MacOS - C0untFloyd/roop-unleashed GitHub Wiki

Step-by-step Installation Guide for Roop-Unleashed on macOS using Homebrew


One-Click Install

Simply run the following command. It will check and install all dependencies if necessary.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/PJF16/roop-unleashed/master/installer/macOSinstaller.sh)"

After that run:

runMacOS.sh

1. Install Homebrew

Homebrew is a package manager that makes installing software on macOS easy. Follow these steps to install Homebrew:

Step 1: Open the Terminal

You can find the Terminal app using Spotlight (press Cmd + Space, then type "Terminal").

Step 2: Install Homebrew

Run the following command in your Terminal to install Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Follow the instructions provided by the script to complete the installation.

Step 3: Verify Homebrew Installation

Once installed, verify by running:

brew --version

If installed correctly, this will display the installed Homebrew version.


2. Install Python

Roop-Unleashed requires Python to run. To install Python via Homebrew:

brew install python

After installation, verify by running:

python3 --version

3. Install FFmpeg

FFmpeg is required for video processing. Install it using Homebrew:

brew install ffmpeg

4. Clone Roop-Unleashed Repository

Navigate to a directory where you'd like to install Roop-Unleashed.

Then, clone the repository from GitHub:

git clone https://github.com/C0untFloyd/roop-unleashed.git

5. Create a Virtual Environment

It is a good practice to use a virtual environment for Python projects. You can set it up as follows:

Step 1: Install virtualenv (if not already installed)

pip3 install virtualenv

Step 2: Create the Virtual Environment

Inside the cloned repository folder, create a virtual environment:

cd roop-unleashed
python3 -m venv venv

Step 3: Activate the Virtual Environment

Activate the virtual environment with:

source venv/bin/activate

6. Install Roop-Unleashed Dependencies

With the virtual environment active, install the required Python dependencies:

pip install -r requirements.txt

7. Run Roop-Unleashed

Now that everything is set up, you can run roop-unleashed by executing:

python run.py