FURINACLANK CHAT ATELIER
DOCUMENTATIONTroubleshooting
Browse Guides
? TROUBLESHOOTING

Something broke. What exactly?

Choose the symptom below for the shortest first-pass checklist. If that does not solve it, the deeper sections explain what to inspect next.

START HEREFurina is missing
  1. Confirm the extension is enabled in your browser.
  2. Confirm you are on a supported Clank chat route.
  3. Reload the Clank tab.
  4. If you just reloaded or updated the extension, reload the tab again so the page gets the new extension context.
01
INSTALLATION

The browser cannot load Furina.

MANIFEST NOT FOUNDSelect the folder containing manifest.json.

When you use Load unpacked, choose the extracted Furina folder itself — not the directory above it and not the ZIP file.

ZIP SELECTEDExtract first.

Chromium's Load unpacked workflow expects normal extension files on disk.

OLD BUILD STILL ACTIVEReload the extension.

After replacing files, use the browser extension page's reload control and then reload the Clank tab.

WRONG PAGEOpen a Clank conversation.

The normal chat launcher is intentionally tied to supported chat routes rather than appearing everywhere on the site.

02
PANEL & STATE

The launcher exists, but Furina feels stale.

1Close and reopen the Furina panel

Useful for a one-off UI state issue.

2Reload the Clank page

Rebuilds Furina against the current page DOM.

3Reload the extension

Use this after updating files or when the extension context was invalidated.

4Then reload the Clank page again

An already-open page cannot automatically use a content-script context that was destroyed by an extension reload.

!
“Extension context invalidated” usually means the page still has an old extension instance.

Reload the browser extension, then refresh the affected Clank tab. The message is about the extension runtime context, not automatically evidence that your saved Furina data was erased.

Global vs This Chat can make a setting look “wrong.”

If one conversation looks different from the rest, check Theme Scope before assuming the theme failed to save.

03
BACKGROUNDS

Image or live wallpaper problems.

IMAGE DOES NOT LOADUse a direct, browser-accessible image URL.

A webpage URL that merely contains an image is not the same thing as the image file itself.

LIVE WALLPAPER DOES NOT LOADUse a direct video source that the browser can play.

Sites can block hotlinking, require authentication or return HTML instead of a playable media file.

LOOP HAS A HITCHCheck the source clip.

Short videos whose first and last frames are visually compatible tend to produce the least noticeable loop transition.

EFFECT LOOKS TOO SUBTLECheck darkness, blur and color settings.

A heavy overlay can hide grading and parallax. Extreme blur can also make movement difficult to notice.

04
MUSIC & AMBIENCE

The player is there, but there is no sound.

1Interact with the page once

Browsers can restrict autoplay until a user gesture has occurred.

2Check Furina volume and play state

Make sure the source is loaded, the player is not paused and volume is above zero.

3Verify the source type

Direct audio, SoundCloud and YouTube use different playback paths.

4Test the source itself

If the external source is unavailable or embedding is blocked, Furina cannot make that source playable.

Autoplay is controlled by the browser.

Furina can request playback, but browser media policies still decide whether audio is allowed to start without interaction.

05
ALTERNATE INTERFACES

Visual Novel or Phantom looks incomplete.

NO VN BEATSReturn to normal chat and verify the conversation is readable there.

Visual Novel Mode builds its local sequence from the current conversation source rows. Upstream DOM changes or unusual message structures can affect parsing.

WRONG / MISSING PORTRAITSpeaker portrait data may not be available.

Group-scene portrait matching depends on speaker names and scene-member information Furina can resolve.

NEW MESSAGE NOT VISIBLERefresh or reopen the interface.

The alternate interface may need to rebuild its local representation after the source chat changes.

SEND FAILSExit the interface and test the normal Clank composer.

Furina deliberately relies on the real composer/send flow. If Clank's own composer is unavailable, the alternate composer cannot safely bypass it.

06
DIAGNOSTICS

When the simple fixes are not enough.

FULL ATELIER → ADVANCEDDiagnostics

Use Furina's diagnostics when you need to inspect what the extension believes it can see on the current Clank page.

FURINA DIAGNOSTICSchat route ............. detectedcomposer ............... foundconversation ........... activerenderer ............... ready
!
Before a reset, export anything important.

Theme, Full Setup, Story Bible and Miyabi profile exports exist so you can preserve useful state before destructive troubleshooting.

07
TECHNICAL BOUNDARIES

Know what Furina cannot promise.

Furina canRestyle the local Clank interface.Store its own per-conversation data.Prepare Director / Continuity context for outgoing messages.Present the current chat through alternate local interfaces.
Furina cannotIncrease the model's real context window.Change Clank's backend memory.Guarantee the AI follows instructions.Turn Scene Snapshots into real server-side chat branches.Make local profile customization visible to other users.
The normal Clank conversation remains the source of truth.

When troubleshooting rendering or alternate-interface behavior, returning to the native chat is the best way to distinguish a Furina presentation issue from the underlying conversation state.

KEEP READING

Check what changed between versions.

The release page keeps the documented version and current download in one place.