Skip to content

Installation Guide¶

🚀 Quick Install¶

pip install motify-music

🐳 Docker Install¶

docker pull mosh3eb/motify
docker run -d -p 8000:8000 mosh3eb/motify

📦 From Source¶

git clone https://github.com/mosh3eb/motify.git
cd motify
pip install -e .

System Requirements¶

💻 Hardware¶

2GB RAM minimum
1GB free disk space
Internet connection

🔧 Software¶

Python 3.8 or higher
pip package manager
FFmpeg (for audio processing)

📱 Supported Platforms¶

Windows 10/11
macOS 10.15+
Linux (most distributions)

Detailed Instructions¶

Step 1: Prerequisites¶

Install Python 3.8 or higher from python.org

Install FFmpeg:

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows
choco install ffmpeg

Verify installations:
```
python --version
ffmpeg -version
```

Step 2: Install Motify¶

Install using pip:
```
pip install motify-music
```
Verify installation:
```
motify --version
```

Step 3: Configuration¶

Run Motify first time:
```
motify
```
Follow the setup wizard
Configure Spotify credentials
Set download preferences

Troubleshooting¶

Installation fails with dependency error

Make sure pip is up to date:

pip install --upgrade pip

Then try installing again.

FFmpeg not found

Ensure FFmpeg is in your system PATH or specify its location in settings.

Spotify authentication fails

Check your credentials and ensure you have a valid Spotify account.