English · Français · Español · Deutsch

BazLoader

BazLoader is based on the original BULLOADER, a 3D-printed electric airsoft BB loader published on MakerWorld by its original author. You pick how many BBs you want, and the loader stops on its own once that many have gone through, counted one by one by an infrared beam. You set it on the loader itself (a knob and a small OLED screen) or from an Android web app over Bluetooth. Everything works offline: no account, no cloud, no network needed on the field.

The app in demo mode, driving a simulated loader.

Links

• Docs: https://karnak19.github.io/bazloader/en/ (French: https://karnak19.github.io/bazloader/)
• The app: https://karnak19.github.io/bazloader/app/. No loader yet? Open /app/?mock to try it against a simulated device.
• Parts list: https://karnak19.github.io/bazloader/en/liste-des-pieces/
• Wiring: https://karnak19.github.io/bazloader/en/cablage/
• BLE protocol: https://karnak19.github.io/bazloader/en/protocole-ble/

The app has moved. The project was renamed BazLoader and the app now lives at the address above. If you installed it from the old address, uninstall it and install it again once from the new link. Your presets and calibration are stored on the loader, so nothing is lost.

Where it stands

This is a work in progress, and it has not been built on real hardware yet.

• Done: the firmware and the app work end to end in simulation, with fake BBs (M1, M2).
• In progress: hardware integration, meaning the real servo, the real IR beam and calibration (M3), and the printed parts plus the build guide (M4).

There are no photos of a finished build and no accuracy numbers yet. Follow along in the milestones and issues.

What you need

• A printed BULLOADER to upgrade, and the parts in the parts list (ESP32-C3 SuperMini, IR LED and phototransistor, encoder, OLED, and a few small bits).
• For the app: Chrome on Android, because it uses Web Bluetooth. iPhone and iPad aren't supported: Safari has no Web Bluetooth. The loader works fine without a phone.

What's in the repo

Folder	What it is	Build / check
firmware/	ESP32-C3 firmware, PlatformIO + Arduino	pio run (real IR), pio run -e sim (fake BBs), pio test -e native (logic tests)
web/	One Astro site: the docs, and the app at /app/ (Preact)	bun install, bun run dev, bun test, bun run build
cad/	Parts designed from scratch in build123d (IR sensor collar, etc.)	uv run python build.py (writes STL/STEP to cad/out/), uv run python check.py

Each folder has its own README with the details. BRIEF.md is the full spec (in French).

License

The code in this repo and the parts designed here from scratch are under the MIT license.

The original BULLOADER is under the MakerWorld Exclusive License. Its files, and the remixed control panel made from them, are not in this repo and never will be. The remix will be published on MakerWorld only, crediting the original.