Made a Linux app for my MIRACO Pro, figured I'd share

I’ve had a MIRACO Pro sitting around because apparently I’d rather write an entire app than use Windows lol. So here’s PointYoink.

It pulls scans over USB or WiFi, lets you clean them up, cut the base off, combine them and export. Been using it on Ubuntu with my Pro and figured somebody else here might find it useful too.

It’s free and open source:

Screenshots and install instructions are there. If anybody tries it, let me know how it goes or what breaks lol.

3 Likes

So, just to be clear, PointYoink is only pulling the scanned files off the Miraco, not doing any processing on them? I mean no merging or point reduction/refining?

Bruce

Yea currently its relying on the processing to be done on the Miraco device since it does have one tap edit and manual settings too, which do pretty good for the most part. But It does do some post processing like base removal and aligning/combing scans in the app, as well as lasso/box/etc removing random stray parts. The app isn’t anything like the Revo app would be, but the goal is to get it close to that.

I’m working on other tools and features to help with more post processing but that will take a while to make better.

So yes, currently this just aids in getting the scans off the device, not fully edit them… (yet)

1 Like

So… Big updates coming soon for all 3 of y’all that may have used this lol

I rebuilt the app from the ground up. You can now scan, build, and edit using your CPU and supported GPU. Processing is a lot faster if you have a beefy setup.

Trying to get this working, I almost bricked my MIRACO multiple times… but with just 4 scans at around 1000-1200 frames each, I got this headrest piece pretty close to the original. I probably should’ve thickened the walls when printing, but I’m happy with how it came out.

The MIRACO device has One Tap. I call ours YOLO Yoink, and it does pretty well with one click, if I do say so myself. There’s also an editor and a view that shows where you need to scan more if you missed anything.

There’s also a Learn Bed mode. You scan your bed first so the app can learn it, which helps match things up and gives YOLO Yoink a little help doing its thing.

I do have to admit I’ve only tested this with a rotating bed and the scanner on a small tripod. I move it closer to or farther from the turntable depending on what I’m scanning. I haven’t tested handheld scanning yet because the USB cord is too short, and I still need to buy a longer one. In theory it should work too, but I haven’t tried it, so no promises there yet.

The editing and merging tools are still pretty limited, but YOLO Yoink matched and cleaned this one up well enough that I barely had to touch it. Or maybe I’m giving myself too much credit idk. You be the judge.

Still got a bunch of bugs to iron out. I’ll need actual testers because one scanner and two computers isn’t much to test with.

Also, my MIRACO Pro is on firmware 1.0.0.129, so if anyone’s running a different version and wants to test it, that would help a lot. I’m scared to update mine now that I’ve finally got everything working lol

Might have something ready in a week or so. Maybe sooner, maybe later. If you wanna try it and help me find what’s broken, let me know.

2 Likes

Do I need a specific distro or can I use something like SteamOS in desktop mode to run your app? My SteamOS box is my most powerful non-windows machine I have and is the lowest bar to entry for me to try it out.

Bruce

Hey, honestly I don’t know. I’ve only run it on Ubuntu and never tried SteamOS, so I’m not going to promise anything. I do have a Steam Deck buried in my closet, so I’ll dig it out and try it myself first, since I’m not sure how it’ll go. I’ll let you know what I find.

Okay so update. I tested it on my Steamdeck, and with a bunch of patchwork it indeed can work on SteamOS. It just can’t do everything on a Deck because of the GPU and RAM. You can import your scans from the scanner, build the model, edit it and export it. What you can’t do is scan live, because that needs an NVIDIA card and the Deck has an AMD chip. If you have a dedicated SteamOS machine with a real GPU it could work better, but I haven’t tested that yet. On SteamOS you run it from source, since the .deb is for Debian and Ubuntu.

The bigger news is that PointYoink 2.0.0 is out. It’s a whole new app, built from scratch for the MIRACO on Linux. You can scan live or import what you scanned on the scanner, build a watertight model that’s ready for your slicer, clean it up with previews and undo, and export it as STL, OBJ, PLY or 3MF. There’s also a touch up guide that shows what you missed and helps you scan it again.

