How to Install Medusa on macOS

Medusa is an open-source media management system that automatically downloads and organizes your TV shows and movies. In this tutorial, we will show you how to install Medusa on macOS.

Prerequisites

Before we get started, make sure you have the following:

Step 1: Download Medusa

The first step is to download the latest version of Medusa from the official website https://pymedusa.com/. Once the zip file is downloaded, extract it to your preferred location.

Step 2: Create a Virtual Environment

It is always a good practice to use virtual environments for Python projects. We will create a virtual environment for Medusa using the following command:

python3 -m venv medusa_env

This command creates a new virtual environment named medusa_env in the current directory.

Step 3: Activate the Virtual Environment

Once the virtual environment is created, activate it using the following command:

source medusa_env/bin/activate

This command activates the virtual environment, and you should see (medusa_env) in your terminal prompt.

Step 4: Install Required Packages

We need to install some required Python packages before we can run Medusa. Run the following command to install the required packages:

pip install -r requirements.txt

This command installs all the required packages listed in the requirements.txt file.

Step 5: Configure Medusa

Before we start Medusa, we need to configure it. Open the config.ini file in a text editor and modify the settings as per your requirements.

Step 6: Run Medusa

Once the configuration is done, run the following command to start Medusa:

python medusa.py

This command starts Medusa, and you should see the Medusa UI in your web browser at http://localhost:8081/.

Conclusion

That's it! You have successfully installed Medusa on macOS. You can now use Medusa to automatically download and organize your TV shows and movies.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!