Editing Axidraw Software Installation
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 2: | Line 2: | ||
AxiDraw is designed to work well on Mac, Windows, and Linux computers. To use it, you'll need to install certain software on your computer. | AxiDraw is designed to work well on Mac, Windows, and Linux computers. To use it, you'll need to install certain software on your computer. | ||
− | Please read below for specific instructions for [[#Mac|Mac]], [[#Windows|Windows]], and [[#Linux|Linux]]. | + | Please read below for specific instructions for [[#Mac|Mac]], [[#Windows|Windows]], and [[#Linux|Linux]]. |
− | The current software version is v. | + | The current software version is v. 2.6.3, released September 2020, and runs under Inkscape 1.0. |
== Mac == | == Mac == | ||
− | === For recent macOS, 10.15 | + | === For recent macOS, 10.11 - 10.15 Catalina === |
− | Our primary release of the AxiDraw software is available for Inkscape 1. | + | Our primary release of the AxiDraw software is available for Inkscape 1.0, and works under macOS 10.11 through 10.15 Catalina. |
− | |||
− | :1. Download and run [https:// | + | :1. Download and run [https://evilmadscience.s3.us-east-1.amazonaws.com/dl/ad/public/AxiDraw_Mac_263.zip the AxiDraw installer]. |
− | :2. Download and install [https://inkscape.org/release/1. | + | :2. Download and install [https://inkscape.org/release/inkscape-1.0.1/mac-os-x/1010-1015/dl/ Inkscape 1.0 for Mac] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Legacy install for older macOS 10.7 - 10.10 === | === Legacy install for older macOS 10.7 - 10.10 === | ||
− | + | A previous release of our AxiDraw software is based on Inkscape 0.92, and works under macOS 10.7-10.10. | |
:1. Download and open the [https://github.com/evil-mad/axidraw/releases/download/v2.5.6/AxiDraw_v256_r1_Mac.dmg AxiDraw Mac bundle DMG] | :1. Download and open the [https://github.com/evil-mad/axidraw/releases/download/v2.5.6/AxiDraw_v256_r1_Mac.dmg AxiDraw Mac bundle DMG] | ||
Line 39: | Line 29: | ||
:4. Eject the disk image (DMG). | :4. Eject the disk image (DMG). | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Troubleshooting === | === Troubleshooting === | ||
− | + | :* If you encounter difficulty installing the AxiDraw extensions for Inkscape (or with plotting, in the next stage), please request assistance through [https://shop.evilmadscientist.com/contact our contact form] or through the [https://www.evilmadscientist.com/forums/forum/axidraw/ AxiDraw forum]. | |
− | :* If you encounter difficulty installing or | ||
:* If there is any chance that a problem you encounter is specific to AxiDraw software or hardware, it is important that you do not directly seek assistance through Inkscape's support resources. You're much more likely to get your problem solved by asking people who know about AxiDraw. And, we'd like the Inkscape team to be ready to help us when we do encounter Inkscape-specific issues. | :* If there is any chance that a problem you encounter is specific to AxiDraw software or hardware, it is important that you do not directly seek assistance through Inkscape's support resources. You're much more likely to get your problem solved by asking people who know about AxiDraw. And, we'd like the Inkscape team to be ready to help us when we do encounter Inkscape-specific issues. | ||
Line 67: | Line 41: | ||
=== Installation === | === Installation === | ||
− | :1. Download and run the AxiDraw | + | :1. Download and run the AxiDraw v 2.6.3 installer for Windows: [https://evilmadscience.s3.us-east-1.amazonaws.com/dl/ad/public/AxiDraw_263.exe Download link] (6.2 MB) |
− | ::* The installer is an executable, named " | + | ::* The installer is an executable, named "AxiDraw_263.exe". |
− | :2. Download and install Inkscape from [https://inkscape.org/release/1. | + | :2. Download and install Inkscape '''version 1.0''' from [https://inkscape.org/release/1.0.1/windows/ the download page] at Inkscape.org. (Most users will want the 64-Bit download.) |
− | ::* 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 [ | + | ::* 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]. ''Please do not use Inkscape support resources for AxiDraw-specific issues-- see note below about troubleshooting.'' |
− | === Alternative (Manual) install | + | === Alternative (Manual) install === |
− | :If you already have Inkscape 1.0 | + | :If you already have [https://inkscape.org/release/1.0/windows/ Inkscape 1.0] installed on your computer, you will need a different version of the AxiDraw extensions. For Windows 8 and older versions, please use the installer above for the first time that you install AxiDraw software, as the installer also includes a necessary USB driver. (You can use the manual method for subsequent installs and upgrades, and for Windows 10, which does not require the USB driver.) |
− | ::1. Download the software in [https:// | + | ::1. Download the software in [https://evilmadscience.s3.us-east-1.amazonaws.com/dl/ad/public/ad_ink1_263.zip this ZIP archive] (7 MB), and unzip it. (Your computer may unzip the archive automatically for you.) |
::2. Locate and open your Inkscape user extensions directory. You can find this location as follows: | ::2. Locate and open your Inkscape user extensions directory. You can find this location as follows: | ||
− | :::A. Open Inkscape | + | :::A. Open Inkscape 1.0 |
:::B. From the menu, select '''Edit > Preferences''' | :::B. From the menu, select '''Edit > Preferences''' | ||
:::C. Select '''System''' from the list on the left panel of the preferences window. | :::C. Select '''System''' from the list on the left panel of the preferences window. | ||
:::D. On the right-hand panel is a list of directory locations. Click the "Open" button to the right of the "User extensions" folder location. | :::D. On the right-hand panel is a list of directory locations. Click the "Open" button to the right of the "User extensions" folder location. | ||
− | ::3. Copy the contents of the ZIP archive ( | + | ::3. Copy the contents of the ZIP archive that you downloaded (32 items total; 30 files and 2 subdirectories) into your Inkscape extensions directory, overwriting any files and directories with the same names. |
::4. Launch Inkscape, or quit and re-launch it if it is open. | ::4. Launch Inkscape, or quit and re-launch it if it is open. | ||
Line 92: | Line 66: | ||
: Your software should now be set up to work correctly. | : Your software should now be set up to work correctly. | ||
− | :* If you encounter difficulty installing or | + | :* If you encounter difficulty installing the AxiDraw extensions for Inkscape (or with plotting, in the next stage), please request assistance through the AxiDraw mailing list or forum, which you can find on our [[AxiDraw|front page]]. |
:* If there is any chance that a problem you encounter is specific to AxiDraw software or hardware, it is important that you do not directly seek assistance through Inkscape's support resources. You're much more likely to get your problem solved by asking people who know about AxiDraw. And, we'd like the Inkscape team to be ready to help us when we do encounter Inkscape-specific issues. | :* If there is any chance that a problem you encounter is specific to AxiDraw software or hardware, it is important that you do not directly seek assistance through Inkscape's support resources. You're much more likely to get your problem solved by asking people who know about AxiDraw. And, we'd like the Inkscape team to be ready to help us when we do encounter Inkscape-specific issues. | ||
Line 98: | Line 72: | ||
== Linux == | == Linux == | ||
− | The AxiDraw extensions for Inkscape have been developed and tested extensively under Ubuntu. We expect them to work equally well in most Ubuntu derivatives and other distributions where Inkscape is known to work. However, ''we do not have the capability to test every distribution''. If you are unsure if your distribution will work, try to install Inkscape, and see if it appears to launch and run correctly. (We do also have python-based [https://axidraw.com/doc/cli_api/ command-line tools] available to run the AxiDraw, even on systems where Inkscape is not supported.) | + | The AxiDraw extensions for Inkscape have been developed and tested extensively under Ubuntu. We expect them to work equally well in most Ubuntu derivatives and other distributions where Inkscape is known to work. However, ''we do not have the capability to test every distribution''. If you are unsure if your distribution will work, try to install Inkscape, and see if it appears to launch and run correctly. (We do also have python-based [https://axidraw.com/doc/cli_api/ command-line tools] available to run the AxiDraw, even on systems where Inkscape is not supported.) |
− | + | '''Working with Inkscape 1.0:''' | |
− | :* Install Inkscape 1.0 | + | :* Install Inkscape 1.0 on your computer. The best way to do this will vary by distribution, but in most cases you can use the software installer provided with the OS. See [http://wiki.inkscape.org/wiki/index.php/Installing_Inkscape#Installing_on_Linux here] for additional information. (All else being equal, we recommend the PPA type install over snap or flatpack.) |
− | :* Launch Inkscape, and select Edit > Preferences from the menu, and then select the System entry. That should list the location of your '''User extensions''' directory. | + | :* Launch Inkscape, and select Edit > Preferences from the menu, and then select the System entry. That should list the location of your '''User extensions''' directory. |
− | :* | + | ::* With a "Snap" distribution of Inkscape, that location might be something like <code>~/snap/inkscape/4274/extensions/</code> |
− | :* | + | :* Download and unzip the software in [https://evilmadscience.s3.us-east-1.amazonaws.com/dl/ad/public/ad_ink1_263.zip this ZIP archive]. Copy its contents (32 items total; 30 files and 2 subdirectories) into your Inkscape User extensions directory and relaunch Inkscape. |
− | |||
− | + | About adding your user account to the "dialout" group: | |
: In modern Linux releases, it is often necessary to change your user permissions, to explicitly grant access to the USB port where the AxiDraw is located. This can be done by adding your user group to the "dialout" user group on your system. | : In modern Linux releases, it is often necessary to change your user permissions, to explicitly grant access to the USB port where the AxiDraw is located. This can be done by adding your user group to the "dialout" user group on your system. | ||
:* Open up a terminal window | :* Open up a terminal window | ||
− | :* For most distributions (including Fedora and Ubuntu), enter the command | + | :* For most distributions (including Fedora and Ubuntu), enter the command "sudo usermod -a -G dialout <myUserName>" <return>, replacing the <myUserName> part with the user that is running Inkscape (and without the quotation marks or angle brackets!). |
− | ::* If you are unsure of your user name, enter the command "whoami" <return>, and the computer will remind you. | + | ::* If you are unsure of your user name, enter the command "whoami" <return>, and the computer will happily remind you. |
− | ::* If you are unsure whether you are already in the " | + | ::* If you are unsure whether you are already in the "dialup" group, enter the command "groups" <return>, and the computer will list the groups that you are in. |
− | :* After changing groups, you need to | + | :* After changing groups, you need to log out and log back in for the change to take effect. |
− | + | Troubleshooting | |
− | : If your permissions are not correct (your user is not in the dialout group), you may get consistent "Unable to | + | : If your permissions are not correct (your user is not in the dialout group), you may get consistent "Unable to find an AxiDraw" type error messages. |
− | : | + | : If the AxiDraw menu doesn't appear in Inkscape, verify that when you've extract the zip file, all the .py files are inside .config/inkscape/extensions/ folder (you might have extracted the entire AxiDraw folder, and .py files might be misplaced) |
− | |||
− | |||
− | |||
− | |||
− | |||
== Firmware Update == | == Firmware Update == | ||
− | We encourage all AxiDraw users to update the latest firmware version, | + | We encourage all AxiDraw users to update the latest firmware version, which is "EBB" firmware version 2.6.5. Once your AxiDraw software is up and running, you can check which version of the firmware you have by selecting the "Config" tab of AxiDraw Control and clicking Apply. |
EBB Firmware versions 2.4.6 and newer contain performance improvements and bug fixes that can prevent certain types of errors. | EBB Firmware versions 2.4.6 and newer contain performance improvements and bug fixes that can prevent certain types of errors. | ||
To update your firmware, please follow the directions [[Updating_EBB_firmware|here]]. | To update your firmware, please follow the directions [[Updating_EBB_firmware|here]]. | ||
− | |||
− | |||
− | |||
− | |||
− |