Troubleshooting

Answers to the problems people hit most: the chat will not connect, sources are missing, slides overflow, windows behave oddly.

The chat says "Connect the assistant"#

No project id and key are saved. Open Settings › Agent, paste both, press Save, then Test connection. The chat updates as soon as the values are saved. See Connect the assistant.

Test connection fails#

401 or "unauthorized": the key is wrong or was revoked. Create a new key under API keys on Oberik and paste it again.
Origin not allowed: the project does not allow http://127.0.0.1:3005. Run npm run skills:publish from a checkout of the app's repository; it allows the origin along with uploading the skill pack.
No model: the project has no provider or no default model. Add one under LLM & limits on Oberik.

The assistant does not follow the deck conventions#

The skill pack was not published to the project. See Publish the skill pack once.

Sources are listed but the assistant cannot find them#

Rows with an Index button are files on disk that were never indexed. Press Index or Index N files.
failed rows did not index; press Retry. Scanned PDFs without a text layer need document processing enabled on the project.
Sources indexed under another Subject are invisible to the current one. Set the subject back, or index the files again.
The unit's sources are searched only when that unit is open; the course chat sees the course and shared sources.

Slides overflow#

Press Check slides. Red badges are slides whose content runs past the edge. Split the slide, shorten the text, or lower the size in the deck's style: block. The Tighten the slides starter has the assistant do it.

An image does not show#

Amber badges are missing images. The path is relative to the deck: ./assets/name.png for the unit's assets folder. Check the file name and case; the app's preview and marp-cli both care.

The file changed on disk#

Changed on disk, reload appears when the open file was written by the assistant, another app or a pull while the editor had unsaved edits. Reload to take the disk version, or save to keep yours. See Library sync.

A course does not appear#

The folder is hidden: Settings › Library › Hidden folders › Show again.
The folder is archived: open the Archived group at the bottom of the library.
The folder is nested: courses must be top-level folders of the library. Move it up, or Import… it.
Nothing helped: View › Refresh Library (⌘R).

The presentation opened on the wrong screen#

The audience window goes to the first screen that is not the main screen. Set the projector as a secondary display in System Settings › Displays, not as the main one, then start again.

Presenting on a single screen auto-hides the menu bar and the Dock. Ending the presentation restores them; if the app was force-quit while presenting, launch it once more and end normally.

Gatekeeper blocks the app#

Releases from 0.1.1 are notarized. If macOS reports that the app is damaged or from an unidentified developer, the download is incomplete or from an old release: verify the checksum and download again. See Install.

Where to report a bug#

github.com/ekremcet/lecture-studio/issues. Include the version (from the About window), macOS version, and what the working panel or the steps disclosure showed if the assistant was involved.