Installation
Videos
Please check the path of your installation of Imagemagick and update it accordingly in eagleUp parameters.
You can watch the videos in full screen for better comfort.
Download and Installation
To run eagleUp you need to download and install three softwares:
- Cadsoft Eagle (the freeware version is sufficient for small boards)
- Google Sketchup (currently version 8, freeware version)
- ImageMagick (I recommend ImageMagick-6.8.0-Q8-windows-dll.exe, freeware)
eagleUp
- eagleUp_export.ulp goes to C:\Program Files\EAGLE-5.11.0\ulp
- eagleUp_import.rb goes to C:\Program Files\Google\Google SketchUp 8\Plugins
- the content of /models can be placed anywhere. I recommend to copy it near your libraries, for example in C:\Program Files\EAGLE-5.11.0\models
- the Eagle demo files can be placed anywhere.
Initial Setup
When you launch eagleUp_export.ulp the first time, a window will appear and help you configure the paths so that eagleUp knows where to look for models and for the image utilities.
Click set for Windows or set for OS X depending on your system. If you have installed the recommended software in the recommended paths, that is enough. If you have older versions you can easily edit the paths by hand.
Windows users, please note that you need to use forward slash (/) and not the backward version (\).
The models path should be terminated with a /.
Please check the path of your installation of Imagemagick and update it accordingly in eagleUp parameters.
You only need to edit these settings at first use. The settings are saved in the configuration file and will be restored at the next launch. If you need to edit again these settings, press the edit Sketchup settings in the main window.
For Eagle version 5.10 and above, settings are recorded internally by Eagle (in the eaglerc.usr file). For the earlier versions these functions did not exist, so the settings are recorded in the /ulp folder, for example in C:/Program Files/EAGLE-X.Y/ulp/eagleUp_export.settings.txt Contact me if this location is an issue for you.
If you have a 5.x version of Eagle installed, I recommend upgrading to the latest 5.11. It’s stable and the upgrade is free.
Setup for OS X
Some new hints for Mac users from Lieven. Installing ImageMagick on OS X is very easy through HomeBrew : just ‘brew install imagemagick‘. The default installation path is then ‘/usr/local/bin/convert’ and ‘/usr/local/bin/composite’ instead of ‘/usr/opt/…’ that is currently default for OS X.
According to recent comments the newest ImageMagick version do not work well (texture missing on the PCB). Try installing the older 6.7.5-7 version until a fix is found.
Some hints for Mac users from Tom.
You can install ImageMagick by using MacPorts – visit http://www.macports.org/ to get MacPorts, then at the command line run :
sudo port install imagemagick
By default MacPorts installs applications in /opt/local/bin
So if you’ve installed Eagle in the general “Applications” folder on your Mac then as suggested put the eagleUp models in the Eagle folder.
eagleUp_import.rb goes in the following folder:
/Library/Application Support/Google SketchUp 8/SketchUp/plugins
That’s NOT the Library folder from your home folder, it’s main one off the root folder.
Linux
Eagle and Image Magick are available natively for the linux OS. You can run Sketchup via wine :

