FoliCon Help

API Keys

FoliCon uses three external APIs to fetch metadata, artwork, and icons. You need to provide your own API keys or credentials for these services.

Setup API Keys

The Movie Database (TMDB) is used for movies, TV shows, and anime search in Poster Mode.

How to get a TMDB key

  1. Go to themoviedb.org and create a free account.

  2. Navigate to your profile Settings, then open the API section.

  3. Click Request an API Key and choose the Developer option.

  4. Fill out the required form details.

  5. Copy the API Read Access Token (v4 auth).

  6. In FoliCon, paste the key into the TMDB field of the API Keys settings.

TMDB API Read Access Token location

The Internet Game Database (IGDB) is used for game search in Poster Mode. It requires a Twitch Developer account.

How to get IGDB credentials

  1. Go to the Twitch Developer Console and log in.

  2. Click Register Your Application.

  3. Set the OAuth Redirect URL to http://localhost.

  4. Select Application Integration for the Category and submit.

  5. Copy the Client ID and generate/copy the Client Secret.

  6. In FoliCon, paste both the Client ID and Client Secret into the corresponding IGDB fields.

Twitch Developer Console Client ID and Secret

DeviantArt is used for Professional Mode browsing and downloading user-created icons.

How to get DeviantArt credentials

  1. Go to the DeviantArt Developers Portal.

  2. Click Register Application.

  3. Set the OAuth2 Redirect URI to https://localhost.

  4. Submit the form to get your Client ID and Client Secret.

  5. In FoliCon, paste both into the DeviantArt fields.

DeviantArt Developer Application Credentials

Managing Keys in FoliCon

You can access the key management panel from Menu Bar | Settings | Setup Wizard. The first-launch wizard also displays this panel to help you get started quickly.

API Keys settings in FoliCon

Troubleshooting

  • Service Unavailable: If a service shows 'unavailable' after entering a key, double-check for extra spaces when copying the key.

  • Weekly Download Limits: DeviantArt may show weekly download limit warnings. This is a DeviantArt-side limit on your account, not an issue with your API key.

  • Re-entering Keys: To update or re-enter a key, open the API Keys panel, clear the field entirely, paste the new key, and save.

30 August 2026