snapmaker / luban

An easy-to-use 3-in-1 software tailor-made for Snapmaker machines.

Snapmaker Luban

Snapmaker Luban is an easy-to-use 3-in-1 software tailor-made for Snapmaker machines. You can customize the printer settings and control the machine in Luban anytime with ease. The software also provides G-code generation support for 3D models, laser engraving / cutting, and CNC milling.

Our goal is to provide a multi-functional 3D software, while making it as accessible and customizable as possible for new users / beginners.

The software is inspired by cncjs by cheton. We use LunarSlicer for 3D slicing.

How to install and run

Run released applications

You can download latest releases of software under the "Releases" section. It's recommended to use a stable release version unless you want to do some modifications on the source code.

For Linux distros (Debian for example), you may need to run following commands to install dependencies for Luban:

> sudo dpkg --install snapmaker-luban-{version}-linux-amd64.deb
> sudo apt install --fix-broken

Run from source code

Checkout Development to how to run and develop from source code.

Feedback & Contribution

• To submit a bug or feature request, file an issue in github issues.
• To contribute some code, make sure you have read and followed our guidelines for contributing.

Translations

We use crowdin for collaborative translations. We would greatly appreciate your assistance in improving our translations.

Language	Crowdin Link
Ukrainian (Українська)	Ukrainian translations
German (Deutsch)	German translations
Italian (Italiano)	Italian translations
Chinese Simplified (简体中文)	Chinese translations

License

Snapmaker Luban is released under terms of the AGPLv3 License.

Terms of the license can be found in the LICENSE file or at http://www.gnu.org/licenses/agpl-3.0.html.

luban's Issues

Feature Request: Copy/Paste or at least Duplicate in Laser or CNC views

If you're not sure what settings you're supposed to use for laser engraving or cutting something, the recommended procedure is creating a 2D grid of squares, with each row being a different power level, and each column being a different cutting/engraving speed.

It's more important for laser work than CNC work, but if you're CNCing something like MDF or even thick layered cardboard, various cutting and bit speeds can be important for a smooth finish.

Anyway, so far, there is no option for duplicating an object, or selecting more than one to make the process faster. You have to import a Vector, select the file, resize it, position it, and then it all again for the next one.

What would be extremely useful under these circumstances is the ability to duplicate an object, at least by right-clicking the object and having a Duplicate option. Even better would be the ability to select multiple objects so you can copy and paste them, making it easier than ever to make a grid, first by building up a row, then duplicating the row as many times as necessary.

Bug: Override % can go to zero in Touch Screen

This is both a Touch Screen Issue and I believe a Luban issue.
If you set the override speed to zero, your print will stop and since it can never reach the next point you'll be stuck. I had this happen to me over the weekend. Had to restart the machine.

I suggest that some minimum non-zero speed be the lower end of the % scale, 5% maybe.

Miscommunication to controller

Sometimes when I send a command from the console to the controller it echo's back the wrong information. I've had it happen 3 or 4 times now, maybe more. For example, I send a M114 and it echos back "M114 ok" but sends the information from a M105. Here's a screen shot:

This is with firmware 1.7.1.1 and with USB communication on a Mac with 10.14.2 OS.

Feature Request: Enable G-code Macros. M810-M819

I would like to take advantage of the GCODE Macros. I understand you can do some Macros in the Workspace of Luban, I want to use Macros in a GCode file.

M114 doesn't work in a GCODE file.

When I try a M114 in a GCODE file it doesn't show up on the console. I am connected via USB.
At times it seems to trigger a M105 (temperature report) when executed from the console while a GCODE file was executing. I tried a M400 before the M114 but that didn't help. It seems to only work properly when the controller is sitting idle. Definitely a controller issue unless the command isn't making it through the Touch Screen.

Feature Request: Enable G26

G26 lets you print a pattern used to check and validate the leveling mesh.

Complete German translation

German translation should be completed to give more users access to Snapmaker Luban

3.4.2 Console anomaly

When I switched from an enlarged console panel to expanded and then back to small it doesn't show any content. Switching back to large shows the content again. I did do some other things besides that which could have triggered the problem. I open and closed some of the panels on the right. Enlarged the macro panel. I tried switching to running in a browser but couldn't reproduce the problem. Tried restarting, couldn't reproduce. As I think back, when I first opened 3.4.2 for the first time there was nothing in console window, I tried a couple of "v"'s, nothing, switched to expanded and it showed content so that pane must have initialized wrong or something like that.

Feature Request: DXF Offset and Origin

Dear Snapmaker, Luban team
Thank you very much for including the DXF import function for CNC and Laser. Using CAD drawings allows for a lot of accuracies.

