Settings
Open Settings from the gear icon in the header. The left sidebar lists all panes; click one to navigate to it. Use the search field at the top to jump directly to any setting by name.
Theme, layout, and plugin defaults.
Choose Light, Dark, or System. System follows your OS dark-mode preference and updates automatically without restarting the app. The toolbar sun/moon icon also toggles between light and dark on the fly.
Controls how wide plugin cards are in the catalog grid:
| Option | Min column width | Best for |
|---|---|---|
| Compact | 200 px | small screens, many plugins at once |
| Comfortable | 260 px | default — recommended |
| Spacious | 320 px | large monitors, easy scanning |
Controls how plugins are arranged in the catalog:
- Flat — all plugins in one unsorted list
- By category — grouped into Camera, Filament, Screen, etc.
- Number formatting — inferred from your locale unless overridden
- Date & time — preview of your locale's date format
- First day of week — Monday or Sunday
- Units — Metric or Imperial (affects temperatures, lengths, and weights shown in plugin metadata)
Pre-fill values that apply every time you open a plugin's install panel. For example: set your Spoolman server address once and it appears pre-filled whenever you install the Spoolman Bridge — you can still change it before installing.
Values are stored locally and never sent anywhere. They apply only to plugins that declare a configuration field.
Bespok3d detects your system locale on first launch and uses it. Pick a different language from the list to switch immediately — no restart needed.
Each language in the list shows a progress ring indicating how much of the UI is translated. Untranslated strings fall back to English.
Click the pencil icon next to any language to edit its strings in-app. Download the resulting JSON and submit it to the project. The contribute link in the pane explains where to send it.
A list of all configured printers with their current status. Each row shows the printer's icon, nickname, model, IP address, adapter, and daemon version. Date lines below the name show when the printer was enrolled, when the daemon was last updated, and (if applicable) when it was deactivated.
Click the Enrolled [date] link to open the full enrollment log for that printer.
Actions available depend on the printer's current status:
| Action | Available when | What it does |
|---|---|---|
| Enroll | Online (not yet managed) | Opens the enrollment wizard |
| Update daemon | Managed | Re-uploads the daemon binary; preserves cert, plugins, and enrollment date |
| Deactivate | Managed | Soft-disables Bespok3d — stops plugins and removes autostart without deleting files |
| Reactivate | Deactivated | Restores everything — re-inserts config hooks, starts daemon, re-applies plugins |
| Remove Bespok3d | Managed | Permanently removes the daemon, all plugins, and the workspace (cannot be undone) |
| Trash icon | Any | Removes only the app's local record — nothing is changed on the printer |
Click Add printer in the top-right corner of this pane (or in the main header). Discovered printers appear automatically; use the Manual tab to enter an IP address directly.
GPG key management. See the Keys page for full details.
Connect or manage your GitHub and Gitea accounts. See Git Hosts for full details.
Controls how Bespok3d fetches and trusts plugins.
- Verify package signatures — on by default. When enabled, the app rejects any plugin package whose GPG signature does not match the publisher's key. Disabling this lowers your security bar and is not recommended.
Choose which release channels you receive plugins from:
| Channel | Cadence | Default | Description |
|---|---|---|---|
| LTS | Quarterly | on | Long-term support. Thoroughly tested. |
| Stable | Bi-weekly | on | Production-ready releases. |
| RC | Weekly | off | Release candidates. Mostly stable — some rough edges. |
| Testing | Daily | off | Early access builds. May have known issues. |
| Experiment | Ad-hoc | off | Proof-of-concept. Expect breakage — do not use on printers you need. |
The Bespok3d Official source is bundled with the app and cannot be removed. Third-party sources (community-curated signed catalogs) can be added here. Custom source support is coming in a future update.
A read-only view of all printer adapters bundled in this version of the app. Each adapter card shows:
- Adapter ID and display name
- Supported printer model(s) and vendor
- Version
- Environment variables the adapter defines (the paths and defaults it uses on that printer)
Adapters are currently bundled with the app. Third-party adapter loading from a repo is on the roadmap.
Version number, release notes link, documentation link, issue tracker, and the license (AGPL-3.0).
