-
-
Notifications
You must be signed in to change notification settings - Fork 0
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.
Basic startup and privacy preferences.
- Default printer — which printer the app selects when it opens. Choose "None" to open with no printer selected (catalog shows without printer context).
- Show installed-only by default — when enabled, opening a printer skips the full catalog and shows only what's installed on that printer.
- Send anonymous usage data — off by default. No analytics backend is active yet; this toggle has no effect currently.
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 |
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.
- 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)
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 enrollment status. Equivalent to the main sidebar — included here so you can add or remove printers without closing Settings.
Each row shows the printer's nickname, connection status, enrollment state, and an Enroll button if not yet enrolled. Additional actions per row:
| Button | What it does |
|---|---|
| Enroll | Start the enrollment wizard for a not-yet-managed printer |
| History | View the full log from the most recent enrollment |
| Update daemon | Re-upload the daemon binary without re-enrolling (preserves cert and plugins) |
| Recover | Re-enroll and re-apply all installed plugins (use after a firmware update) |
| Remove | Delete the app's local record of the printer (nothing is uninstalled from the hardware) |
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).
Bespok3d - open source under AGPL-3.0. Look mom, custom printer and no SSH.
Get started
Reference
Advanced