Difference between revisions of "Axidraw Software Installation"
From Evil Mad Scientist Wiki
(Update to 2.7.5!) |
(Update installation instructions for Inkscape 1.1.1.) |
||
| Line 10: | Line 10: | ||
=== For recent macOS, 10.11 - 10.15 Catalina, and macOS 11 Big Sur === | === For recent macOS, 10.11 - 10.15 Catalina, and macOS 11 Big Sur === | ||
| − | Our primary release of the AxiDraw software is available for Inkscape 1.1, and works under macOS 10.11 through macOS 11 Big Sur, and now supporting | + | Our primary release of the AxiDraw software is available for Inkscape 1.1.1, and works under macOS 10.11 through macOS 11 Big Sur, and now supporting |
both Intel and Apple Silicon architectures. | both Intel and Apple Silicon architectures. | ||
:1. Download and run [https://cdn.evilmadscientist.com/dl/ad/public/AxiDraw_Install_Mac_275r2.zip the AxiDraw installer]. | :1. Download and run [https://cdn.evilmadscientist.com/dl/ad/public/AxiDraw_Install_Mac_275r2.zip the AxiDraw installer]. | ||
| − | :2. Download and install [https://inkscape.org/release/inkscape-1.1/mac-os-x/ | + | :2. Download and install [https://inkscape.org/release/inkscape-1.1.1/mac-os-x/dmg/dl/ Inkscape 1.1 for Mac] |
| − | :3. (Recommended): Delete the AxiDraw installer. ( | + | :3. (Recommended): Delete the AxiDraw installer. (The installer may, erroneously, show up in your notifications center if you do not.) |
| Line 36: | Line 36: | ||
=== Alternative (Manual) install for Mac === | === Alternative (Manual) install for Mac === | ||
| − | :If you already have Inkscape 1.1 installed on your computer, you also manually install the AxiDraw extensions. | + | :If you already have Inkscape 1.1.1 installed on your computer, you also manually install the AxiDraw extensions. |
::1. Download the software in [https://cdn.evilmadscientist.com/dl/ad/public/ad-ink_275_r2.zip this ZIP archive] (8 MB), and unzip it. (Your computer may unzip the archive automatically for you.) | ::1. Download the software in [https://cdn.evilmadscientist.com/dl/ad/public/ad-ink_275_r2.zip this ZIP archive] (8 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 1.1 | + | :::A. Open Inkscape 1.1.1 |
:::B. From the menu, select '''Inkscape > Preferences''' | :::B. From the menu, select '''Inkscape > 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. | ||
| Line 61: | Line 61: | ||
::* The installer is an executable, named "AxiDraw_275r2.exe". | ::* The installer is an executable, named "AxiDraw_275r2.exe". | ||
| − | :2. Download and install Inkscape '''version 1.1''' from [https://inkscape.org/release/1.1/windows/ the download page] at Inkscape.org. (Most users will want the 64-Bit "MSI" installer.) | + | :2. Download and install Inkscape '''version 1.1.1''' from [https://inkscape.org/release/1.1.1/windows/ the download page] at Inkscape.org. (Most users will want the 64-Bit "MSI" installer.) |
::* 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 [https://inkscape.org/forums/ Inkscape Forums]. ''Please do not use Inkscape support resources for AxiDraw-specific issues-- see note below about troubleshooting.'' | ::* 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 [https://inkscape.org/forums/ Inkscape Forums]. ''Please do not use Inkscape support resources for AxiDraw-specific issues-- see note below about troubleshooting.'' | ||
| Line 68: | Line 68: | ||
=== Alternative (Manual) install for Windows === | === Alternative (Manual) install for Windows === | ||
| − | :If you already have Inkscape 1.1 installed on your computer, you also manually install 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.) | + | :If you already have Inkscape 1.1.1 installed on your computer, you also manually install 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://cdn.evilmadscientist.com/dl/ad/public/ad-ink_275_r2.zip this ZIP archive] (8 MB), and unzip it. (Your computer may unzip the archive automatically for you.) | ::1. Download the software in [https://cdn.evilmadscientist.com/dl/ad/public/ad-ink_275_r2.zip this ZIP archive] (8 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 1.1 | + | :::A. Open Inkscape 1.1.1 |
:::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. | ||
| Line 91: | Line 91: | ||
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.1:''' | + | '''Working with Inkscape 1.1.1:''' |
| − | :* Install Inkscape 1.1 on your computer. | + | :* Install Inkscape 1.1.1 on your computer. Where possible, we recommend to install via the [https://inkscape.org/release/inkscape-1.1.1/gnulinux/appimage/ appimage]. For some Linux distributions, installing Inkscape may require looking up distribution-specific information. See [http://wiki.inkscape.org/wiki/index.php/Installing_Inkscape#Installing_on_Linux here] for additional information. |
:* 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. | ||
:* Download and unzip the software in [https://cdn.evilmadscientist.com/dl/ad/public/ad-ink_275_r2.zip this ZIP archive]. Copy its contents (31 items total; 29 files and 2 subdirectories) into your Inkscape User extensions directory and ''relaunch'' Inkscape. Make sure that you copy all of these files, not just some of the files, and not just a folder containing these files. | :* Download and unzip the software in [https://cdn.evilmadscientist.com/dl/ad/public/ad-ink_275_r2.zip this ZIP archive]. Copy its contents (31 items total; 29 files and 2 subdirectories) into your Inkscape User extensions directory and ''relaunch'' Inkscape. Make sure that you copy all of these files, not just some of the files, and not just a folder containing these files. | ||
Revision as of 09:49, 9 October 2021
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, Windows, and Linux.
The current software version is v. 2.7.5, dated August 2021, and requires Inkscape 1.0 or newer.
Contents
Mac
For recent macOS, 10.11 - 10.15 Catalina, and macOS 11 Big Sur
Our primary release of the AxiDraw software is available for Inkscape 1.1.1, and works under macOS 10.11 through macOS 11 Big Sur, and now supporting both Intel and Apple Silicon architectures.
- 1. Download and run the AxiDraw installer.
- 2. Download and install Inkscape 1.1 for Mac
- 3. (Recommended): Delete the AxiDraw installer. (The installer may, erroneously, show up in your notifications center if you do not.)
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 AxiDraw Mac bundle DMG
- 2. Run the XQuartz installer included in that DMG (disk image) file.
- 3. Drag the included copy of Inkscape to your "Applications" folder.
- 4. Eject the disk image (DMG).
Alternative (Manual) install for Mac
- If you already have Inkscape 1.1.1 installed on your computer, you also manually install the AxiDraw extensions.
- 1. Download the software in this ZIP archive (8 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:
- A. Open Inkscape 1.1.1
- B. From the menu, select Inkscape > Preferences
- 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.
- 3. Copy the contents of the ZIP archive that you downloaded (31 items total; 29 files and 2 subfolders) 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.
Troubleshooting
- If you encounter difficulty installing or using the software, please request assistance through our contact form or through our Discord chat.
- 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.
Windows
Installation
- 1. Download and run the AxiDraw software installer for Windows: Download link (6.6 MB)
- The installer is an executable, named "AxiDraw_275r2.exe".
- 2. Download and install Inkscape version 1.1.1 from the download page at Inkscape.org. (Most users will want the 64-Bit "MSI" installer.)
- If you need additional assistance for installing Inkscape, you may be able to find good advice at the the Inkscape wiki and/or the Inkscape Forums. Please do not use Inkscape support resources for AxiDraw-specific issues-- see note below about troubleshooting.
Alternative (Manual) install for Windows
- If you already have Inkscape 1.1.1 installed on your computer, you also manually install 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 this ZIP archive (8 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:
- A. Open Inkscape 1.1.1
- B. From the menu, select Edit > Preferences
- 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.
- 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.
Troubleshooting
- Your software should now be set up to work correctly.
- If you encounter difficulty installing or using the software, please request assistance through our contact form or through our Discord chat.
- 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.
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 command-line tools available to run the AxiDraw, even on systems where Inkscape is not supported.)
Working with Inkscape 1.1.1:
- Install Inkscape 1.1.1 on your computer. Where possible, we recommend to install via the appimage. For some Linux distributions, installing Inkscape may require looking up distribution-specific information. See here for additional information.
- 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.
- Download and unzip the software in this ZIP archive. Copy its contents (31 items total; 29 files and 2 subdirectories) into your Inkscape User extensions directory and relaunch Inkscape. Make sure that you copy all of these files, not just some of the files, and not just a folder containing these files.
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.
- Open up a terminal window
- 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 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 whether you are already in the "dialout" group, enter the command
groups<return>, and the computer will list the groups that you are in.
- 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 connect to AxiDraw" type error messages.
- Some linux distributions use a different group name than dialout, which could possibly be one of the following: "uucp", "serial", "tty", "plugdev", or something else entirely. If dialout doesn't seem to be working, try
ls -l /dev/ttyACM*. The result will usually look something like "crw-rw---- 1 root dialout [...]". If something other than "dialout" is listed there, that is the name of the group that has permission ownership of the serial ports. - If you encounter difficulty installing or using the software, please request assistance through our contact form or through our Discord chat.
Firmware Update
We encourage all AxiDraw users to update the latest firmware version, if you are not already using it. 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.
To update your firmware, please follow the directions here.
