Getting Started

Getting Started

한국어

This guide will help you install and set up ivLyrics on your Spotify client.

---

System Requirements

• Spotify: Desktop version (Windows, macOS, or Linux)
• Spicetify: Latest version installed
• Internet Connection: Required for lyrics fetching and AI translation

---

Installation

Step 1: Install Compatible Spotify Version

The latest Spotify version from the official website may not be compatible with Spicetify. Install a compatible version using the following methods:

If you already have Spotify installed, please uninstall it first.

Windows

Open PowerShell and run:

iex "& { $(iwr -useb 'https://amd64fox.github.io/Rollback-Spotify/run.ps1') } -version 1.2.76.298-x64"

macOS

Open Terminal and run:

bash <(curl -sSL https://raw.githubusercontent.com/jetfir3/TBZify/main/tbzify.sh) -v 1.2.76.298

Manual Download

• Windows: https://loadspot.pages.dev/?os=win&build=release&search=1.2.76.298
• macOS: https://loadspot.pages.dev/?os=mac&build=release&search=1.2.76.298

---

Step 2: Install Spicetify

Skip this step if Spicetify is already installed.

Do not run as administrator.

Windows

iwr -useb https://raw.githubusercontent.com/spicetify/cli/main/install.ps1 | iex

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/spicetify/cli/main/install.sh | sh

When asked about installing Marketplace, enter Y. The FullScreen extension from Marketplace provides an enhanced experience with ivLyrics.

---

Step 3: Install ivLyrics

Restart PowerShell or Terminal if you just installed Spicetify.

Automatic Installation (Recommended)

Windows

iwr -useb https://ivlis.kr/ivLyrics/install.ps1 | iex

macOS / Linux

curl -fsSL https://ivlis.kr/ivLyrics/install.sh | sh

Use the same command to update ivLyrics.

Manual Installation

1. Download the latest release from GitHub Releases
2. Extract and rename the folder to ivLyrics
3. Copy the folder to Spicetify CustomApps directory:
   • Windows: %LocalAppData%\spicetify\CustomApps
   • macOS/Linux: ~/.config/spicetify/CustomApps
4. Run the following commands:

   spicetify config custom_apps ivLyrics
   spicetify apply
   

---

Uninstallation

Windows

iwr -useb https://ivlis.kr/ivLyrics/uninstall.ps1 | iex

macOS / Linux

curl -fsSL https://ivlis.kr/ivLyrics/uninstall.sh | sh

---

Initial Setup

1. Launch Spotify and select ivLyrics from the left sidebar
2. Click the Settings button in the bottom right corner
3. Go to the AI Providers tab and configure your preferred AI service
   • API keys can be obtained for free from services like Google AI Studio
4. Play music and hover over the lyrics area to reveal the conversion buttons
5. Click the translation or phonetic button to enable the desired mode

---

Next Steps

• Basic Usage - Learn how to use ivLyrics
• Features Guide - Explore all features
• Settings - Customize your experience