Installation

Installation

MiniFy is available for Windows, macOS, and Linux. Choose your platform below and follow the installation instructions.

Download

Get the latest release from GitHub:

Windows

Download .msi Installer

macOS

Download .dmg

Linux

Download .deb / .rpm / .AppImage

Platform-Specific Instructions

Windows

1. Download the installer

   Go to the GitHub Releases page and download the .msi installer for Windows.

2. Run the installer

   Double-click the downloaded .msi file and follow the installation wizard.

   ┌─────────────────────────────────────────────────┐
   │  MiniFy Setup                                   │
   │                                                 │
   │  Welcome to the MiniFy Setup Wizard            │
   │                                                 │
   │  This will install MiniFy on your computer.   │
   │                                                 │
   │              [ Next > ]  [ Cancel ]            │
   └─────────────────────────────────────────────────┘

3. Launch MiniFy

   Find MiniFy in your Start Menu and launch it.

4. Authenticate with Spotify

   Click “Connect to Spotify” and authorize MiniFy to access your account.

Note

Windows Defender SmartScreen: You may see a warning because MiniFy is a new application. Click “More info” → “Run anyway” to proceed. MiniFy is open source and safe.

System Requirements (Windows)

Requirement	Value
OS	Windows 10 or later (64-bit)
WebView	WebView2 (usually pre-installed)
RAM	50MB minimum
Disk	10MB

macOS

1. Download the DMG

   Go to the GitHub Releases page and download the .dmg file for macOS.

2. Mount and install

   Open the DMG file and drag MiniFy to your Applications folder.

   ┌───────────────────────────────────────────────────────────────┐
   │                                                               │
   │     [ MiniFy.app ]    ───────────▶    [ Applications ]       │
   │                                                               │
   │         Drag to install                                       │
   │                                                               │
   └───────────────────────────────────────────────────────────────┘

3. Launch MiniFy

   Open MiniFy from your Applications folder or Spotlight (⌘+Space → “MiniFy”).

4. Authenticate with Spotify

   Click “Connect to Spotify” and authorize MiniFy to access your account.

macOS Security

On first launch, macOS may show a security warning because MiniFy isn’t signed with an Apple Developer certificate.

To bypass:

1. Try to open MiniFy (you’ll see a warning)
2. Open System Settings → Privacy & Security
3. Scroll down and click “Open Anyway” next to the MiniFy message
4. Click Open in the confirmation dialog

System Requirements (macOS)

Requirement	Value
OS	macOS 10.15 (Catalina) or later
Architecture	Intel or Apple Silicon
RAM	50MB minimum
Disk	10MB

Linux

1. Download the package

   Go to the GitHub Releases page and download the appropriate package:

   Distribution	Package
   Debian/Ubuntu	.deb
   Fedora/RHEL	.rpm
   Other	.AppImage

2. Install the package

   Debian/Ubuntu:

   sudo dpkg -i minify_*.deb
   sudo apt-get install -f  # Install dependencies if needed

   Fedora/RHEL:

   sudo rpm -i minify_*.rpm

   AppImage (universal):

   chmod +x MiniFy_*.AppImage
   ./MiniFy_*.AppImage

3. Launch MiniFy

   Find MiniFy in your application menu or run from terminal:

   minify

4. Authenticate with Spotify

   Click “Connect to Spotify” and authorize MiniFy to access your account.

Linux Dependencies

MiniFy requires some system libraries. If you encounter issues, install:

# Debian/Ubuntu
sudo apt install libwebkit2gtk-4.1-dev libssl-dev

# Fedora
sudo dnf install webkit2gtk4.1-devel openssl-devel

System Requirements (Linux)

Requirement	Value
OS	Ubuntu 18.04+ or equivalent
Desktop	GNOME, KDE, or other GTK-compatible
Keyring	GNOME Keyring or KDE Wallet
RAM	50MB minimum
Disk	10MB

Post-Installation Setup

After installation, you’ll need to connect MiniFy to Spotify:

┌───────────────────────────────────────────────────────────────────────────────┐
│                         First-Time Setup Flow                                  │
├───────────────────────────────────────────────────────────────────────────────┤
│                                                                                │
│   ┌────────────────┐                                                          │
│   │  Launch MiniFy │                                                          │
│   └───────┬────────┘                                                          │
│           │                                                                    │
│           ▼                                                                    │
│   ┌────────────────────────────────────────┐                                  │
│   │  Click "Connect to Spotify"             │                                  │
│   └───────┬────────────────────────────────┘                                  │
│           │                                                                    │
│           ▼                                                                    │
│   ┌────────────────────────────────────────┐                                  │
│   │  Browser opens → Log in to Spotify      │                                  │
│   │  → Click "Agree" to authorize           │                                  │
│   └───────┬────────────────────────────────┘                                  │
│           │                                                                    │
│           ▼                                                                    │
│   ┌────────────────────────────────────────┐                                  │
│   │  Success! MiniFy shows your music       │                                  │
│   └────────────────────────────────────────┘                                  │
│                                                                                │
└────────────────────────────────────────────────────────────────────────────────┘

Build from Source

If you prefer to build MiniFy from source, see the Building Guide.

Verifying the Installation

After installation, verify everything works:

1. Launch MiniFy - The app should open without errors
2. Connect to Spotify - Authentication should complete successfully
3. Check playback - If Spotify is playing, MiniFy should show the track
4. Test controls - Press Space to toggle play/pause

Troubleshooting

Common Installation Issues

Windows

“Windows protected your PC” message

• Click “More info” → “Run anyway”
• MiniFy is open source and safe to run

Installer fails

• Run as administrator
• Check that WebView2 is installed
• Download WebView2 from Microsoft

macOS

“MiniFy is damaged and can’t be opened”

• Open Terminal and run: xattr -d com.apple.quarantine /Applications/MiniFy.app
• Or use the System Settings method described above

“MiniFy cannot be opened because the developer cannot be verified”

• Right-click the app → Open → Open
• Or adjust Security settings as described above

Linux

“libwebkit2gtk not found”

# Debian/Ubuntu
sudo apt install libwebkit2gtk-4.1-dev

# Fedora
sudo dnf install webkit2gtk4.1-devel

AppImage won’t run

chmod +x MiniFy_*.AppImage
# If still failing, try with FUSE:
sudo apt install fuse libfuse2

Keyring issues

• Ensure GNOME Keyring or KDE Wallet is running
• Try: gnome-keyring-daemon --start --components=secrets

Authentication Issues

• Can’t connect to Spotify: Check your internet connection
• Browser doesn’t open: Ensure you have a default browser configured
• Redirect fails: Make sure no other app is using port 3000

Uninstalling

Windows

1. Open Settings → Apps → Installed Apps
2. Find MiniFy and click Uninstall
3. Follow the uninstall wizard

Remove all data:

Remove-Item -Recurse "$env:APPDATA\MiniFy"

macOS

1. Drag MiniFy from Applications to Trash
2. Empty Trash

Remove all data:

rm -rf ~/Library/Application\ Support/MiniFy

Linux

Debian/Ubuntu:

sudo apt remove minify

Fedora:

sudo dnf remove minify

Remove all data:

rm -rf ~/.config/MiniFy

Next Steps

Quick Start

Get up and running →

Features Overview

Explore all features →

Customize Themes

Make it yours →

Build from Source

Developer guide →