SLIC3R(1)

📦 version 1.3.0, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu questing

🎀 SLIC3R(1) — the manual, but make it cute 💅

okay so. welcome to the User Commands corner of the manual, bestie. this is the whole entire page for slic3r, and yes we're doing all of it, no skimming, no skipping, we are thorough in this house. grab a strawberry 🍓 and let's go.

🌸 NAME

slic3r — Slice 3D models into G-Code for 3D-printing

like. it takes your lil 3D model and turns it into instructions your printer can actually read. it's giving translator. it's giving matchmaker. 💖

✨ SYNOPSIS

slic3r [ OPTIONS ] [ file.stl ] [ file2.stl ] ...

that's it. options first, then as many .stl files as your heart desires. 💅

🦋 DESCRIPTION

Slic3r is a STL-to-GCODE translator for RepRap 3D printers, written by Alessandro Ranellucci <aar@cpan.org> — http://slic3r.org/

no cap, that's the whole vibe. it eats STL, it spits G-code. iconic behaviour fr fr. 👑

💖 OPTIONS

okay this is the long part. hydration check. we're going through every single one of these, and i mean every single one. 🫶

🌈 Common options

these are the everyday ones, the ones you'll actually type with your own two hands:

  • --help — prints the usage screen and then dips out. bye! 👋
  • --version — tells you which version of Slic3r you've got, then exits. know your queen. ✨
  • --save <file> — saves your config to the file you name.
  • --load <file> — loads config from the file you name. and here's the cute part: you can use this more than once to pull options from multiple files, stacking them like bracelets. 💅
  • -o, --output <file> — the file your gcode goes to. by default, the output lands in the same directory as the input file, and the filename gets made using --output-filename-format. but if you hand this option a directory instead, the output gets saved under that directory and the filename is generated by --output-filename-format anyway. either way, --output-filename-format is doing the naming. she's the main character of filenames. 🎀

🚫 Non-slicing actions (no G-code will be generated)

heads up bestie: none of these produce G-code. they're side quests, not the main plot.

  • --repair — repairs the STL files you gave it and saves them as <name>_fixed.obj
  • --cut <z> — cuts your input files at the given Z (relative) and exports them as <name>_upper.stl and <name>_lower.stl. chop chop. ✂️
  • --split — splits the shells inside the given STL file into several separate STL files. one becomes many. it's giving mitosis. 🦋
  • --info — spits out info about the file(s) you supplied and exits.
  • -j, --threads <num> — number of threads to use (1+, default: 2). more threads, more zoom. 🏎️

🖥️ GUI options

for when you want the pretty window version:

  • --no-plater — disables the plater tab. gone. not invited. 🙈
  • --gui-mode — overrides the configured mode (simple/expert)
  • --autosave <file> — automatically exports the current configuration to the file you name. she's saving your work without even being asked. we love a proactive queen. 💖

📤 Output options

  • --output-filename-format — the format for output file names. every config option wrapped in brackets gets replaced by its value, and so do [input_filename_base] and [input_filename] (default: [input_filename_base].gcode). plug and play, literally. ✨
  • --post-process — your generated G-code gets processed with the supplied script. and yes, you can call this more than once to run it through multiple scripts, one after another, like a lil assembly line. 🔥
  • --export-svg — exports a SVG file full of slices instead of G-code. different output, same energy. 🎨
  • -m, --merge — if you handed over multiple files, they get composed into a single print instead of being processed one by one. friendship bracelet behaviour. 🫶

🖨️ Printer options

  • --nozzle-diameter — diameter of the nozzle in mm (default: 0.5)
  • --print-center — coordinates in mm of the point to center the print around (default: 100,100)
  • --z-offset — extra height in mm added to vertical coordinates (+/-, default: 0)
  • --gcode-flavor — the type of G-code to generate (reprap/teacup/makerware/sailfish/mach3/no-extrusion, default: reprap)
  • --use-relative-e-distances — turn this on to get relative E values (default: no)
  • --use-firmware-retraction — enables firmware-controlled retraction using G10/G11 (default: no)
  • --use-volumetric-e — expresses E in cubic millimeters and prepends M200 (default: no)
  • --gcode-arcs — uses G2/G3 commands for native arcs. ⚠️ experimental, and not supported by all firmwares, so like, check before you commit. 💀
  • --gcode-comments — makes your G-code verbose by adding comments (default: no)
  • --vibration-limit — limits the frequency of moves on the X and Y axes (Hz, set zero to disable; default: 0)
  • --pressure-advance — adjusts pressure using the experimental advance algorithm (K constant, set zero to disable; default: 0)

