Filament Library (filament.clu)

The enclosure knows the empty weight of common spools, so it can subtract it and show you how much filament is actually left. That library lives in filament.clu on the SD card.

There are 24 slots. 16 are pre-loaded, leaving 8 for your own spools.

This file works both ways

Unlike data.clu, filament.clu is a two-way sync:

• If it is missing at boot, the enclosure writes it for you from its own library.
• If you register a spool on the touchscreen, the enclosure rewrites the file so the card matches the machine.
• If you edit it and raise filamentRevision, the enclosure imports your version at the next boot.

Adding a spool from the SD card

filament16 = My PLA,205

You do not need to touch filamentCount. The enclosure works out how many entries there are from the highest number present.

Rules

• Names are 15 characters maximum. Longer names get cut off.
• No commas in names, since the comma is what separates the name from the weight.
• Weights are the empty spool weight in grams, not the total weight with filament.
• 24 slots total. Entries past the 24th are ignored.
• Numbering should be contiguous from 0. A gap leaves an empty slot.
• Weights are clamped to between 0 and 100000 g.
• A file with no filamentRevision line is ignored completely.

Weighing a spool yourself

If your brand is not listed, the number you can trust is the one you measure:

1. Finish a spool, or find an empty one of the same type
2. Weigh it on a kitchen scale
3. Add it to filament.clu, or register it on the touchscreen

Manufacturers change spool designs without saying so, and cardboard spools vary by tens of grams between batches, so a measured number beats a published one.

Getting a clean starting file

Put a blank FAT32 card in the mainboard slot and power on. The enclosure writes a correct filament.clu containing whatever library it currently has. That is the easiest way to see your own spool list in file form.

The full file

# =======================================================================
#  CLURA ENCLOSURE - filament library
#  Copy this file to the root of your SD card.
# =======================================================================
#
#  HOW IT WORKS
#  ------------
#  Unlike data.clu, this file works BOTH ways:
#
#    * If it is MISSING at boot, the enclosure creates it from its own
#      library.
#    * If you register a spool on the touchscreen, the enclosure rewrites
#      this file so the card matches the machine.
#    * If you edit it and RAISE filamentRevision, the enclosure imports it
#      on the next boot.
#
#  It is NOT rewritten on every boot. An existing file is left alone
#  unless one of the two events above happens. When the enclosure does
#  write it, it writes back the revision it last applied, so its own
#  exports never look like an edit you made.
#
#  TO ADD A SPOOL BY HAND
#  ----------------------
#    1. add a filament<n> line, continuing the numbering
#    2. RAISE filamentRevision
#    3. power cycle the enclosure
#
#  The number of entries is worked out from the highest n present, so you
#  do not need to touch filamentCount.
#
#  IMPORTANT: filamentRevision must be HIGHER than the number the
#  enclosure last applied, or the file is ignored. In practice the number
#  in this file is the applied one, since both an import and an export
#  leave the two in step, so just read it here and go above it.
#
#  A file with no filamentRevision line is ignored completely.
#  Weights are clamped to 0..100000 g.
#
#  LIMITS
#  ------
#  * 24 slots total. The 16 below are pre-loaded, leaving 8 for you.
#  * Names up to 15 characters.
#  * No commas in names, since the comma separates name from weight.
#  * Weights are the EMPTY spool weight, in grams.
#
# =======================================================================
 
filamentRevision = 1
filamentCount    = 16
 
filament0  = Sunlu,134
filament1  = Prusament,198
filament2  = Bambu Lab,226
filament3  = eSUN,224
filament4  = PolyMaker,194
filament5  = ProtoPasta,80
filament6  = Overture,200
filament7  = Hatchbox,225
filament8  = Amazon Basics,212
filament9  = Colorfabb,202
filament10 = Matter Hackers,215
filament11 = Inland,178
filament12 = FormFutura,184
filament13 = 3D Jake,221
filament14 = GST3D,206
filament15 = Voxel,171
 
# Your own spools go here, continuing from 16. For example:
# filament16 = My PLA,205
# filament17 = Workshop PETG,238

Sharing one card between two enclosures

It works, but know what it does. The file on the card is only rewritten when one of the two machines registers a spool on its touchscreen. Whatever revision is sitting in the file at that point is what the other machine compares against, and it imports if the file’s number is higher than its own.

The practical effect is that one machine’s library replaces the other’s. This is not a merge. To combine two libraries, edit the file by hand so it contains both sets of spools, raise filamentRevision above whatever both machines have applied, and boot each one with the card in.

Troubleshooting

My spool appears in the list but I cannot select it. Your firmware is out of date. This was a bug in early builds where the imported count was not saved. Update the mainboard firmware.

My edit did nothing. Either filamentRevision was not higher than the number the enclosure had already applied, or the file has no filamentRevision line at all, in which case it is ignored completely. The file is read only at boot, so you also need to power cycle.

The name is cut off. 15 characters is the limit.

The weight is wrong or zero. Check for a comma in the name, or a missing comma before the weight.