Troubleshooting

Start here when something in the web app does not behave as expected.

A Source Does Not Finish

Wait a little longer for long videos, large pages, or pages with many links.

If the source stays unfinished:

  • check that the URL opens in a private browser window;
  • make sure the page does not require login;
  • try the canonical article URL instead of a search result or redirect URL;
  • for YouTube, check that the video has captions or a transcript;
  • try adding the content as pasted text if the page blocks extraction.

No Fragments Appear

First clear filters. Strict score filters can hide every fragment.

Then check the source status:

  • processing means Knowlume is still working;
  • waiting means processing is paused and should resume later;
  • failed means the source could not be processed.

If a source failed, try a simpler or more direct source URL.

A Source Looks Low-Value

This can be a correct result, not a failure.

Some videos, podcasts, and articles contain mostly introductions, opinions, stories, or generic advice. In that case Knowlume may show very few strong fragments.

Try this:

  • inspect the strongest two or three fragments;
  • lower thresholds briefly to confirm the source is not being over-filtered;
  • if nothing useful appears, skip the source instead of forcing an export.

Fragments Look Too Generic

Lower the export volume rather than exporting everything.

Use these checks:

  • keep fragments that are specific, useful, or clear enough to verify;
  • skip fragments that repeat the article title in different words;
  • prefer fragments with clear context and evidence;
  • raise originality or sourcesness thresholds after the first pass.

The score model is explained in Fragments, Scores, And Export.

Export Does Not Contain What You Expected

Exports use the saved selection.

Before exporting:

  1. Select the fragments you want.
  2. Save the selection.
  3. Check the selected fragment count.
  4. Export Markdown.

If an old export downloads, use the latest export action after saving the current selection.

Webhook Delivery Does Not Arrive

First confirm that a normal file export works.

Then check:

  • the webhook URL is still active;
  • the receiving service accepts incoming requests;
  • the destination did not reject the payload;
  • the webhook was configured before the export was created.

If the content is important, keep file download enabled as a backup.

API Requests Fail

Check the basics first:

  • the API key is active;
  • the request uses Authorization: Bearer ...;
  • source submission includes an idempotency key;
  • the source status is succeeded before reading fragments or exporting.

See Integrations And API for the supported flow.

Slides, Formulas, And Specialized Terms

YouTube processing depends heavily on what is available in the transcript. If a formula, diagram, or slide is visible but not spoken, it may not appear in the extracted text.

For specialized material:

  • prefer sources with readable text, captions, or transcripts;
  • add article or document sources when they contain the exact terminology;
  • check important fragments manually before exporting;
  • expect proper names and technical terms to need review.