🧵 Filament options

  • --filament-diameter — diameter in mm of your raw filament (default: 3)
  • --extrusion-multiplier — change this to alter how much plastic gets extruded. ok real talk: there should be very little need to change this value, and it's only useful to compensate for filament packing (default: 1). so like. don't touch it unless you know why. 💅
  • --temperature — extrusion temperature in degrees Celsius, set 0 to disable (default: 200)
  • --first-layer-temperature — extrusion temperature for the first layer, in degrees Celsius, set 0 to disable (default: same as --temperature)
  • --bed-temperature — heated bed temperature in degrees Celsius, set 0 to disable (default: 0)
  • --first-layer-bed-temperature — heated bed temperature for the first layer, in degrees Celsius, set 0 to disable (default: same as --bed-temperature)

🏃 Speed options

all of these are speeds, all of them are in mm/s unless they're a percentage. yes it's a lot. no we're not skipping any. 🫶

  • --travel-speed — speed of non-print moves in mm/s (default: 130)
  • --perimeter-speed — speed of print moves for perimeters in mm/s (default: 30)
  • --small-perimeter-speed — speed of print moves for small perimeters, in mm/s or % over perimeter speed (default: 30)
  • --external-perimeter-speed — speed of print moves for the external perimeter, in mm/s or % over perimeter speed (default: 70%)
  • --infill-speed — speed of print moves in mm/s (default: 60)
  • --solid-infill-speed — speed of print moves for solid surfaces, in mm/s or % over infill speed (default: 60)
  • --top-solid-infill-speed — speed of print moves for top surfaces, in mm/s or % over solid infill speed (default: 50)
  • --support-material-speed — speed of support material print moves in mm/s (default: 60)
  • --support-material-interface-speed — speed of support material interface print moves, in mm/s or % over support material speed (default: 100%)
  • --bridge-speed — speed of bridge print moves in mm/s (default: 60)
  • --gap-fill-speed — speed of gap fill print moves in mm/s (default: 20)
  • --first-layer-speed — speed of print moves for the bottom layer, expressed either as an absolute value or as a percentage over normal speeds (default: 30%)

🚀 Acceleration options

  • --perimeter-acceleration — overrides the firmware's default acceleration for perimeters. (mm/s^2, set zero to disable; default: 0)
  • --infill-acceleration — overrides the firmware's default acceleration for infill. (mm/s^2, set zero to disable; default: 0)
  • --bridge-acceleration — overrides the firmware's default acceleration for bridges. (mm/s^2, set zero to disable; default: 0)
  • --first-layer-acceleration — overrides the firmware's default acceleration for the first layer. (mm/s^2, set zero to disable; default: 0)
  • --default-acceleration — acceleration gets reset to this value after all the specific settings above have been applied. (mm/s^2, set zero to disable; default: 130)

🎯 Accuracy options

  • --layer-height — layer height in mm (default: 0.4)
  • --first-layer-height — layer height for the first layer (mm or %, default: 0.35)
  • --infill-every-layers — infill every N layers (default: 1)
  • --solid-infill-every-layers — forces a solid layer every N layers (default: 0)