Hello.
Works just fine (with your demo Board).
Cause i got an Error with the Eagle examples i made my own board (fast, only Chips and connectors) but also got the Error: “Unbekannter Layer: 116″ where i can click OK or Abbrechen.
If i click OK and import to SketchUp it works with my own PCB but not with the examples.
The there a Chance you are designing more standard Models like S08, MLF32, MiniUSB, 0805Chip?
*Searching for a good copper color. <- Is it Possible to use Pictures as Color?
Thanks
Michael Dierken
Hello Michael,
1) I am not sure I understand your message properly. Can you get to the 3D model with the demo files I have provided ?
2) I have seen the error about “layer 116″ appear at first use. I will fix it in the next update.
3) You already have SO08-150 and mini USB models in the zip file. You may need to rename them according to your Eagle package name (they come from the older versions of eagleUp). For the others you can either draw them yourself (which I strongly recommend) or wait for the warehouse to open
4) The board colors are defined by two RGB colors : one for the mask over copper, and one for mask over FR4. Feel free to suggest combinations in the comments. For information you can set these values yourself, lines 80 and 81 of the ULP.
Thanks,
Jerome
1) Yes i can.
2) thanks
3) WIll look
4) If i edit the RM Comment where will the Pictures be?, how can i edit the Mask by myself?
Please send me your own .brd that does not work file by email.I will check what’s wrong.
By RM I guess you mean line 36 of eagleUp_import.rb
This command is used to delete temporary files generated during image creation. They are useless so I delete them to avoid messing your folders. The temporary images are generated in the same folder as the other image, i.e. in the same folder as your .brd file.
You can edit the colors by yourself for your tests, change the first value of the line 80, and the first value line 81 (of the ULP file). Then choose to export as green board. Then import into Sketchup.
One issue with the colors, is that we apply a single color over the whole board. If you look at a close-up photo of a real board, you will notice that the color is not homogeneous, but has many shades.
Jerome
Hello Jerome
Nice work you’ve done. I have a problem. After exporting from Eagle, I can’t import the .eup into SketchUp.
It runs all the windows, but doesn’t place anything into sketchup.
Any idea why?
Hello Christian,
Please check your settings at the top of the .rb file
In particular check the decimal sign, and the model path, it should use / and not \
It should also finish by a /.
Do you have any error messages popping up ?
Is the board appearing ? With correct images on top & bottom ?
Jerome
the ‘,’ changed it all. Thanks man
Any change you can import thwe packages from Eagle 3D and use them in models?
It would be easy, instead of designing all models by hand
Models from eagle 3D are not compatible.
If you design boards seriously you are already designing your eagle devicescyourself, so try to make a sketchup model. It’s very simple.
After following the tutorial for model creation I am sure you can build a model in a few minutes top.
I will open a part warehouse, so you can find good models for common parts. But for that I will need user contribution !
Jerome
Just for information, I’m using Win7Ultimate French version, the decimal separator is ‘,’ (comma), and even by changing
# Define decimal separator (can be . or ,)
DECIMAL_SEPARATOR = “.”
to use comma instead of dot, when importing in sketchup, it creates board images (in png…) but it never opened anything in 3D.
I had to change the windows decimal separator to dot (.) to make everything work as expected.
Thank you for this great plugin, really awesome work.
Hi,
Great work. But I can’t import the board to SketchUp, the plugin shows all the windows but at the end nothing appears. I change the (.) for a (,) in this case doesn’t show the windows.
Any idea?
Hi,
1) do you see the PCB appear in Sketchup ?
2) do you have a message box with a list of missing package at the end ?
3) do you see a colored image for top & bottom in your project folder ?
Jerome
Cristian, read my post before yours …
you need to force the decimal separator in windows regional settings to use a DOT (.) instead of comma(,). I had the same pb and even changing it in the import file didn’t solved the pb. Keep the import file as is (with DOT) and change your windows regional settings. It will work
One point I have to add to the installation notes, is that you need to restart Sketchup completely in order for the changes in the .rb file ti be taken into account.
1) The PCB doesn’t appear in Sketchup
2) No message
3) Yes, the Bottom and Top layers.
Please compare your eup file with one I have posted here :
http://eagleup.wordpress.com/tutorial-v4/#comment-74
Can you give more detail on your configuration : OS, version of software…
I’m work with XP, Eagle 5.11. I don’t know were is the error, but now it works!
Tanks!
I’ve got a similar problem. The Sketchup generates the project with the components under the other. And it does not generate the board. If I select to generate only the board in ulp, it works without problems.
I am using Eagle 5.11 and Win 7.
Hello,
This looks like a unit issue. Change your template to engineering – meters to solve it.
Jerome
Some hints for Mac users:
You can install ImageMagick by using MacPorts – visit http://www.macports.org/ to get MacPorts, then at the command line run :
sudo port install imagemagick
By default MacPorts installs applications in /opt/local/bin
So if you’ve installed Eagle in the general “Applications” folder on your Mac then as suggested put the eagleUp models in the Eagle folder, the following settings in eagleUp_import.rb should work:
# Path to search for models
MODEL_PATH = “/Applications/EAGLE/models/”
# Path to ImageMagick convert
CONVERT_CMD = “/opt/local/bin/convert”
# Path to ImageMagick compose
COMPOSITE_CMD = “/opt/local/bin/composite”
# Command to remove temporary files
RM_CMD = “rm”
eagleUp_import.rb goes in the following folder:
/Library/Application Support/Google SketchUp 8/SketchUp/plugins
That’s *NOT* the Library folder from your home folder, it’s main one off the root folder.
These settings worked for me.
Excellent, I will add these details in the installation page directly
Thanks
Jerome
Hi eagleup,
first of all…thanks for your job, your plugin is Great!!
I want only give an hint to the others users in reporting the errors: open the ruby console from the windows user menu in sketchup before to run eagleup_import plugin to get a detailed error log
Then, in windows 7 i have noticed that with the option:
# Define decimal separator (can be . or ,)
DECIMAL_SEPARATOR = “.”
running the sketchup import plugin I got the following error:
Error: # Errno::ENOENT: No such file or directory – C:/Users/Valek,XXXXXXXXX/Documents/eagle/demo files/
It seems that ruby interpreter replace “.” with “,” in the file path, too!!!!
To solve the issue I moved source files in a path without “.” like c:\dome files (in this case, it’s needed to re-run eagle plugin in the new path)
I hope this information could be useful for others eagleUp users!!
Bye
Valek
Hello Valek,
I have not found this issue before, but having periods in a folder name is not very recommended
I will fix this issue in the next release of eagleUp (you will receive automatic notice when the release is available).
Jerome
Hi there.
Would it be possible to make eagleUp recognise parts with odd characters in their footprints and SketchUp component file names?
For example, I have symbols with names like:
D/7343-31W – a tantalum capacitor
2,8 – a hole in the board
among others in my Eagle libraries from places like SparkFun as well as those provided with Eagle.
I have created 3D models for these parts, the problem is that those filenames don’t work with eagleUp (I’m using v4.1) because of the characters like “/” and “,”.
I don’t want to have change these footprints in existing libraries just to make them compatible with eagleUp, that’s a recipe for headaches with old board designs!
Oh also, would the SketchUp plugin be able to do a ” Zoom-Extents” before exiting to resize the view to show the full board?
It’s a feature I’d love in the next version.
Tom
PS: I have made some components which I’ll send through for inclusion in the warehouse some time soon….
Hello Tom,
1) OK. Unfortunately having / in a file is not possible (or very dangerous) so I suggest that ‘/’ will be replaced by ‘_’ and ‘,’ by ‘.’ when looking for skp file (ie, name your skp file D_7343-31W.skp)
2) Zoom extent is a good idea too.
I will add this to the 4.2 release coming soon. Remember to register as beta tester
Jerome
Hi
Your link to ImageMagick says server missing
Can you recommend another link.
Link has been updated and fixed, thanks.
Jerome
Hello,
I don’t know how to do plugin in the latest version of skethup?
I want to import *.eup file (from eagle) to skethup.
There is no icon as the old version.
Thanks in advance,
Hanan
Hello,
Have you copied the .rb file into /plugins folder of the new installation of Sketchup ?
Jerome
I have copied the eagleUp_import.rb file into plugins folder of the new installation of Sketchup8.
I have done all according to presentation’s instructions .
The presentation shows how to import *.eup file using of plugin icon which doed not exist in skethup new version.
I tried to import the *.eup file via file–>import, but the *.eup file is invisble even though is exist.
Thanks,
Hanan
Hello,
I have just tried on a fresh Google Sketchup 8 installation and it works as usual.
File / import does not work for eagleUp files so these files will not appear.
Do you see a “Plugins” menu in Sketchup. Do you see the two menus Import and Scale ?
Jerome
Hi Jerome,
Thanks for making this application! I am very excited to get it working. I am having problems though.
I am using Eagle 5.11.0 and Windows 7. Every time I run the ulp I get a path error message.
http://i227.photobucket.com/albums/dd238/jman_31/Electronics/Untitled2.jpg
http://i227.photobucket.com/albums/dd238/jman_31/Electronics/Untitled.jpg
Hello,
The setting subfolder is a relative path.
Just type in “output” and it will work.
Jerome
Hello,
I was wondering if there was a way to increase the export area of the board?
Hi,
Can you please detail what you mean by export area ?
eagleUp will export the area within your dimension lines.
The outline should be closed, and there should be only one board.
Jerome
Hi
Good job thank you..
but when I export it on Google sketch he give me missing package And no component appear on PCB board ??I’m using eagle 6.2 .
can you help me ?
Hello,
- do you have the 3d models matching eagle parts on your hard drive ?
- is the path correct in eagleUp general settings ?
Can you give more details on your configuration ?
Jerome
Hi! I just used your awesome program to create a board I made. It worked well except for one thing. I have the labels layer in Eagle turned off. The export function still exports this layer even though it’s hidden, so the rendering shows the labels and it’s messing up the silkscreen layout. How do I fix this? Thanks!
In eagleUp main window you can choose which layers get printed on teh silk : the place, the place + name, nothing or custom.
Jerome
ah, a circle is no outline?
using eagle 6.2 light
The edge detection searches for corners in the dimension layer, and a circles does not have so many.
The best option is to draw 4 quarter-of-circles arcs. And set the width to 0 as usual (which is not possible with circles)
Jerome
Great tool! Just one problem: I can’t get the trace and silk layers to show, even though the ulp generates the images. What could be wrong?
Many thanks for making all this available.
Hello, this is usually a problem with imagemagick. Which version are you using ? The version 6.7.8-5 is known to be ok. You could try to install this one, or the latest available otherwise.
Jerome
Hi, I’ve followed all the instructions for installing all the software needed, but when I run the “eagleUp_export_legacy4.4.ulp” (Eagle 5.9.0) I receive the following error message:
Can’t open C:/ XXX /demo files/eagleUp/demo3d.eup
No such file or directory.
What I’m doing wrong? Do I need the demo3d.eup file? Where can I download it?
Thank you!
The eup file is written by eagleUp ULP. You need read/write rights in the demofiles/ folder.
Try moving the demo files with your documents to make sure you have proper access rights.
Jerome
on importing the eup to sketchup I constantly get a freezed program with the repeated message:
err:ntdll:RtlpWaitForCriticalSection section 0×141174 “?” wait timed out in thread 0009, blocked by 0000, retrying (60 sec)
duh
Can you please give more details on your configuration? OS, sketchup version … It’s hard to guess this.
ubuntu 12, sketchup 8, tried both eagleup 4.3 and 4.4 with the same result. launched it with wine from cmd because no response was seen. When i import, this is what is thrown:
system > settings imported
system > testing units
system > 100 inch = 2,54m
system > template meters ok
system > using comma as decimal separator
color > colors set
images > creating top and bottom images
fixme:heap:HeapSetInformation (nil) 1 (nil) 0
err:ntdll:RtlpWaitForCriticalSection section 0×141174 “?” wait timed out in thread 0009, blocked by 0000, retrying (60 sec)
by the way, I did found the problem. For some reason, the eagleup import script for sketchup in wine contained some non-readable ` characters, instead of ‘
I’m having the same problem. What exactly did you change in the script?
do a replace of ` for ‘ . I don’t remember which lines
Probably lines 675 and 741, two replacements per line.
Can you give a feedback of eagleUp on Linux ? Any other difficulties to install or run ?
I am running SU8 with IM6.8.4-Q8 and Eagle 4.19(linux native)all on Linux with Wine. It works well after fixing several issues.
I have encountered the problem with the backticks. Replacing them with single quotes does allow the importer to run but the image creation fails and no traces show on the resulting 3D board.
I think it may have something to do with the way Wine handles the backticks. I have tried a number of ways to escape them with no success.
Is there another way to call ImageMagick? IO.popen for example?
I do not know Ruby at all. Please forgive me. I did manage to get this far though.
The functionality is enough for me to use EagleUp but it sure would be cool to have the traces on the board as well.
Thanks for the quick reply!
I did replace the `, but I don’t know if that really changed anything. It started working, albeit very slow and still giving the error. But as long as it works I’m perfectly satisfied!
Thanks again for your help!
http://mhonarc.veidrodis.com/image_magick/binaries/
all image magick versions binary only
using eagle 6.3, sketchup 8, and ImageMagik 6.8. I get this error when I run the user file. http://imgur.com/G44D6XP
As you can see in the message you have concatenated your board path, and the export path.
Export path, define din the general settings, is a sub folder only. For example “3d export”.
If you do not wish a sub folder, leave the field empty.
You need to set this export sub folder only once.
Jerome
ok, thanks. I didn’t notice that the last field was a relative path, and not absolute like the rest. works great now, thanks.
I’m having problems viewing the components on the demo board in sketch up….
It shows:
Eagle’up import completed
Missing packages:
1X02
C1206
E5-6
SO14
SOT89
LED3MM
R1206
How to fix this?
You need to make sure the eagleUp model paths (in the settings) matches the path to the folder where you store your models.
It’s often easier to copy paste it.
Thanks.I am running the recent version of eagle and I totally forgot to set the correct path of models(which defaulted to eagle 5.11 model path,actually).Great work.Please keep it up.:)
Hi,
Dummy question,
I have a board with just few component but I got an empty board with all missing. What to do ?
Check the model path in general seetings. Do you see traces and silk layers ?
For the Mac problem: it seems libpng is missing on the latest releases (on my 10.8 it wasn’t there) and thus ImageMagic cannot do its magic, simply head this way and install the dependency: http://ethan.tira-thompson.com/Mac_OS_X_Ports.html
Thanks for this awesome tool, thanks to eagleUp I’ve prevented lots of errors and saved precious development time.
Never mind, I got too excited. I actually generated the png files on a Windows machine and later when testing with on my Mac I thought they were made by my Mac… still an ImageMagic problem somewhere.