It’s still a work in progress, but it works. I’ve only tested it on my MIRACO Pro so far, so if you try it and something breaks, or it works great, I’d love to hear it. Downloads, screenshots and install steps are all here.

hero

1 Like

YOLO Yoink is a dangerously fitting name for one-click alignment :smiley: The missed-area view sounds especially handy, since that’s usually where a scan turns into a whole extra session.

1 Like

lol yea, the YOLO Yoink is the one click auto merge and clean up. You can also use the advanced tab to make your own profile to clean up settings or manually edit things as well. If you’re feeling fancy, you can run Ultra Yoink and you can run all of the different profiles to see which looks best. It is a bit heavy on usage but you get multiple results you can compare. Still a work in progress… You can still just run each one manually instead for less storage and time.

The What Is Left tab can save you from re-scanning the same areas and show you the areas that still need more coverage to improve the model. You can use burst mode or single shot to get the remaining few frames and check if improves.

If anybody has any issues with using the program, please do let me know…

The detail about running from source on SteamOS makes sense given the .deb packaging, and the note on live scanning needing an NVIDIA card explains why the Deck stays import-only. The Learn Bed mode is the part I find most interesting, since matching against a known bed seems like it would help the one-click merge far more than generic cleanup settings. Curious whether the advanced tab profiles and Ultra Yoink would behave differently on a handheld setup versus the rotating bed plus tripod arrangement you tested.

Handheld is something I hadn’t tried yet, so I gave it a shot today, mixed bag.

Right now PointYoink scans live over the USB cord to the PC, so you can’t walk around with it. I’d like to fix that with a small companion app on something you can carry, like a Steam Deck or a Pi, so you could scan handheld without being tied to the computer. It’s only an idea, nothing is built yet.

To see how handheld would go, I used the scanner’s own software instead. I took a part I’d already scanned well on the turntable and scanned it flat on a table, then imported it into PointYoink over Wi-Fi. Importing and tracking worked fine, with all the frames tracked and none lost. The problem was putting the sides together. I flipped the part between scans, so the table stayed the same and the part didn’t. The line-up locked onto the table and left ghost copies of the part. I cut the table off and it was still ghosted. The scanner’s remove-base option got rid of the table but didn’t fix the ghosting either.

Then I ran the scanner’s one-tap processing on the same scans. On my scanner’s firmware (an older version), it only cleans up each side and doesn’t join them. I don’t know whether newer firmware does. Its cleaned sides matched ours to within a millimeter, so the sides come out fine. Putting them together is the part that needs work.

Marker alignment with stickers on the part got a try too. It was only two rough sides, so I can’t say if it helps yet. I’ll have to test more of this.

That part is small enough for the turntable anyway, so it wasn’t a fair test. My guess is handheld works best as one slow pass around a big part, with no flipping. That’s what I want to try next.

Learn Bed does help the one-click merge because it matches against a known bed. I’m also thinking about a “Learn Scene” mode for setups with markers, spheres or stickers around the part. You’d scan the empty setup once so it knows where all the markers are, then put your part on it, and it uses them to line up the sides and cut them out of the model. It’s only an idea for now.

I’ll keep testing more as I get time and keep updating the app.

The truncated post makes it hard to tell which parts are yours, but the title suggests you built something rather than just discussing the MIRACO Pro’s capture limits. If that’s right, it would help to know what the app actually does—whether it handles importing scans, converting file formats, or managing projects on the Linux side. Since the hardware support tends to be the tricky part for Linux users, that distinction matters. A short summary of the workflow would make the share more useful for anyone in the same situation.

The MIRACO Pro side of this is what interests me most, since the workflow around scan capture and transfer is where a desktop app can actually save time. Which parts did you handle natively versus wrapping existing tools? I’m curious whether the MIRACO’s connection behaves the same as the Metro series over USB, or if it needed different handling. A short list of what’s tested and what’s still rough would help anyone deciding whether to try it.