the big one. stay hydrated. 💜

  • --perimeters — number of perimeters/horizontal skins (range: 0+, default: 3)
  • --top-solid-layers — number of solid layers to do for top surfaces (range: 0+, default: 3)
  • --bottom-solid-layers — number of solid layers to do for bottom surfaces (range: 0+, default: 3)
  • --solid-layers — a shortcut for setting the two options right above this one, both at once. lazy girl's dream fr. ✨
  • --fill-density — infill density (range: 0%-100%, default: 40%)
  • --fill-angle — infill angle in degrees (range: 0-90, default: 45)
  • --fill-pattern — the pattern used to fill non-solid layers (default: honeycomb). 🐝
  • --external-fill-pattern — the pattern used to fill solid layers (default: rectilinear)
  • --start-gcode — loads initial G-code from the supplied file. ⚠️ this will overwrite the default command (home all axes [G28]). know that before you do it.
  • --end-gcode — loads final G-code from the supplied file. ⚠️ this overwrites the default commands (turn off temperature [M104 S0], home X axis [G28 X], disable motors [M84]). same energy, be careful. 💀
  • --layer-gcode — loads layer-change G-code from the supplied file (default: nothing).
  • --toolchange-gcode — loads tool-change G-code from the supplied file (default: nothing).
  • --seam-position — position of loop starting points (random/nearest/aligned, default: aligned).
  • --external-perimeters-first — reverses perimeter order. (default: no)
  • --spiral-vase — an experimental option that raises Z gradually when printing single-walled vases (default: no)
  • --only-retract-when-crossing-perimeters — disables retraction when travelling between infill paths inside the same island. (default: no)
  • --solid-infill-below-area — forces solid infill when a region has a smaller area than this threshold (mm^2, default: 70)
  • --infill-only-where-needed — only infills under ceilings (default: no)
  • --infill-first — makes infill happen before perimeters (default: no)

🐢 Quality options (slower slicing)

yes bestie, these cost you time. that's the trade. ⏳

  • --extra-perimeters — adds more perimeters when needed (default: yes)
  • --avoid-crossing-perimeters — optimizes travel moves so that no perimeters get crossed (default: no)

more of this page is coming, don't go anywhere 💖

  • --thin-walls — Detect single-width walls (default: yes).
  • --overhangs — Experimental option to use bridge flow, speed and fan for overhangs (default: yes).

Support material options 🛟

Support material is literally the scaffolding that holds up your overhangs, and these options are how you control it. No cap. 💖

  • --support-material — Generate support material for overhangs. yes queen, it makes the supports ✨
  • --support-material-threshold — Overhang threshold angle (range: 0-90, set 0 for automatic detection, default: 0). It's giving "how steep before we add support" vibes.
  • --support-material-pattern — Pattern to use for support material (default: pillars). Pillars are the default, iconic.
  • --support-material-spacing — Spacing between pattern lines (mm, default: 2.5).
  • --support-material-angle — Support material angle in degrees (range: 0-90, default: 0).
  • --support-material-interface-layers — Number of perpendicular layers between support material and object (0+, default: 3).
  • --support-material-interface-spacing — Spacing between interface pattern lines (mm, set 0 to get a solid layer, default: 0).
  • --raft-layers — Number of layers to raise the printed objects by (range: 0+, default: 0).
  • --support-material-enforce-layers — Enforce support material on the specified number of layers from bottom, regardless of --support-material and threshold (0+, default: 0).
  • --dont-support-bridges — Experimental option for preventing support material from being generated under bridged areas (default: yes). it's experimental so be aware bestie 🫶

Retraction options 🧵

Retraction is when the filament gets pulled back so it doesn't ooze everywhere. These are the dials, periodt. 💅

  • --retract-length — Length of retraction in mm when pausing extrusion (default: 1).
  • --retract-speed — Speed for retraction in mm/s (default: 30).
  • --retract-restart-extra — Additional amount of filament in mm to push after compensating retraction (default: 0).
  • --retract-before-travel — Only retract before travel moves of this length in mm (default: 2).
  • --retract-lift — Lift Z by the given distance in mm when retracting (default: 0).
  • --retract-layer-change — Enforce a retraction before each Z move (default: yes).
  • --wipe — Wipe the nozzle while doing a retraction (default: no).

Retraction options for multi-extruder setups 🎀

  • --retract-length-toolchange — Length of retraction in mm when disabling tool (default: 1).
  • --retract-restart-extra-toolchnage — Additional amount of filament in mm to push after switching tool (default: 0). (yes the flag is spelled exactly like that, iykyk 💀)

