โœฆ DreamApp

Application Settings

Configure the interface, logging, and dependency manager.

General settings

Navigate to Settings -> General to adjust global preferences.

  • General: change the UI theme, language, proxy, and other appearance options
  • Download: choose the default media output directory
  • Log Settings: set log level, individual file size, and retention path
  • Save Path: pick where DreamCreator stores its configuration data
  • Listened: inspect active services, including WebSocket and MCP endpoints
  • Acknowledgments: view acknowledgements for bundled tools and libraries
  • About: manage auto-update, trigger manual update checks, and review version details

Model Provider

Use Settings -> Model Provider to centrally manage LLM providers and model lists used by AI features. Subtitle translation, glossaries, and related tools rely on the providers configured here.

  • Provider list: the left column lists all configured providers. Use the bottom + to create a new provider, - to delete the current one, and Initialize (dangerous) to clear all providers/profiles/model caches and re-import presets. Initialization is only recommended when configurations become inconsistent
  • Basic info:
    • Provider name: editable for custom providers only, so you can distinguish different vendors or environments
    • API Key: the secret key for the selected service, stored locally
    • API Base URL: the base endpoint, for example https://api.openai.com/v1 or a self-hosted compatible gateway. Do not include /chat/completions in this URL
  • Model list: after saving the API Key and Base URL, click Refresh Models to load available models. Use Show more / Show less to control how many items are visible; if refresh fails, double-check network connectivity and credentials
  • Test Connection: click Test Connection to verify that the current provider is reachable and to see how many models are returned. On failure, review the Base URL, API Key, and network environment

Dependency management

Open Settings -> Dependencies to interact with the dependency dashboard. Three actions are available in the upper-right corner:

  • Quick Validate: confirms that required binaries exist, which is useful for spotting accidental deletions
  • Validate: extends the quick check by comparing the installed versions with what DreamCreator expects; this takes longer, so allow a few minutes
  • Check updates: uses the GitHub API to look for new releases. Because GitHub enforces rate limits, repeated requests may be throttled temporarily

If a dependency is missing or outdated, use Repair or Update.

  • Repair: redeploys the bundled binaries to the configured directory, usually finishing almost instantly
  • Update: lets you pick a mirror, downloads the latest binary, validates it, and replaces the active version. Avoid closing DreamCreator during an update to prevent unexpected issues