Currently (version 3.4.2), the DXF is imported and the origin is set to the center of the drawing extent (MaxX-MinX)/2, (MaxY-MinY)/2. This works great if the drawing was not positioned correctly. However, in some instances, the Drawing has a specific origin, especially when exporting certain layers from a CAD system. Would it be possible to include the option to use the DXF origin (0,0) and put the DXF on the Luban origin of 0,0? I do understand that it is not always a requirement, thus an option to use DXF origin would be appreciated.

Regards
Waldo Minny

Bug: Snapmaker Luban 3.3.3 problem?

Snapmaker fans all over the world
Snapmaker developers

Hello We will report on the following problems than Japan.
I can only use Japanese, so I am using Google Translate to convert to English.
You may be doing the wrong translation.
Please forgive me.

Model: Snapmaker 3-in-1 Original
Firmware: 2.11

https://snapmaker.com/download/snapmaker1
Snapmaker Luban 3.30 x >3.3.3

1. COM1 in the serial port connection is garbled.
2. There are times when the serial port cannot be recognized.
3. The replacement unit cannot be identified automatically after recognizing the serial port.
   With Snapmakerjs, the 3D print head / laser / CNC was automatically identified.
4. The OBJ file cannot be output in G-Code.
   The slicer is 0% and the progress bar is 0 and it is not output.

Are you having this problem?
I hope it will be helpful!

---

Japanese Ver

世界中のSnapmaker ファンの皆様
Snapmaker開発者の皆様

こんにちは日本より下記の問題点について報告をいたします。
私は日本語しか使えないため、Google翻訳を使用して英語に変換しています。
間違った翻訳をしているかもしれません。
お許しください。

使用機種：Snapmaker 3-in-1 Original
Firmware：2.11

https://snapmaker.com/download/snapmaker1
Snapmaker Luban 3.30 x > 3.3.3

1.シリアルポート接続のうちCOM1が文字化けしている。
2.シリアルポート認識ができない時がある。
3.シリアルポート認識後に交換ユニットが自動で判別できない。
　Snapmakerjsでは3Dプリントヘッド/レーザー/CNCは自動判別していた。
4.OBJファイルをG-Code出力ができない。
　スライサーが０％でプログレスバーが０のまま出力されない。

皆さんは、このような問題は発生していますか？
参考になればよいのですが！

Feature Request: Allow manual input of Snapmaker IP address.

Due to network setup or other issues, Luban can not always discover Snapmakers devices on WiFi using the current method. Allow manual entry of the Snapmaker IP address to bypass the problem.

G4 is not interruptible.

I found that the G4 was not interruptible with the "Stop" button of the Touch Display. The only thing I could do was turn off the power supply. I think the Stop function should be able to interrupt anything and everything, similar to having an emergency stop function.

Suggest Export-Import of Custom Settings

It would be great if it was possible to export any customised settings such as custom material or print settings etc to then import them in again. Would be great to be able to install the latest builds and quickly import prvious settings that have been created. I would also serve as a back up if you needed to uninstall and re-install the software for whatever reason.

Improvement: Dutch translation

I'm working on the Dutch translation for Snapmaker Luban.
I'll send a PR when the work is done! :-)

Macro buttons active when there is no connection (on Mac)

They should be inactive until a connection is open. I believe that's the behavior on my Windows 7 machine.

2 Problems with 3.4

1. File names for 3.4 release say 3.3.3
2. After installing x64 windows release on win 10, nothing happens when launching the the application (though upon attempting to uninstall, i am prompted that the application is running). Unstall, try again, same result. Uninstall, go back to 3.3.3, launches fine.

Question: The "others" event callback

Hi @whimsycwd

this.controller.on('others', (res) => {
    this.emitAll('serialport:read', res.raw);

    moveOn(res, false);
});