Cooling options 🌬️

  • --cooling — Enable fan and cooling control.
  • --min-fan-speed — Minimum fan speed (default: 35%).
  • --max-fan-speed — Maximum fan speed (default: 100%).
  • --bridge-fan-speed — Fan speed to use when bridging (default: 100%).
  • --fan-below-layer-time — Enable fan if layer print time is below this approximate number of seconds (default: 60).
  • --slowdown-below-layer-time — Slow down if layer print time is below this approximate number of seconds (default: 30).
  • --min-print-speed — Minimum print speed (mm/s, default: 10).
  • --disable-fan-first-layers — Disable fan for the first N layers (default: 1).
  • --fan-always-on — Keep fan always on at min fan speed, even for layers that don't need cooling.

Skirt options 👗

  • --skirts — Number of skirts to draw (0+, default: 1).
  • --skirt-distance — Distance in mm between innermost skirt and object (default: 6).
  • --skirt-height — Height of skirts to draw (expressed in layers, 0+, default: 1).
  • --min-skirt-length — Generate no less than the number of loops required to consume this length of filament on the first layer, for each extruder (mm, 0+, default: 0).
  • --brim-width — Width of the brim that will get added to each object to help adhesion (mm, default: 0).

Transform options 🔄

  • --scale — Factor for scaling input object (default: 1).
  • --rotate — Rotation angle in degrees (0-360, default: 0).
  • --duplicate — Number of items with auto-arrange (1+, default: 1).
  • --duplicate-grid — Number of items with grid arrangement (default: 1,1).
  • --duplicate-distance — Distance in mm between copies (default: 0).
  • --xy-size-compensation — Grow/shrink objects by the configured absolute distance (mm, default: 0).

Sequential printing options 🖨️

  • --complete-objects — When printing multiple objects and/or copies, complete each one before starting the next one; watch out for extruder collisions (default: no). bestie this one is giving "collision warning" so be careful 🫶
  • --extruder-clearance-radius — Radius in mm above which extruder won't collide with anything (default: 20).
  • --extruder-clearance-height — Maximum vertical extruder depth; i.e. vertical distance from extruder tip and carriage bottom (default: 20).

Miscellaneous options ✨

  • --notes — Notes to be added as comments to the output file.
  • --resolution — Minimum detail resolution (mm, set zero for full resolution, default: 0).

Flow options (advanced) 💫

  • --extrusion-width — Set extrusion width manually; it accepts either an absolute value in mm (like 0.65) or a percentage over layer height (like 200%).
  • --first-layer-extrusion-width — Set a different extrusion width for first layer.
  • --perimeter-extrusion-width — Set a different extrusion width for perimeters.
  • --external-perimeter-extrusion-width — Set a different extrusion width for external perimeters.
  • --infill-extrusion-width — Set a different extrusion width for infill.
  • --solid-infill-extrusion-width — Set a different extrusion width for solid infill.
  • --top-infill-extrusion-width — Set a different extrusion width for top infill.
  • --support-material-extrusion-width — Set a different extrusion width for support material.
  • --bridge-flow-ratio — Multiplier for extrusion when bridging (> 0, default: 1).

Multiple extruder options 🎨

  • --extruder-offset — Offset of each extruder, if firmware doesn't handle the displacement (can be specified multiple times, default: 0x0).
  • --perimeter-extruder — Extruder to use for perimeters (1+, default: 1).
  • --infill-extruder — Extruder to use for infill (1+, default: 1).
  • --solid-infill-extruder — Extruder to use for infill (1+, default: 1).
  • --support-material-extruder — Extruder to use for support material (1+, default: 1).
  • --support-material-interface-extruder — Extruder to use for support material interface (1+, default: 1).
  • --ooze-prevention — Drop temperature and park extruders outside a full skirt for automatic wiping (default: no).
  • --standby-temperature-delta — Temperature difference to be applied when an extruder is not active and --ooze-prevention is enabled (default: -5).

and that's the whole vibe bestie 💖 this page is from slic3r 1.1.4, dated June 2014, and it's the SLIC3R(1) manual — go slay your prints ✨🫶

📦 where this page comes from