TNT – MPD Tutorial and Instructions TNT – MPD (we will refer to it as TNT) is a very powerful ministry tool. It is overall a database that tracks tasks, contact information, logs history, and quickly coordinates with Microsoft Office programs for quick and accurate population of customized documents. Help+Manual's plugin system is designed to allow 3rd party software companies to add their own plugins, like the HTML-based plugin system in Microsoft® Word. Right now, there are two plugins readly available and shipped with all Professional and Floating licenses.
This wiki page is part of the documentation for The Original Egg-Bot. Click here to return to the Egg-Bot overview. |
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.Please read below for specific instructions for Mac, Windows, and Linux.
Optionally but suggested, you may also want to download the set of example files from the EggBot Releases page.
- 1Mac
- 2Windows
- 3Linux
Mac[edit]
For recent macOS, 10.11 - 10.15 Catalina, and macOS 11 Big Sur[edit]
Our primary release of the EggBot software is available for Inkscape 1.0, and works under macOS 10.11 through macOS 11 Big Sur
- 1. Download and run the AxiDraw installer, which includes the EggBot software.
- 2. Download and install Inkscape 1.0 for Mac
- 3. (Recommended): Delete the AxiDraw installer. (It may, erroneously, show up in your notifications center if you do not.)
Legacy install for older macOS 10.7 - 10.10[edit]
- 1. Download and open the EggBot 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).
Troubleshooting[edit]
- If you encounter difficulty installing the EggBot extensions for Inkscape (or with plotting, in the next stage), please request assistance through our contact form or through the EggBot forum.
- If there is a chance that a problem you encounter is specific to EggBot 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 EggBot. And, we'd like the Inkscape team to be ready to help us when we do encounter Inkscape-specific issues.
- If you are using the 'Legacy' version with Inkscape 0.92 and XQuartz, there are two additional tips to note:
- Keyboard shortcuts use control (^) instead of Cmd (⌘) as modifier key. And,
- If copy and paste are not working correctly in Inkscape, open the X11 preferences dialog, and disable the 'Update Pasteboard when CLIPBOARD changes' option.
Windows[edit]
Installation[edit]
1. Download and run the AxiDraw v 2.7.0 installer for Windows, which includes the EggBot software: Download link (6.2 MB)- The installer is an executable, named 'AxiDraw_270r2.exe'.
- 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 EggBot-specific issues-- see note below about troubleshooting.
Alternative (Manual) install[edit]
- If you already have Inkscape 1.0 installed on your computer, you also manually install the EggBot extensions. For Windows 8 and older versions, please use the installer above for the first time that you install EggBot 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 (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:
- A. Open Inkscape 1.0
- 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[edit]
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 EggBot 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 EggBot. And, we'd like the Inkscape team to be ready to help us when we do encounter Inkscape-specific issues.
Linux[edit]
The EggBot extension for Inkscape has been developed and tested extensively under Ubuntu. We expect it 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.
Installation[edit]
- 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 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.
- Download and unzip the software in this ZIP archive. Copy its contents (32 items total; 30 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.
Adding dialout access[edit]
Adding your user account to the 'dialout' group:
- In recent Linux releases, it is also necessary to change your user permissions, to explicitly grant access to the USB port where the EggBot 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 quotation marks or angle brackets!).
- 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 'dialup' 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.
sudo usermod -a -G dialout <myUserName>'
Troubleshooting
- If your permissions are not correct (your user is not in the dialout group), you may get consistent 'Unable to find an Eggbot' type error messages.
- If the EggBot 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 EggBot folder, and .py files might be misplaced)
Additional linux configurations[edit]
If you use EggBot under Linux, please feel free to add your known-working linux distribution and/or configuration to this non-exhaustive list:
- Ubuntu 18.04 with Inkscape 0.92
- Ubuntu 14.04 with Inkscape 0.91
- Ubuntu 12.04 with Inkscape 0.48.2 - 0.48.4
- Fedora Core 18 with Inkscape 0.48.4
- Debian 7 Wheezy with Inkscape 0.48.3.1
- Antergos 18.3 with Inkscape 0.92.2 2405546
Firmware Update[edit]
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.
To update your firmware, please follow the directions here.
for the TNTgis software family
The instructions below specify TNTmips but the same instructions are valid if you have purchased a professional license for TNTedit or TNTview.
DOWNLOADING
Stay current with the latest features and patches for TNTmips by downloading and installing each weekly edition. The weekly editions can be run as a new installation or used to update a previous installation of the same version.
What do I do if the file didn't download or if download was not complete? We have hundreds of successful downloads from our site each week. While we know there can be a problem with our web site or a link, most of the time the problem ends up being a result of an unreliable communication link to the internet.
A download manager can continue a download after it fails, from the same place it stopped. A download manager can help you save days of trying to download very large files, even from unreliable sites or with unreliable internet connections. Gozilla is one such download manager. It can be a little tricky to figure out, but works great once you know how to use it. Please look at our web page 'Download Managers' for more information. It will tell you how to resume interrupted downloads of large files.
You may contact the reseller closest to you if you are unable to download the file or order TNTmips Free on CD directly from MicroImages (cost including shipping: US$50).
LICENSE LEVELS
The TNTgis download file is the same for all license levels: TNTmips Pro, TNTmips Basic, and TNTmips Free. To find which license is right for you compare the capabilities of TNTmips Free, Basic, and Pro.
- TNTmips Pro is for professional users and uses a software license key to enable full functionality.
- TNTmips Basic is a low cost license of TNTmips and requires a TNTmipsBasic.mi_key.file to activate the license.
- TNTmips Free is a no cost license of TNTmips for small-scale projects. TNTmips Free is not a demo, but a large, full-featured geospatial analysis software package. (TNTmips Free replaced TNTlite and does not require an activation code.)
The first time you start TNTmips, you will be prompted to select a license level via the License Configuration window. See the License Configuration section below for details.
INSTALLING
First time installing - Windows
If this is the first time installing TNTmips, just follow the instructions given when you double-click the installer file.
First time installing - Mac
Steps to install under macOS the first time:
UNPLUG TNTmips USB LICENSE KEY(applicable only for Professional license)
INSTALL XQUARTZ
- 1. Download XQuartz 2.7.9 (or optionally XQuartz 2.7.10 or later)
Be sure to choose version 2.7.9 in order to run without manual modification.
IMPORTANT: XQuartz 2.7.10 and later versions are supported only if you are able to make the manual modifications described below. - 2. Double-click downloaded file shown near the bottom of your browser window.
Proceed as usual through prompts to install. - 2b. If using xQuartz 2.7.10 or later do the manual modifications steps described below.
- 3. Restart machine
You may see 'a new version of XQuartz is available' message ... do not update it. - 4. Download TNTmips
- 5. Via Finder go to Downloads
(You will not be able to install by double-clicking the downloaded file in the browser window.) - 6. Ctrl-click on downloaded .pkg file and choose Open from the menu.
A dialog opens saying it 'can't be opened because Apple cannot check it for malicious software'.
Choose Open and it will let you proceed. - 7. A dialog opens saying 'Welcome to the TNTgis installer'.
Proceed through prompts to finish installing. - 8. Via Finder go to Applications > TNTgis folder - double-click TNTmips
- 9. You will see 'Welcome to the Sentinel Runtime Installer Package' installer (HASP key).
Proceed through prompts to finish installing. - 10. Plug in TNTmips USB license key (applicable only for Professional license)
Non-professional license users will see a License Mode dialog. Click OK to use Free license. - 11. In Finder go to Applications > TNTgis folder - double-click TNTmips
You will see prompts to choose Language and a font message.
Then TNTmips menu bar will open.
INSTALL TNTmips
INSTALL LICENSE KEY DRIVER
START TNTmips
Manually Modify XQuartz (beyond 2.7.9)
DO THESE STEPS (after step 2 above) ONLY IF USING XQUARTZ 2.7.10 OR LATER. In order to use the latest version of XQuartz with TNTgis, you need to manually change one of the library files as described here.
(Note, we recommend you use XQuartz 2.7.9 if you have other applications that use XQuartz. XQuartz 2.7.9 can be installed and used without any modification, however, you will be frequently reminded to update it.)
Install XQuartz as described in steps 1 and 2 in previous section: First time installing – Mac..
Open the Terminal window:
- use Finder to open the Terminal (under Applications > Utilities)
Carefully type the following commands in the Terminal to move the libXt.6.dylib file:
- a. Change the current directory.
- cd /opt/X11/lib
- b. Copy the file from flat_namespace folder to the current directory.
- sudo cp ./flat_namespace/libXt.6.dylib .
- (Note the period at the end, which indicates it will be copied to the current directory.)
- c. Use the list comand again to check that libXt.6.dylib file has been copied to the current directory.
- ls -l libXt*
Continue with step 3 in previous section: First time installing – Mac.
Update an installation
Installing a more recent edition of the same version of TNTmips on a Windows computer can usually be done without uninstalling. However, MicroImages generally recommends completely uninstalling TNTmips and then re-installing it.
In most cases you can run the installer to update over previously installed TNTmips software, however, there are some cases where this will not be successful. Reasons for this include the presence of OS patches, security software and settings, user account settings, and the nature of the updates made by MicroImages from week to week. In addition, installation problems are not always reported by the operating system. Note that uninstalling will not affect user settings, unless you choose to manually delete the settings files.
Completely uninstall and re-install TNTmips
Follow these steps to safely update an installation or to correct an installation problem.
- 1. Turn off TNTmips. Make sure TNTmips and other TNTgis applications are not running. (On Windows make sure you shut off the X Server - when running an MI/X icon is shown in the system tray).
- 2. Uninstall existing version. Here's how:
- Windows: open Start > Control Panel > Add or Remove Programs. Find 'MicroImages TNTgis [version]' in the list, select it, and click Remove. Follow instructions given in the InstallShield Wizard to completely remove.
- Mac: Move the application folder to the Trash. The default installation location is: Program Files > TNT_[version]
- 3. If you are on a Windows computer, manually delete installation folder after uninstalling. After uninstalling in step 2, navigate to C:Program FilesMicroImages using Windows Explorer and delete the TNT_[version] folder. Note: you may skip this step in most cases, however, you should not skip it if you know you have an installation problem.
Caution: in older operating systems such as Windows XP, deleting the installation folder will remove user settings. If you have purchased TNTmips Basic it will remove your license. Please contact Technical Support for additional help.
- 4. Reboot your computer after uninstalling.
- 5. Install the latest edition of TNTmips. Make sure you have administrative privileges. For Windows, log in as administrator; for Mac, you will be prompted for an administrator password. Install to the default location.
STARTING TNTmips
After you've installed TNTgis start the TNTmips software via the TNTmips start icon (or choose the TNTedit or TNTview icon if you've purchased a professional license for them).
In Windows, find the TNTmips icon in the MicroImages section of your Apps list, start it there or right-click on it and pin it to your start screen or taskbar. If you have a Start menu, navigate from your Start menu to MicroImages > TNT_[version] > TNTmips.
For Mac, select Go -> Applications from the desktop menu. Open the TNT_[version] item in the Applications list, and click the TNTmips icon.
Note: you will also see icons or shortcuts for other TNTgis software: TNTedit, TNTview and TNTatlas. The functionality of these programs is included in TNTmips so there is no reason to start these programs separately. Exception: you will need the TNTview or TNTedit shortcuts if you have purchased a professional license for either of these components. TNTatlas is a free geodata viewer you can use to provide your electronic maps, geodata, and layouts to others. To do so you would bundle your atlas file and associated geodata layers with TNTmips.
LICENSE CONFIGURATION
The first time you start TNTmips, you will be prompted to select a license level via the License Configuration window. You can also open the License Configuration dialog at any time via Help > Configure License.
Professional License Level
For TNTmips Pro (or TNTedit Pro and TNTview Pro) choose Professional, and follow the instructions given to install the HASP USB key driver(with hardware key), which shows only if has not been previously done. See the Installation and Setup Guide for detailed instructions.
Basic License Level
To acquire a Basic license, you must first run as TNTmips Free — when it starts up you will be asked if you want to upgrade to TNTmips Basic. After acquiring the Basic license you will update the License Configuration dialog to the Basic license level.
Free License Level
No license is required — just download, install, and run.
INTERFACE LANGUAGE KITS
Tnt Mac Software Manual Install
TNTmips is an international product that lets you select from a growing number of interface languages. All current language kits are bundled with the TNTmips download. You can select the interface language you want during the TNTmips setup process.
Tnt Mac Software Manual Installer
FREE TUTORIALS
Tnt Mac Software Manual Installer
MicroImages provides numerous free tutorial and application booklets with step-by-step lessons for learning the many features and processes of the TNTmips and the other TNTgis softare. All tutorials are included with your TNTmips installation and are also available to view and download on-line.