With the above code, the moveOn() function is called within the "others" event callback. The "others" event will be emitted if the message was not able to parse (see https://github.com/whimsycwd/snapjs/blob/master/src/app/controllers/Marlin/Marlin.js#L349-L351).

May I know for what kinds of messages that need to handle in the "others" callback when running a G-code program? Thank you.

Scale entry boxes control wrong axes

Edited to better describe the actual problem:
The Y and Z labels next to the scale entry boxes do not match with the colors of the axis indicators shown in the G-code generator. The Y label is blue, but the Y axis is indicated with a green line and box. The Z label is green, but the Z axis is indicated with a blue line and box. The colors of the labels in the Move and Rotate tools appear to be correct (X=red, Y=green, Z=blue).

See attached images using scaling of a 10mm cube.

Manual Leveling broken

The mesh is written in the wrong order. Points 1,5,9 are correct, everything else is mirrored about the X=Y line. I understand this is known, I just wanted it in the list to track it's repair.

Feature Request

Integrate with OctoPrint (aka Octopi). There is an interface to upload direct from Cura, but in many ways I find Luban easier to use...if only there was a way to send the GCODE files directly from Luban on my Mac to my Octopi controlling my Snapmaker Original.

OctoPrint's REST API makes this relatively straight forward.

Then can clone Cura's useful authentication interface, as documented on [Youtube] (https://www.youtube.com/watch?v=Gqu3_cwO0e8).

Feature Request: Filament calibration

One of the things I often need to do upon getting new filament is to tweak the settings. In other system, i might do this by building a temperature tower and adjusting the heat (or other settings) at regular Z intervals. Its one of the things keeping me going back to cura. Adding a modify at Z would work, but maybe a less complex option would work as well. A built in temp tower from the case library where you just enter the lower and upper values?

Feature Request: Make the pause for filament change accessible thru GCODE.

For doing multi-color prints and other such custom things it would be good to have the "Pause" feature of the Touch Screen accessible thru a GCODE call. M600? Perhaps all that is needed is the correct syntax for executing it.

Feature Request: Simple text editor as a new Tab in Luban

A new tab that is a simple text editor would be a great addition to the Snapmaker Luban App. Then the user doesn't have to go to some external editor which may introduce bad text formatting. Future versions could do syntax checking and have shortcuts to inserting G & M code commands. All the other tabs could have an option to open the gcode file in the text editor.

Feature Request: Enhance SVG parsing

There are a few tags and attributes in SVG standard are not correctly parsed in Luban.

Below is a checklist of implemented tags:

• <svg>
• <circle>
• <ellipse>
• <line>
• <polygon>
• <polyline>
• <rect>
• <path>
• <g>
• <marker>
• <mask>
• <text>
• <defs>
• <pattern>
• <switch>
• <symbol>

Feature Request: Enable reloading the STL model

When you right click on a STL model Cura gives you the option to reload the STL model. I use that often when I use Cura. You can see how the slicing is going and then tweak the STL without having to delete and reload the model which can be time consuming when you have a bunch of STL's in the slicer space.

Extra files (some 55k) are in the 3.3.3 version.

Appear to be in the "Resources/app/node_modules/@jimp" folder on the Mac when looking at the Package contents.

Console display artifact

When the Console is enlargened to fill from top to bottom the text that is in the lower portion of the Workspace shows thru in the Command input at the bottom. Here's a pic of it:

If you're looking at it with a LCD display you may have to look at the screen at an angle to see it. At least that's the case on my MacBook.
It also affects the region where you can click to activate that area for input.
It could also be related to the "Send Command" text which shows in that region and is supposed to be there.

Snapmaker

Load vs Upload...

Some instances of the term "Upload" in Luban should really be "Load". You "Load" to the Luban application, you "Upload" to the Snapmaker. The term "Send via WiFi" is appropriate. It could also be "Upload to Snapmaker".

Feature Request: Infill Speed Control

Trying to 3d print something with flexible filament and need the print to go very slow. I can adjust most things, but not infill speed. It should be exposed or a function related to Inner/Outer wall speed.

Broke: Copy , & Paste in Console

This is likely on your list already, mentioned by a lot of people. Just want to track it.

Win 10 x64 Luban 3.5.0: Starts in mini window

Every time I start Luban in Windows 10 x64 (builds 1909 and 2004) the software starts in 2-monitor system at monitor 1 top left corner in a size of just those three buttons: Minimize, maximize, close. You need to always maximize the windows to get started.

This is a fresh installation of operating system "from the scratch" so not any vendor-specific operating system installation.

Edited: typos

M20 doesn't work.

Tried with USB connection. Just says "OK"
If it wasn't intended to work, then it should be removed from the help list.

No warning on creating more than 10 Luban Macros...

I'm assuming there is a limit to the number of Luban Macros you can create. When I go to create the 11th one it just acts as normal, even letting me save, but no macro. Unless the list is only showing 10. It should put up an error message and not go further.

Snapmaker Luban 3.3.3 乱码

Snapmaker Luban 3.3.3 制造商下拉 出现乱码
系统环境： Window 10

Console not echoing thru WiFi connection

I understand that this is a known issue, just want to track its repair.
When executing commands thru the console, the results are not echoed back when connected thru WiFi.

Feature Request: Add a switch to M420 to display only the short version of the matrix.

I find the large interpolated version of the matrix a BIG distraction. :-)

Snapmaker Luban 3.3.3

It looks like there is a problem with the user interface when an STL file is imported and sliced. All layers of fiber are "purple" and identified as "unknown" moving the slider up and down removes layers of "purple". Changing the boxes for layers has no effect.

