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:
virtualenv
(if not already installed)
Step 1: Install 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