Proffieboard Saber Setup Guide: From Unboxing to First Light (2026)
Technical Guide
Just got a Proffie saber and don't know where to start? This step-by-step guide covers Arduino IDE setup, firmware flashing, and your first sound font — no coding experience needed.
Proffieboard has a reputation as the gold-standard soundboard for neopixel sabers — and a second reputation for being intimidating to set up. Both are deserved. Neither should stop you.
The fear usually comes from the Arduino IDE interface, which looks like a coding tool. It is a coding tool. But what you are actually doing is editing a text file and pressing Upload. If you can copy and paste, you can flash a Proffie saber. This guide covers everything from installing the software to adding your first sound font, written for someone who has never opened Arduino in their life.
1. What Is Proffieboard?
Proffieboard is the open-source soundboard inside your saber's hilt, created by Swedish developer Fredrik Hubinette. It controls everything: blade ignition, SmoothSwing motion tracking, clash detection, sound font playback, and every visual effect on your neopixel blade.
The reason it sits above every other soundboard is simple: it runs ProffieOS, an open operating system you can fully reprogram. Other boards ship with fixed firmware — you choose from what is already there. With Proffie, you write the recipe yourself.
| Version | Key difference | Most common use |
|---|---|---|
| v2.2 | Stable, proven, USB-Micro port | Most installed sabers today |
| v3 / v3.9 | USB-C, more memory, WiFi OTA, WebUSB Chrome support | New builds (2024 onwards) |
If you need to purchase a Proffieboard core board, CCSabers carries both the V2.2 version and the V3.9 version — each comes with a 32GB SD card and is ready for installation.
Not sure which version is inside your saber? Look at the charging port. Micro-USB = v2.2. USB-C = v3 or newer. The setup process is the same for both; differences only appear in a few menu selections inside Arduino IDE, clearly marked throughout this guide.
2. What You Need Before You Start
Everything below is free except the SD card reader, which costs a few dollars if you do not already own one.
Hardware
- ✓ USB data cable — use the cable that came with your saber. Charging cables look identical but carry no data. This is the single most common cause of setup failure.
- ✓ MicroSD card reader — for copying sound font folders directly onto the SD card inside your saber.
- ✓ A computer — Windows or Mac, either works. Windows requires one extra driver step covered in Section 3.
Software (all free)
- ✓ Arduino IDE — the environment that compiles and uploads your firmware. Use the latest version; fall back to 1.8.19 if you hit driver issues.
- ✓ ProffieOS firmware — download from the official GitHub repository. This is the operating system that runs on your board.
- ✓ Proffie DFU Setup — Windows only. A one-time driver installer. Mac users can skip this.
- ✓ Notepad++ or any plain text editor — for editing the config file. Do not use Word or Google Docs; they add invisible formatting that breaks compilation.
3. Arduino IDE Environment Setup
You are doing this once. After the environment is set up, future updates take five minutes.
-
Download and install Arduino IDE
Go to arduino.cc/en/software and download the version for your OS. Run the installer with default settings.
-
Add the ProffieOS board URL
Open Arduino IDE. Go to File → Preferences (Mac: Arduino → Settings). In the "Additional boards manager URLs" field, paste the URL below, then click OK.
-
Install the Proffieboard board package
Go to Tools → Board → Boards Manager. Search for
Proffieboard. Click Install. This downloads everything Arduino needs to communicate with your board. -
Windows only: install the DFU driver
Download and run
proffie-dfu-setup.exefrom the ProffieOS GitHub. Close when complete. Mac users proceed to Step 5. -
Verify the environment
Connect your saber with the data cable. On Windows, open Device Manager and look under "Ports (COM & LPT)" for
USB Serial Device (COMx). On Mac, go to Tools → Port in Arduino IDE and look for/dev/cu.usbmodem. If you see it, setup is complete.
4. Connect Your Saber & Find the COM Port
With the saber connected and powered on, open Arduino IDE and go to Tools → Port. Select the entry that references Proffieboard. This tells Arduino IDE where to send the firmware.
If nothing shows up in the Port menu
- Swap to the cable that came with your saber. Try two or three different cables if you do not have the original.
- Check that the microSD card is fully inserted in the hilt. A missing or loose card causes the board to disconnect immediately after being recognized.
- On Windows: confirm
USB Serial Device (COMx)appears in Device Manager. A yellow warning icon means re-run the DFU driver installer. - Try a direct USB port on the computer. Hubs, keyboard ports, and monitor pass-throughs are unreliable for firmware flashing.
5. Understanding the Config File
The config file is the recipe for your saber. It tells ProffieOS what hardware is connected, how buttons work, and what blade styles and sound fonts to load. It looks like code because it is code — but you only need to understand three fields to get started. Leave everything else at factory defaults.
Open ProffieOS.ino in Arduino IDE and navigate to your config file. Look for these three entries:
132 and 144 are the two most common values for standard 36-inch neopixel blades. Using the wrong number makes the blade light up partially — not harmful, just incorrect. Adjust and reflash.6. Upload the Firmware
Before hitting Upload, confirm these three Tools menu settings. Wrong settings here cause the most common upload failures.
| Tools menu item | v2.2 setting | v3 / v3.9 setting |
|---|---|---|
| Board | ProffieBoard V2 | ProffieBoard V3 |
| USB Type | Serial + Mass Storage | Serial + Mass Storage |
| DOSFS (v3.9 only) | — | SDCARD (SDIO High Speed) |
With the saber connected and the port selected, click the Upload arrow (→) in Arduino IDE. A progress bar appears at the bottom. The compile step takes 30–90 seconds on the first run; subsequent uploads are faster.
Success signal: your saber emits a brief distorted sound and starts up normally. Disconnect the cable.
If the upload fails
- Stuck at 0%: enter bootloader mode manually. Hold the BOOT button, tap RESET while still holding BOOT, then release. Try Upload again immediately.
- Compile error: a red error message appears at the bottom. The most common cause is a config file formatting problem — a missing semicolon or mismatched bracket. Copy the full error text and search it on The Crucible forum; almost every compile error has a documented fix.
- Port disappears mid-upload: SD card connection issue. Reseat the card and try again.
7. Add Your First Sound Font
A sound font is a folder of audio files that gives your saber its personality — the hum, swing sounds, clash, ignition, and retraction. The Proffieboard ships with at least one pre-loaded font. Here is how to add more.
What a sound font folder contains
-
hum.wav— the idle blade sound -
swng1.wav— swing sounds (SmoothSwing V2 uses multiple numbered layers) -
clsh1.wav— clash impact -
boot.wav— startup sound -
in.wav/out.wav— retraction and ignition
How to install a new sound font
-
Remove the microSD card from your saber
Use the card reader to connect it to your computer. You will see the existing font folders already there.
-
Copy the new font folder onto the SD card
Each font lives in its own folder at the root level of the card. Name it without spaces — e.g.
vader_fontnotvader font. -
Register the font in your config file
In the presets section, add a new preset entry referencing the folder name and a blade style. The folder name in the config must match the folder name on the SD card exactly, including capitalization.
-
Reflash the firmware
Reinsert the SD card, reconnect your saber, and upload the updated config following Section 6.
Where to find sound fonts
- Fett263 Style Library — the largest freely available collection of blade styles and compatible fonts. An essential bookmark for any Proffie owner.
- The Crucible (therebelarmory.com) — the main community forum. The font marketplace and free sharing threads are both active.
- ProffieOS GitHub — includes example fonts and the full style editor documentation.
swng1.wav, swng2.wav, etc.) and produce smoother motion tracking. V1 fonts work fine but sound slightly less fluid during slow swings. Most fonts released after 2022 are V2.Once your first font is working, the next step is learning to write blade styles — the code that controls exactly how your neopixel blade looks during every state. That is covered in the next guide in this series.
Proffieboard Setup FAQ
Do I need programming experience to use Proffieboard?
No. Swapping sound fonts and making basic config changes requires nothing more than copying and pasting text. The process in this guide — download, install, edit three values, upload — does not require you to write or understand any code.
Writing custom blade styles from scratch is a different matter: that involves learning the ProffieOS style syntax. But it is entirely optional. The Fett263 style library contains thousands of ready-made styles you can copy directly into your config.
What is the difference between Proffieboard v2.2 and v3 / v3.9?
The core functionality is the same. Both run ProffieOS, support SmoothSwing, and drive neopixel blades. The differences are in convenience features: v3 and v3.9 add USB-C, more onboard memory (which allows more complex blade styles), WiFi-based over-the-air updates, and WebUSB support — meaning you can adjust some settings directly in Chrome without reflashing.
My computer is not recognizing the saber. What should I try first?
In this order: (1) swap to a different cable — this resolves the problem in the majority of cases. (2) Check that the microSD card is fully seated inside the hilt. (3) Try a direct USB port on your computer rather than a hub or keyboard. (4) Windows users: re-run the Proffie DFU installer as administrator.
Can I use Proffieboard with a baselit saber?
Technically yes. But the main value of Proffieboard is its neopixel blade control — scroll ignition, animated blade styles, per-pixel color effects. A baselit blade cannot render any of that. The blade will light up and the sound system will work, but you would be running the most advanced soundboard available with none of its visual capability.
How do I add more sound fonts without reflashing every time?
On v2.2, you always need to reflash to register a new preset in the config file. On v3 / v3.9 with ProffieOS 6+, the WebUSB interface lets you reassign which font plays for a given preset slot without a full reflash — the fastest way to test new fonts once your config has preset slots already built.
Is ProffieOS free? Does it cost anything to update?
Yes, ProffieOS is completely free and open source. Arduino IDE is free. The Proffieboard package inside Arduino is free. Sound fonts vary — community fonts are often free, and professional font makers typically charge $10–$30 per font. The only thing you pay for is the hardware itself.
What happens if I upload a bad config? Can I damage the board?
No. A config with errors will either fail to compile — Arduino IDE catches it before anything is sent to the board — or compile and produce unexpected behavior on the saber. In the second case, fix the config and reflash. The Proffieboard hardware cannot be damaged by a software mistake during flashing.