Free tools Windows power users keep installed
One-click scans. No signup required.
ThatPainter is reader-supported. When you buy through links on our site, we may earn an affiliate commission. Learn More
PolyDye is a real but experimental modification that adds inkjet color to a Marlin-based FDM 3D printer. It prints a light-colored or translucent filament layer, deposits ink onto its exposed surface, and repeats the process. The result is best understood as inkjet-colored FDM—not a plug-and-play substitute for a professional full-color 3D printer.
For advanced makers, PolyDye is an intriguing way to add image-like surface color without loading a separate filament for every shade. For beginners, production users, or anyone expecting dependable and durable color, its beta software, manual calibration, cartridge limitations, and collision risks make it a demanding project.
What PolyDye actually does
PolyDye mounts an inkjet cartridge system to an existing FDM printer. The FDM printer lays down a light, white, or translucent filament layer; the cartridge moves over the exposed surface and applies ink; then the printer continues with the next layer. Repeating this sequence builds a colored object layer by layer.
#1 Best Overall
- 【More Colors for More Projects】 Multiple compact 250g mini spools provide practical amounts of different colors for small prints, multicolor models, accent parts, and test prints. Explore more colors without filling your shelf with full 1kg spools or leaving large amounts of rarely used colors behind
- 【Easy to Print PLA】 Built for smooth printing with standard PLA profiles, low warping, and dependable layer adhesion. A practical everyday material for beginners and hobbyists making models, toys, decor, prototypes, and utility parts
- 【Neatly Wound for Reliable Feeding】 Precision winding supports smooth, consistent feeding and helps reduce snags and mid-print interruptions. Keep light tension on the filament end while loading or unloading, and secure it before storage to prevent loose loops
- 【Consistent Diameter and Steady Extrusion】 A consistent 1.75mm ±0.02mm diameter supports stable flow, even layers, and clean detail from the first layer to the final layer. Reliable extrusion means less time troubleshooting and more time printing
- 【Fits Most FDM Printers】 Designed for most 1.75mm FDM printers with external, top-mounted, or open spool holders. Each spool measures 140mm in diameter and 36mm in width, with a 53mm center hole. For Bambu Lab AMS or AMS lite, search MakerWorld for a compatible 250g spool adapter before use
The project describes itself as compatible with Marlin 2.0+ printers when a suitable mount is available. Its public files include firmware, printed models, slicer settings, SD-card material, and a Blender plug-in. See the official PolyDye project page and the PolyDye repository.
This is different from multicolor filament printing, where the machine changes between pre-colored filaments. It is also different from painting a finished print, color resin printing, binder-jet printing, and industrial UV-inkjet systems. PolyDye adds color during the FDM process, but it does not turn an ordinary printer into a professionally calibrated color-production machine.
Does PolyDye produce genuinely full-color prints?
It is intended to provide full-color surface coloration, meaning the ink system can represent many colors rather than only the discrete colors of loaded filaments. However, “full color” describes the intended color capability, not a guarantee of professional color gamut, saturation, accuracy, or durability.
The final appearance depends on:
- Whether the filament is white, translucent, or opaque;
- Ink coverage and the number of colored layers;
- Ink-to-model registration;
- Layer height and timing;
- The filament’s surface chemistry and temperature;
- Model geometry, especially overhangs, recesses, undersides, and vertical walls.
The official site uses phrases such as “accurate colours” and “true-to-life colors,” but the available project material does not provide standardized colorimetry, gamut measurements, abrasion testing, UV testing, or long-term durability data. Expect visible FDM layer lines and treat the color as experimental until tested on your own filament and cartridge combination.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Why use ink instead of multicolor filament?
Ordinary multicolor FDM systems are more mature, but they have practical limits. The number of simultaneously available colors is restricted, filament changes take time, and transitions can create purge towers, wipe structures, and substantial material waste.
PolyDye’s attraction is that it can theoretically apply image-like color information without changing filament for every color. That could provide a wider color range and reduce filament purge waste compared with a filament-swapping system.
| Approach | Main advantage | Main drawback |
|---|---|---|
| PolyDye | Potentially broad surface color using an existing FDM printer | Beta hardware, manual setup, uncertain ink behavior, and registration challenges |
| Multicolor filament | More predictable material behavior and a mature workflow | Filament changes, limited loaded colors, and purge waste |
| Painting | Low equipment cost and flexible finishing | Manual labor and less repeatable results |
| Commercial full-color printer | Purpose-built color workflow and greater control | Much higher cost and often proprietary consumables |
PolyDye does not eliminate waste. It substitutes some filament purge waste with ink consumption, calibration prints, failed prints, cartridge maintenance, and potentially longer or more complicated print cycles.
Printer compatibility: Marlin matters
The official compatibility statement is for Marlin 2.0+ printers with a suitable mount. The documented repository release material is Marlin-only; Klipper support was described as still in progress. Do not assume that a Klipper printer will work unless the current repository provides a tested build and instructions.
Recommended Free Tools
A demonstration on an Elegoo Neptune 2 is not proof that every Marlin printer is compatible. Before attempting the modification, check:
Rank #2
- Colorful Variety 4 Pack: Each color weighs 200 g, providing a total of 800 g. Dive into the vibrant world of 3D printing with AMOLEN silk multicolor PLA filament pack, featuring stunning shades. Even small models can display multiple colors
- Silk Dual Color PLA: Experiment with multiple hues without the commitment of larger spools. You can print beautiful multicolors in one PLA filament, perfect for arts, crafts, DIY. Whether you're crafting Easter decorations, designing Halloween costumes, creating Christmas ornaments, or making Valentine’s surprises, this filament delivers stunning results every time
- Precision Printing: Achieve flawless prints with shiny silk dual color PLA filament, engineered for ease of use and exceptional precision. With a product diameter of 1.75 mm and precision tolerance of +/- 0.02 mm, smooth and consistent results
- Smooth and Reliable Printing: Experience smooth printing with AMOLEN silk PLA filament. Good shaping, strong toughness, no bubble, no jamming, no warping, melt well, feed smoothly and constantly without clogging the nozzle or extruder
- After-sales Service: AMOLEN is focused on innovative and better quality 3d printing filaments. Stand behind the quality and performance of our 3D printer filament. Provide professional 3D printing technical guidance and good 24/7 customer service
- Your exact Marlin version and configuration;
- USB communication and motion-controller stability;
- Clearance around the hotend, bed, clips, frame, cable chains, and gantry;
- Whether the printer can safely execute the project’s movement and synchronization commands;
- Whether start G-code, homing, mesh leveling, acceleration, or other routines conflict with PolyDye;
- Whether the build area leaves room for the cartridge holder and cables;
- Whether you can safely modify firmware and recover from a failed update.
The holder must not strike the bed, clips, printer frame, or printed object. A machine that can print the required mounting parts is useful, but that alone does not establish compatibility.
Cartridge compatibility is not universal
“Existing inkjet cartridges” does not mean that any cartridge from any inkjet printer can be installed. The repository credits earlier work involving HP 803 cartridges, including pinouts and sample code. That identifies a project-referenced cartridge family, not a universal replacement recommendation.
Before buying or wiring a cartridge, verify:
- Electrical interface and pinout;
- Compatibility with the PolyDye driver electronics;
- Nozzle behavior and cartridge control requirements;
- Ink formulation, solvent, and drying behavior;
- Whether the cartridge is new, refilled, or electronically locked;
- Replacement availability and cost;
- Whether the ink adheres to the chosen filament rather than beading, bleeding, or remaining wet.
The official project page says PolyDye is not affiliated with any cartridge manufacturer. Do not treat a familiar cartridge brand as evidence that the cartridge is supported.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minutePC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Filament choice controls the result
Reported demonstrations used translucent filament, while the repository references testing on white materials including Creality Hyper Series White and CR-PLA White. White filament can provide a bright base; translucent filament may allow color to accumulate through layers but can also reduce contrast or alter perceived saturation.
Dark filament will generally make inkjet color difficult to see. Gloss, absorption, surface temperature, and polymer chemistry can all affect the result. Water-based inks may behave differently from solvent-based or UV-curable inks. Possible problems include beading, bleeding, slow drying, smearing, and weak adhesion.
The available documentation does not establish a universal ink-and-filament compatibility chart. Test a small sample before committing to a large or functional print. The effect of repeated ink application on interlayer adhesion is also not established, so treat mechanically loaded parts as experimental.
Hardware and parts required
The documented system includes more than a cartridge and a printed bracket. Depending on whether you buy a beta unit or build from public files, the required hardware includes:
PolyDye electronics
- PolyDye main board;
- Cartridge interface board;
- Daughter board;
- Ribbon cable;
- FPC cable;
- Inverted JST power cable;
- USB-C data cable;
- USB-C-to-micro-USB cable where applicable;
- SD card.
Mechanical parts and supplies
- Cartridge holder and printer-specific mount;
- Printed enclosure and mounting parts;
- M3×8 and M3×6 screws;
- Screwdriver and ordinary assembly tools;
- Suitable white or translucent filament;
- A compatible inkjet cartridge;
- Recommended external power supply.
The official assembly guide identifies a Raspberry Pi 5.1 V power supply as the recommended supply and warns against powering the unit from a PC or laptop. Public repository files help with DIY construction, but public availability does not mean every schematic, manufacturing file, or firmware component is complete. The project remains under active development and is aimed at advanced users.
Installation and mounting
The official assembly guide gives this general sequence:
Rank #3
- Cost-Effective Filament Bundle: Get 2 "1kg" spools of PLA filament for the price of 1 with classic black and white color
- Smooth and Stable Printing: Patented design and manufacturing process ensures smooth, clog-free printing
- Durable and Strong: Improved toughness and strength for printing functional parts
- Compatible with Most Printers: Works with 99% of FDM and FFF 3D printers with heated beds
- Renewable Material: Made from starch derived from renewable plant resources for environmental friendliness
- Home the printer.
- Lower the nozzle until it touches or nearly touches the bed.
- Attach the cartridge holder to the hotend mount, leaving the mounting screws loose.
- Position the holder with approximately 1.0–1.5 mm of clearance from the bed.
- Check clearance against clips, the build plate, the hotend shroud, frame members, and cable paths.
- Tighten the mount only after the position is verified.
- Install the cartridge interface board and daughter board.
- Connect the FPC cable with the retainer and orientation correct.
- Install the main board in its enclosure and connect the JST, ribbon, and USB cables.
- Use the recommended external supply rather than a computer USB port.
- Flash or update firmware only as directed by the project’s current instructions.
- Configure Wi-Fi if required, then perform alignment before attempting a full print.
The 1.0–1.5 mm clearance is not a cosmetic adjustment. Too little clearance can cause a collision with the bed or clips; too much can affect registration and ink placement. Move the printer through its travel slowly by hand or at low speed before enabling automatic operation.
Power, firmware, and network setup
The assembly documentation says beta units arrive preflashed, while DIY firmware updates are performed through the SD card using repository instructions. Incorrect flashing can damage the unit, so record the installed version before changing anything.
For network setup, the guide describes entering Wi-Fi credentials in wifi.txt. After inserting the SD card and power-cycling, the interface may be reachable at http://phantom.local. If local hostname resolution fails, use the IP address assigned by the router. These details may change as the project evolves; verify them against the current guide.
The software workflow
PolyDye is not a one-click color-print button. The reported workflow uses several separate stages:
- Prepare or export the colored 3D model.
- Process the model with the project’s color-preparation tools, including the Blender plug-in where appropriate.
- Slice the printable geometry in OrcaSlicer using the project’s settings or profile.
- Generate or copy the inkjet instructions to the PolyDye SD card.
- Install the cartridge and align the ink pattern with the printed object.
- Run a small controlled test.
- Adjust offsets, coverage, and material behavior before printing a larger model.
Keep the model files, slicer settings, firmware version, printer profile, cartridge type, filament type, and offsets together. Reproducing a successful result will be difficult if those variables are not recorded.
Calibration is the central challenge
Color quality depends as much on registration as on the ink itself. The nozzle and inkjet head are physically separated, so the system must know the X/Y relationship between them. Calibration should address:
Quick wins for a faster PC:
Scan for outdated or missing drivers - takes under a minuteDriver Scan →Repair Windows errors before they cause bigger problemsFix Now →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →- Bed clearance and cartridge-to-bed distance;
- X/Y offset between the nozzle and inkjet head;
- Ink-to-model registration;
- Coverage and saturation;
- Layer timing;
- Color behavior on the selected filament;
- Whether the part moves or shifts during the ink pass;
- How to reproduce alignment after removing or remounting the holder.
The repository describes newer alignment changes, including simplified XY alignment and automatic offset handling. Do not copy an offset from another printer or release. A release note identifies YohY=184000 for the relevant version, but that is not a universal calibration constant.
Make the first tests simple: a flat color chart, registration marks, and small geometric samples. Test several ink densities and allow enough drying time before touching the surface. A successful calibration on one filament does not prove that another filament will behave the same way.
Firmware hazards and recovery
The repository’s release notes document serious operational issues. The unit may need to be power-cycled before each print and after stopping an unfinished print. Otherwise, it may continue sending G-code and create a risk of printer damage. Intermittent freezing can also stop a print. The project warns that prints must be monitored.
Rank #4
- 【10 Rolls of 1kg 1.75mm PLA+ Filament, Multiple Color Choices】10 rolls of 1000g SUNLU 1.75mm PLA plus filament. Color: Black+White+Grey+Blue+Green+Orange+Red+PureYellow+GrassGreen+Blue Grey. The design of 1000g PLA+ filament is convenient for customers with multiple color needs. Especially for multi-nozzle 3d printer users and 3d pen users.
- 【SUNLU 100% Wound Neatly Filament】- SUNLU R&D team has mastered advanced technology and produced 100% Neatly Wound PLA+ Filament, which is impossible for other brands. No knot, no winding, improve printing efficiency.
- 【SUNLU PLA PLUS 3D Filament Advantages】- PLA PLUS filament is 10 times stronger than PLA Filament, the color is brighter, it has many advantages, Clog/Bubble/Tangle/Warping/Stringing free, easy to Use, better layer adhesion.
- 【1.75mm Diameter】- Dimensional Accuracy +/- 0.02mm. SUNLU filament has wide compatibility due to the small diameter error, it's suitable for almost all 1.75mm FDM 3D printers.
- 【Spool Diameter】- Spool Diameter: 8.00", Spool Width: 2.50", Spool Hub Hole Diameter: 2.20". The size of the SUNLU filament spool is suitable for hanging on many 3D printers.
One cited release required a ;waitforlevel line after G29 in affected start G-code. Adding that line changed the required Y offset by approximately 5.9 mm. These are release-specific instructions, not universal settings for every future version.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
If motion, communication, or ink behavior becomes abnormal:
- Stop the print if it is safe to do so.
- Power down the PolyDye unit and printer safely.
- Do not immediately restart the interrupted job.
- Power-cycle the PolyDye unit before the next print.
- Check whether the printer continued receiving G-code.
- Inspect the USB, ribbon, JST, and FPC connections.
- Confirm the firmware and repository version.
- Review start G-code, especially bed leveling and any required
;waitforlevelplacement. - Re-run alignment and perform a small test print.
Never leave the system unattended until its failure modes are understood.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Expected print quality
PolyDye may offer a wider visible color range than a system limited to a few loaded filaments, and it can color otherwise ordinary FDM geometry. It may also reduce filament purge waste compared with filament swapping.
It is unlikely to remove the familiar limitations of FDM. Expect layer lines, uneven coverage, and inconsistent color on overhangs, undersides, vertical walls, and recessed regions. Registration errors can create halos or colored edges. Ink may bleed, smear, or remain vulnerable to abrasion. A clear protective coating might help, but the coating itself must be tested for solvent interaction, smearing, and changes in appearance.
No verified data in the available project material establishes abrasion, UV, water, chemical, or long-term color resistance. Avoid presenting PolyDye color as suitable for outdoor, high-touch, or mechanically demanding objects without your own testing.
Major failure modes
Mechanical collisions
The holder can strike bed clips, the build plate, hotend shrouds, frame members, cable chains, or the printed object. Loose or poorly routed cables can also become caught during motion.
Ink and surface problems
Ink can bead, bleed, dry slowly, smear during later passes, clog nozzles, or fail to bond to the filament. An incompatible solvent may affect the plastic. There is no universal ink/filament chart in the cited documentation.
Color durability
The project does not provide verified resistance data for abrasion, UV exposure, moisture, or chemicals. Protective finishing is a possible post-processing step, not a proven cure.
Recommended Free Tools
Best Value
- 【16 Rolls of 250g PLA Plus Filament】- Color: Black, Roasted Chestnut Black, White, Bone White, Grey, Blue, Red, Green, Yellow, Sunny Orange, Lavender Purple, Pink, Wood, Olive Green, Coffee Brown, Transparent
- 【Small Spool Diameter】- Spool Diameter: 140mm(5.5 inches), Spool Hub Hole Diameter: 53mm(2.08 inches), Spool Width: 36mm(1.4 inches). Please pay attention to the filament spool size! Please check if it is compatible with your 3D printer.
- 【PLA Plus Filament Bundle】- The design of 250g PLA+ filament is convenient for customers with multiple color needs. Especially for multi-nozzle 3d printer users and 3d pen users.
- 【SUNLU Wound Neatly Filament】- SUNLU R&D team has mastered advanced technology and produced Neatly Wound PLA+ Filament, which is impossible for other brands. No knot, no winding, improve printing efficiency.
- 【SUNLU PLA PLUS 3D Filament Advantages】- PLA PLUS filament is 10 times stronger than PLA Filament, the color is brighter, it has many advantages, Clog/Bubble/Tangle/Warping/Stringing free, easy to Use, better layer adhesion.
Firmware and G-code errors
Freezing, continued G-code transmission after interruption, incorrect offsets, and incompatible start G-code can turn a failed color pass into a printer collision or damaged hardware. Treat PolyDye as experimental hardware rather than a harmless accessory.
PolyDye versus painting
For a painter or model finisher, PolyDye occupies an unusual middle ground. It can automate some color placement and potentially reproduce image-like patterns, but it still produces an FDM object with layer texture and requires considerable technical calibration.
Painting remains the more flexible choice when surface durability, repairability, or unusual materials matter. A painted print can be primed, sanded, masked, airbrushed, sealed, and touched up with familiar materials. PolyDye is more interesting when the goal is repeatable machine-applied surface color and the maker is willing to accept experimental results.
Alternatives
Multicolor filament systems
These are generally the safer choice for users who want an established consumer workflow, predictable material behavior, and strong color embedded in the printed material. Their costs include filament changes, purge towers, wipe structures, and a limited number of simultaneously loaded colors.
Single-color FDM followed by painting
This is inexpensive, easy to repair, and compatible with many materials. It is slower by hand and less repeatable, but it remains the best option for many decorative and functional objects.
HueForge-style techniques
HueForge-style methods use carefully chosen filament layers and tonal stacking rather than inkjet deposition. They can work well for flat or relief artwork but are not a replacement for PolyDye’s intended all-over surface-color mechanism.
Commercial full-color printers
Purpose-built systems can offer more controlled deposition and software, but they usually cost substantially more and may rely on proprietary materials or cartridges. Compare them by color control, durability, build volume, maintenance, consumables, software maturity, and replacement-part availability—not simply by the phrase “full color.”
Should you buy or build PolyDye?
Consider PolyDye if you already own a Marlin-based printer, enjoy electronics and firmware work, can fabricate custom mounts, are comfortable with calibration, and can monitor every print. It is especially suited to makers who value experimentation more than appliance-like reliability.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Avoid it if you need production consistency, certified or repeatable color, durable outdoor surfaces, a warranty-backed appliance, or unattended printing. It is also a poor fit if you own a Klipper-only printer and do not want to change firmware, cannot safely modify the machine, or expect any ordinary inkjet cartridge to work immediately.
The last reported beta-unit price was $199, in a Hackaday report published on December 28, 2024. That is a historical price signal, not a verified current price. The official page reviewed does not provide a current checkout price or confirmed stock status. DIY total cost also varies with the printer mount, electronics, cartridge, power supply, printed parts, and replacement consumables.
Verdict
PolyDye is a compelling open-source experiment for advanced 3D-printing makers: it can bring inkjet-style surface color to a Marlin FDM printer without requiring a separate filament for every shade. But its “full-color” promise should be read as a capability under development, not as professional color fidelity or durable embedded color.
For most users who simply want dependable colored prints, a mature multicolor filament system or conventional painting workflow remains the safer choice. PolyDye is worth attempting when the project itself—wiring, firmware, calibration, material testing, and troubleshooting—is part of the appeal.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.