Windows 64 bit version.

When executing a Macro in Luban Widget I only get this error...

"Missing param [code] for method parameter."
This is ONLY when connected thru WiFi.
May be related to other WiFi echoing problem.

Bug: Snpmaker Luban on Debian cannot connect to machine over WiFi

For the Versions starting from 3.3.3 I'm unable to connect over WiFi anymore. Removed Wlan Settings on machine and reconnected. On macOs and Windows it works, I've tested it

Failure of V 3.4.2 to install with Windows 64

No joy with Windows 10 Pro 64bit version 1909, with windows defender and current patches installed. Clicking the installer package results in a popup window. This did not occur with v3.3.3

More info click results in

App:	snapmaker-luban-3.4.2-win-x64.exe
Publisher:	Shenzhen Snapmaker Technologies Co., Ltd.

This looks like some kind of cert missing during the build process....

Feature Request: Full G & M code listing in console

List the FULL set of G & M codes available in Luban console. I understand that many of these are for expert or debugging use and they should be highlighted as such.

3.4.2 Serial Port Doesn't Open

Wifi works. Serial Port doesn't.
On my Mac. 10.14.2 OS.
I restarted both the Snapmaker and my Mac and it worked then.
Before it had the problem connecting to the serial port I had connected via WiFi and had connected in the middle of a print executing from the SD which was canceled. I closed the WiFi and then tried connection via the Serial port. Thats when the problem occured.

DXF Arc 360

I've identified that Arcs that start before 360 degrees and go through 360 to end after 0 degrees are not imported. There are also small arcs that have an issue.
In the attached drawing, there are;
362 Arcs
94 Circles
13 Elipses
2457 Lines
1 Polyline
4 Splines
Attached is also a screenshot with some elements in red that don't load in Luban 3.4.2. In the Luban screenshot, you can see the arcs not being drawn as well as some other arcs that are not fully drawn in blue. These are not the ones going through 360, they are merely drawn halfway.

Please feel free to contact me with any additional drawings or tests.

Millenium Falcon Rev 17 - Thin Engraving.zip

Feature Request: Enable the ability to do infill with thicker layers

Cura has the ability to have the layers be twice or three times the thickness of the regular layers. I use this feature a lot to speed up the print. The way Cura does it in the UI is not very friendly. You have to make sure the infill layer thickness is exactly a multiple of the normal layer thickness. I would suggest just having the option just be "double infill layer thickness" (or triple) and the program just makes sure it's the right multiple. There should be a limit on this feature if the normal layer thickness is close to the nozzle diameter.

Error: Failed to lookup view "index.hbs" in views directories

The 3.6.0 under Linux fails to start (deb and tag.gz versions).

... Error: Failed to lookup view "index.hbs" in views directories ...

自定义material的参数不起作用

v3.3.3，
3d打印时候，
使用新增的自定义material，
生成gcode，
发现参数不起作用

Bug: Z axis goes down without permission

Z axis goes down without permission

Snapmaker fans all over the world
Snapmaker developers

Hello We will report on the following problems than Japan.
I can only use Japanese, so I am using Google Translate to convert it to English.
You may be doing the wrong translation.
Please forgive me.

Model: Snapmaker 3-in-1 Original
Firmware: 2.11

There was no place to define a problem with the machine itself, so I'll report it here.

・ When the machine power is on, press the Z-axis lightly to lower it.
・ If the Z-axis is pressed down lightly when the power is off, it will go down to the bottom.

This condition has also been reported by other buyers in Amazon Japan's buyer comments.

The nozzle of the 3D printer and the base come into contact, so please improve it.

---

Japanese Ver

Z軸が勝手に下がっていく

世界中のSnapmaker ファンの皆様
Snapmaker開発者の皆様

こんにちは日本より下記の問題点について報告をいたします。
私は日本語しか使えないため、Google翻訳を使用して英語に変換しています。
間違った翻訳をしているかもしれません。
お許しください。

使用機種：Snapmaker 3-in-1 Original
Firmware：2.11

マシン本体の問題について定義できる場所がなかったので、こちらで報告いたします。

・マシン電源が入っている状態でZ軸を下に軽く押すと、自然と下がる。
・電源が入っていない状態でZ軸を下に軽く押すと、一番下まで下がってしまう。

この状態は他の購入者がAmazon Japanの購入者コメントにも報告されています。

3Dプリンタのノズルとベースが接触するため、改善をお願いします。

Luban 3.3 - Don't see Laser and Carving tabs!

I only see the Workspace and 3DSlicer tabs!

3.4.2 Rotating workspace

I can only pan and zoom. Rotating does work.
Windows 7 machine.