VoidPen user guide

Overview

VoidPen is a desktop app for long-form fiction: each novel has a workspace; chapters use Markdown. Configure an OpenAI-compatible API in Settings for streaming continuation; the local vector store holds characters, lore, and hooks so context stays aligned across chapters.

Runs on Windows, macOS, and Linux. Data stays on disk—ideal for long serials and your own backups.

Install & launch

1. Download the installer for your platform from the homepage (links as published).
2. Follow the OS prompts; on first launch, allow the app in security settings if asked (e.g. macOS).
3. Configure the API in Settings, then create or open a novel workspace.

Novels & workspaces

Each novel maps to a dedicated folder. Switch works in-app; metadata and vectors are isolated per novel.

• When creating or opening a novel, choose a folder and fill in title, POV, target length, etc. (fields as shown in-app).
• Use one folder per novel for easier sync and backups.

Chapters & Markdown

Chapters are files under your project; body text uses Markdown for structure and version control.

• Open or create chapters in the editor with headings, lists, and other Markdown as you prefer.
• After continuation, save generated text into the chapter file following your folder layout.

Connecting AI (OpenAI-compatible)

In Settings, set Base URL, API key, and model name. OpenAI-style APIs work with major clouds and self-hosted endpoints.

• Keep keys private. This app has no backend and does not upload your keys.
• If your provider needs a custom path or proxy, follow their docs for Base URL.
• Capabilities and pricing vary by model—see your provider.

Streaming continuation

Start continuation on a target chapter; output is streamed for live reading. Language can follow the novel or the current task, including Chinese, English, and more.

• Use in-app stop/cancel controls if you need to interrupt a stream.
• Review generated text before publishing.

Local vector store

Import characters, worldbuilding, or outlines—or build the index from chapters. Embeddings can run locally; models cache on disk and do not use the chat API.

At write time, relevant snippets are retrieved and sent as context so the model remembers characters, lore, and hooks.

Data & folders

Typical layout (exact names may vary by version):

• chapter/: generated chapter content.
• .novel-data/: novel metadata and vector data.

Back up your workspace folder regularly to avoid data loss.

Subscription

Website pricing is indicative in USD; free vs paid limits, checkout, and payment links are defined in-app. Check orders and status inside the app after purchase.

FAQ

Cannot reach the API?

Verify Base URL, key, and model; check network/proxy and provider restrictions.

Weak retrieval?

Add more lore text, adjust what you index, or confirm embedding models downloaded correctly.

Moving to another computer?

Copy the whole workspace folder and open it in VoidPen on the new machine.