Songify Token & Ko-fi Integration Guide

This guide explains how to obtain your Songify API token and link your Ko-fi account for premium features.

🎵 What is a Songify Token?

A Songify token is a secure API key that allows the Songify desktop application to communicate with your account and access premium features. Each user gets a unique token that's used to authenticate requests to the Songify API.

🔑 How to Obtain Your Songify Token

Step 1: Create an Account

1. Visit the Songify website
2. Click "Login" or navigate to the account page
3. Click "Login with Twitch" to authenticate using your Twitch account
4. Grant the necessary permissions when prompted

Step 2: Generate Your Token

1. After logging in, you'll be redirected to your Account page
2. Scroll down to the "Security" section
3. Click the "Generate new secret token" button
4. A confirmation dialog will appear asking: "Are you sure you want to generate a new token? Your old token will stop working."
5. Click "Generate" to confirm

Step 3: Copy Your Token

1. A popup will appear with your new token
2. Important: Copy this token immediately - it will only be shown once!
3. Click "Copy Token" to copy it to your clipboard
4. Store it securely (you'll need it for the Songify desktop app)

Step 4: Configure Songify Desktop App

1. Open your Songify desktop application
2. Go to Settings/Configuration
3. Paste your token in the API token field

⚠️ Important Token Security Notes

• Never share your token with anyone
• Store it securely - treat it like a password
• Generate a new token if you suspect it's been compromised
• Only one token is active per account - generating a new one invalidates the previous one

☕ Ko-fi Account Linking (Premium Features)

Ko-fi integration provides access to premium Songify features. Here's how to link your Ko-fi account:

Prerequisites

• An active Ko-fi subscription
• A verified Ko-fi account with the same email you'll use for linking

Step 1: Link Your Ko-fi Account

1. On your Account page, find the "Ko-Fi" section
2. Click the "Link Ko-Fi" button
3. Enter the email address associated with your Ko-fi account
4. Click "Validate"

Step 2: Verification Process

• The system will check if your email has active Ko-fi support/subscriptions
• If found, your account will show "active" status
• If not found, your account will show "inactive" status

Step 3: Check Your Status

After linking, you'll see one of these statuses:

• Active: ✅ You have active Ko-fi support

  • Shows expiration date: (until YYYY-MM-DD)
  • Premium features are unlocked

• Inactive: ❌ No active Ko-fi support found

  • Premium features are locked
  • You may need to verify the email matches your Ko-fi account

🛠️ Troubleshooting

Token Issues

Problem: "Invalid token" or authentication errors Solution:

1. Generate a new token from your account page
2. Update the token in your Songify desktop app
3. Restart the Songify application

Problem: Token not working after generation Solution:

1. Ensure you copied the complete token (no extra spaces)
2. Check that your Songify app is updated to the latest version
3. Verify your internet connection

Ko-fi Linking Issues

Problem: Ko-fi shows "inactive" despite having active support Solutions:

1. Email Mismatch: Ensure the email you entered exactly matches your Ko-fi account email
2. Recent Support: Make sure your Ko-fi subscription is recent (within the last month)
3. Webhook Delay: Ko-fi webhooks may take a few minutes to process - try again later

Problem: Can't find the "Link Ko-Fi" button Solution:

1. Make sure you're logged in to your account
2. Refresh the page
3. Check that you're on the correct account page

Account Access Issues

Problem: Can't log in with Twitch Solutions:

1. Check that your Twitch account has the necessary permissions
2. Clear your browser cookies and try again
3. Ensure the callback URL is correctly configured
4. Try using an incognito/private browser window

📞 Support

If you encounter issues not covered in this guide:

1. Check the troubleshooting section above
2. Contact us through the Songify Discord Server

Remember: Keep your token secure and only share it with the official Songify desktop application!