Skip to content

u1-camera-configs

licence release printer stock firmware

A co-repo of Bespok3d plugins for the Snapmaker U1 that publishes its own sub-list.

Plugins:

  • webcam-builtin - Show the built-in MIPI camera in Fluidd & Mainsail.
  • webcam-usb - Show the external USB camera in Fluidd & Mainsail.

Collections (kind:collection, no payload of their own, they install a set of plugins in one go):

  • single-camera - "Single Camera": the built-in camera plus its hardware acceleration.
  • double-camera - "Double Camera": the built-in camera plus a USB camera, both accelerated.
  • watch-and-control - "Watch and Control": the built-in camera plus the on-device screen mirror.
  • watch-and-control-plus - "Watch and Control Plus": both cameras plus the screen mirror and timelapse.

The touchscreen-as-a-camera tile used to be its own plugin here (webcam-screen); it is part of the remote-screen plugin from version 0.1.21 on, so it no longer ships from this repo.

Layout

u1-camera-configs/
  <plugin-id>/          # one plugin = one dir; its name is the manifest .name
    manifest.json
    files/              # payload the daemon places on the printer
    doc/README.md       # rendered in-app; not deployed
  .github/workflows/release.yml
  index.json            # the published sub-list (committed; referenced by main-index lists[])
  dist/                 # build output (gitignored)

Each plugin declares WHAT (a destination class + a restart hook), never a path or a raw command; the printer-side adapter realizes it.

Build locally

Needs Node.js 20+. Builds run through the shared Bespok3d/b3-builder tool:

npm install github:Bespok3d/b3-builder
npx b3-builder build --source ./webcam-builtin --atom-repo Bespok3d/u1-camera-configs
# -> dist/webcam-builtin-<ver>.b3 + dist/webcam-builtin.atom.json

Drop --source to build every plugin in the repo at once.

Releasing

Bump a plugin's manifest.json version and push to main. CI runs the Bespok3d/b3-builder Action over the whole repo, which packs each .b3, cuts a release per plugin, assembles this repo's index.json sub-list as U1 Camera Configs, and registers it in Bespok3d/main-index (lists/<repo>.json). Secrets: MAIN_INDEX_TOKEN (contents:write on main-index) and REGISTRY_SIGNING_KEY (the org registry key the b3-builder Action signs each .b3 and atom with).

Maintainership

These plugins are published and maintained by the Bespok3d org, and several of them repackage or build on upstream source material. If you own the source material a plugin is based on and would rather manage it yourself, you are welcome to contact the org to claim it back. The one condition is that it stays actively maintained: a claimed plugin left to rot will be reclaimed so users are never stranded on an abandoned package.

Licence

Copyright (C) 2026 unlucio and the Bespok3d contributors

This repo ships code from other projects offered under version 3 of the GNU General Public License, with no option to use a later version, so version 3 of that licence covers every file in this repo.

This program is free software: you can redistribute it and/or modify it under the terms of version 3 of the GNU General Public License as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/. The full text is in LICENSE.

Bespok3d's own code elsewhere is AGPL-3.0-or-later. One licence covering this whole repo is a clarity choice, so that nobody has to work out which file carries which terms. Version 3 of the GPL and version 3 of the AGPL may be combined in a single work, and section 13 of each licence says so; what cannot happen is code offered under version 3 of the GPL alone being re-offered under the AGPL.

Bespok3d is a project of the Bespok3d Organisation, which is not a legal entity. Copyright is held by the individual authors named above.

About

Camera setups for the Snapmaker U1: built-in and USB webcam tiles for Fluidd and Mainsail, in single, double and watch-and-control bundles.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages