Freedify Deployment Guide

🐳 Docker (Easiest - One Command!)

Best for: Anyone with Docker installed. No setup required.

Prerequisite: Install Docker Desktop first.

Just run:

docker run -d -p 8000:8000 biohaphazard/freedify:latest

Then open http://localhost:8000 🎵

💻 Option 1: Localhost (Your Computer)

Best for: Fastest performance, local file access, no cost.

Prerequisites

1. Install Python 3.11: Download Here (Check "Add Python to PATH").
2. Install FFmpeg (Required for transcoding):
   • Windows: winget install ffmpeg via PowerShell.
   • Mac: brew install ffmpeg via Terminal.

Steps

1. Download the code (Clone or ZIP) from GitHub.
2. Open terminal in the folder and install dependencies:

   pip install -r app/requirements.txt

3. Start the server:

   python -m uvicorn app.main:app --host 0.0.0.0 --port 8000

4. Visit http://localhost:8000 🎵

🚂 Option 2: Railway (Premium Cloud Host)

Best for: Faster spin-up times than free tiers.

Steps

1. Fork the Freedify repository to your GitHub.
2. Log in to Railway.app.
3. Click + New Project → Deploy from GitHub repo.
4. Select your forked repo and click Deploy Now.
5. Wait for initialization, then go to Settings → Networking to get your public URL.

☁️ Option 3: Render (Free Tier Alternative)

Best for: Free hosting. Fully supports our new Tidal Hi-Res streaming proxy mesh.

Steps

1. Fork the repo to your GitHub.
2. Sign up for Render.com.
3. Click New + → Web Service → Select your fork.
4. Configure:
   • Build Command: pip install -r app/requirements.txt
   • Start Command: python -m uvicorn app.main:app --host 0.0.0.0 --port $PORT
5. Click Create Web Service.

📱 Option 5: Termux (Android)

Best for: Running directly on your Android phone/tablet without root.

Steps

1. Install Termux from F-Droid.
2. Install dependencies:

   pkg update && pkg upgrade
   pkg install python ffmpeg git rust binutils-is-llvm libuv python-cryptography python-grpcio
   pip install pydantic_core
   pip install -r app/requirements.txt

3. Clone and run:

   git clone https://github.com/BioHapHazard/Freedify
   cd Freedify
   nano .env # (Optional) add API keys here
   python -m uvicorn app.main:app --host 0.0.0.0 --port 8000

4. Open http://localhost:8000 in your phone's browser 🎵

🔑 How to Find Your API Keys

Unlock AI playlists, Drive sync, and Hi-Res audio by finding these keys.

Where to put them?

• Localhost: Create a file named .env in the folder and paste them like KEY=VALUE.
• Railway: Go to the Variables tab in your project dashboard.

🍎 Apple Music Users

Freedify supports Spotify playlist URLs. To import your Apple Music playlists, use a free transfer tool:

Steps: Transfer playlist to Spotify (free account works!) → Copy Spotify URL → Paste in Freedify → Stream in lossless! 🎵