|
|
| (131 intermediate revisions by 19 users not shown) |
| Line 1: |
Line 1: |
| | + | {{EggBotDocs}} |
| | + | |
| | Eggbot is designed to work well on Mac, Windows, and Linux computers. To use it, you'll need to install certain software on your computer. | | Eggbot is designed to work well on Mac, Windows, and Linux computers. To use it, you'll need to install certain software on your computer. |
| | | | |
| | + | The EggBot extensions for Inkscape are included with, and installed by, the AxiDraw software installers. To install the software please follow the specific directions for your platform on the [https://wiki.evilmadscientist.com/index.php?title=Axidraw_Software_Installation&oldid=4104 AxiDraw installation page]. Detailed instructions are provided for Mac, Windows, and Linux computers. (We are currently recommending software install version 3.9.4 for EggBot users; the installation page link goes to the version for 3.9.4.) |
| | | | |
| − | The Eggbot software actually consists of several different parts:
| + | == Example files == |
| − | # Inkscape, the superb freeware vector graphics application
| |
| − | # The Eggbot extensions for Inkscape, which let you control the Eggbot from within Inkscape
| |
| − | # The Eggbot USB driver, on Windows systems.
| |
| − | | |
| − | | |
| − | Optionally but suggested, you may also want to download the set of example files from the [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site].
| |
| − | | |
| − | | |
| − | The particulars of installation depend on the operating system:
| |
| − | | |
| − | | |
| − | = Mac = | |
| − | | |
| − | 1. Download and install the latest version of Inkscape (version 0.48 or newer) from [http://inkscape.org/download/ the download page] at Inkscape.org.
| |
| − | | |
| − | :* Hot links: Download Inkscape 0.48 for 10.5-10.6 (Leopard/Snow Leopard) [http://downloads.sourceforge.net/inkscape/Inkscape-0.48.0-1-LEOPARD%2B.dmg here] or the version for 10.4 (Tiger) [http://downloads.sourceforge.net/inkscape/Inkscape-0.48.0-1-TIGER-PPC.dmg here].
| |
| − | :* Install Inkscape in the default location, the main "Applications" folder.
| |
| − | :*Note that inkscape is an X11 application, and will require that X11 or [http://xquartz.macosforge.org/trac/wiki XQuartz] is installed on your Mac.
| |
| − | :: For MacOS 10.5-10.6 (Leopard and Snow Leopard), download and install the latest version of [http://xquartz.macosforge.org/trac/wiki XQuartz], unless you already have a working X11 install.
| |
| − | :: For MacOS 10.4, use the X11 that came on your system installer disks.
| |
| − | :* If you need additional assistance for installing Inkscape, you may be able to find good advice at the [http://wiki.inkscape.org/wiki/index.php/InstallHelp the Inkscape wiki] and/or the [http://www.inkscapeforum.com/ Inkscape Forums]
| |
| − | | |
| − | | |
| − | 2. Download and install the Eggbot extensions for Inkscape
| |
| − | | |
| − | :* Recommended method: Download the latest version of the Mac installer package from the [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site]. Run the installer (a standard Mac installer package) to install the Eggbot extensions. The installer requires MacOS 10.4 or newer.
| |
| − | :* Alternate method, Manual installation: Download the latest version of the Inkscape extension (''not'' the mac installer) from the [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site]. Copy the entire contents of the Eggbot software archive to /Applications/Inkscape.app/Contents/Resources/extensions/ and restart Inkscape.
| |
| − | :: Note for MacOS 10.6: There is a [https://bugs.launchpad.net/inkscape/+bug/482993 known bug] in Inkscape 0.47 and 0.48, in that extensions (even the built-in ones) do not work under snow leopard without patches. The installer contains a patch, so manual installation is not recommended on Snow Leopard. If you have solved this issue separately in one of several ways, you can use the manual installation method.
| |
| − | :: Note for MacOS 10.4: You may also need to install Python 2.5, if your system does not already have it.
| |
| − | :* The eggbot submenu should appear in the Extensions menu of Inkscape after you restart Inkscape.
| |
| − | | |
| − |
| |
| − | | |
| − | = Windows = | |
| − | | |
| − | 1. Download and install the latest version of Inkscape (version 0.48 or newer) from [http://inkscape.org/download/ the download page] at Inkscape.org.
| |
| − | | |
| − | :* Hot links: Download Inkscape 0.48 for windows [http://downloads.sourceforge.net/inkscape/Inkscape-0.48.0-1.exe here].
| |
| − | :* Install Inkscape in the default location, the main "Program Files" folder (or "Program Files (x86)" on newer systems).
| |
| | | | |
| | + | Optionally but suggested, you may also want to download the set of example files for Eggbot. A direct download link is [https://github.com/evil-mad/EggBot/releases/download/v2.8.1/EggBotExamples_v281.zip here]; the files are hosted on the [https://github.com/evil-mad/EggBot/releases/latest EggBot Releases page] at GitHub. |
| | | | |
| − | 2. Download and install the Eggbot extensions for Inkscape
| |
| − | :* Recommended method: Download the latest version of the Windows installer package from the [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site]. Run the installer (a standard Windows installer package) to install the Eggbot extensions. The installer has been tested to work from XP through Win7.
| |
| − | :* Alternate method, Manual installation: Download the latest version of the Inkscape extension (''not'' the Windows installer) from the [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site]. Copy the entire contents of the Eggbot software archive into (Program files)\Inkscape\share\extensions\ and restart Inkscape.
| |
| − | :* The eggbot submenu should appear in the Extensions menu of Inkscape after you restart Inkscape.
| |
| | | | |
| | | | |
| − | 3. Download and install the Windows USB driver for Eggbot
| + | == Firmware Update == |
| − | :* Recommended method: Download the latest version of the Windows USB Driver installer package from the [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site]. It is called the UBWDriverInstaller_v10.zip. Unzip the file, and run the USBDriverInstaller.exe application. Click on the Installer Drivers button. When it is finished, close the application. The USB driver installer has been tested to work from XP through Windows 7 (32 and 64bit).
| |
| − | :* When you plug in your EggBot to your computer, the drivers will already be installed, and you can tell Windows to search for the drivers (XP) or allow the drivers to be installed when you connect (Vista and Windows 7).
| |
| − | :* This driver is necessary for Windows to recognize the Eggbot USB device.
| |
| − | :* Alternate method: Download the USB driver itself from [http://schmalzhaus.com/EBB/EBF/EBB_inf.zip]. Extract the files and point Windows to the inf file when asked for drivers when you connect your EggBot. Note that if you use Vista or Windows 7 and you use this method, Windows will silently fail when you plug in your EggBot for the first time, and you will need to go to the Device Manager and manually install the drivers for the device from there.
| |
| | | | |
| − | = Linux =
| + | We encourage EggBot users to update the latest firmware version. Once your EggBot software is up and running, you can check which version of the firmware you have by selecting the "Manual" tab of EggBot Control, picking "Check EBB Version" from the menu there, and clicking Apply. |
| | | | |
| − | The Eggbot extension for Inkscape has been developed and tested extensively under Ubuntu 10.04 (Lucid Lynx). We expect it to work equally well in other distributions where Inkscape is known to work.
| + | EBB Firmware versions 2.4.6 and newer contain performance improvements and bug fixes that can prevent certain types of errors. |
| | | | |
| − | Ubuntu install instructions:
| + | To update your firmware, please follow the directions [[Updating_EBB_firmware|here]]. |
| − | * Use the Ubuntu Software Center to install Inkscape 0.47 or newer (0.48 or newer is recommended.)
| |
| − | * Launch Inkscape from the Applications menu, and then quit it.
| |
| − | * Download the latest Inkscape extension .ZIP file from the downloads section of this site.
| |
| − | * From the "Places" menu, open your Home Folder.
| |
| − | * From the "View" menu select "Show hidden files" -- the .config folder should be visible.
| |
| − | * Place the contents of the ZIP archive inside .config/inkscape/extensions/
| |
| − | * Quit and restart Inkscape.
| |
Eggbot is designed to work well on Mac, Windows, and Linux computers. To use it, you'll need to install certain software on your computer.
The EggBot extensions for Inkscape are included with, and installed by, the AxiDraw software installers. To install the software please follow the specific directions for your platform on the AxiDraw installation page. Detailed instructions are provided for Mac, Windows, and Linux computers. (We are currently recommending software install version 3.9.4 for EggBot users; the installation page link goes to the version for 3.9.4.)
Optionally but suggested, you may also want to download the set of example files for Eggbot. A direct download link is here; the files are hosted on the EggBot Releases page at GitHub.
We encourage EggBot users to update the latest firmware version. Once your EggBot software is up and running, you can check which version of the firmware you have by selecting the "Manual" tab of EggBot Control, picking "Check EBB Version" from the menu there, and clicking Apply.
EBB Firmware versions 2.4.6 and newer contain performance improvements and bug fixes that can prevent certain types of errors.
