Skip to content

6. FAQ

Jump to bottom
Markus Kuuse edited this page Jun 26, 2025 · 2 revisions

Frequently Asked Questions

1. How often can I run Explo?

Explo is designed to run once a week, ideally on Tuesdays. ListenBrainz updates its recommendations every Monday, so running Explo on Tuesday ensures you're getting the latest recommendations.

  • If you're using the default discovery method (playlist) and using youtube as the only download service, do not run it more than twice per day.
  • For testing or debugging, use the api discovery method instead. It returns fewer songs (25) but is safer for repeated usage.

YouTube API credit usage:

  • playlist mode: ~5000 API credits per run
  • api mode: ~2500 API credits per run
  • YouTube API has a daily quota limit of 10,000 credits.
    → You can monitor usage in your Google Cloud Dashboard.

2. Why can't Explo find my ListenBrainz "Weekly Exploration" playlist?

This usually happens when the playlist hasn't been generated yet. Reasons include:

  • You're running Explo on Monday before the new playlist is generated.
  • The playlist generation is stuck. Check the "Updated" timestamp on the playlist page in ListenBrainz to confirm.

3. Does Explo download duplicate tracks?

Explo checks your configured music system before downloading any new tracks:

  • If the track is already present and Explo can find it, it won’t be downloaded again.
  • If metadata mismatches or Explo can’t identify the track correctly, a duplicate may be downloaded.
Clone this wiki locally