Skip to content

Latest commit

 

History

History
65 lines (46 loc) · 4.62 KB

SIMPLEINSTALL.md

File metadata and controls

65 lines (46 loc) · 4.62 KB

Simple and Straightforward Instructions for Installing A-Z+T on MS Windows

(Or just run this script as administrator; most of this page will be taken care of.)

If you want to follow the install step by step (and maybe make some changes), the rest of this document offers instructions (with exactly one set of options; to explore more options, see INSTALL).

For simple install instructions for Ubuntu Linux, see SIMPLEINSTALL_LINUX.

If any of the following fails, please write me, including your logs and copy/pasting all errors you find into the Email (this page can help you find your logs).

Before you can Set up A-Z+T for normal use, you need to do two things:

  1. Install Python
  2. Install Git and Download A-Z+T

Install Python

  1. Download and install Python from here. As of July 2024, versions 3.9-3.12 seem to work for Windows modules. At this step:

Add Python to Path

Be sure to check "add to PATH" during the install process. If you don't do this, you will likely need to ask your local IT support for help adding Python to your path. While you are waiting for the download, you can start on Install Git and Download A-Z+T below

Be sure to click on "remove path limitation" after the above, to avoid certain problems with longer filenames.

  1. This should be obsolete; skip unless you have problems later: Open a terminal (hit the Windows key then type cmd in the search box), and paste each of these (and hit enter):
    • python -m pip install --upgrade pip setuptools wheel
    • python -m pip install pyaudio
    • python -m pip install Pillow lxml (not required; if you get an error here, just skip it)
    • python -m pip install patiencediff (not required as of Jan 2022; if you get an error here, just skip it)

Install Git and Download A-Z+T

Install Git (website)

  1. Download and install Git from here

Download A-Z+T

  1. On your Desktop, right click select Git-Bash to get a terminal (black window).
  2. In the Git-Bash terminal, paste git clone https://github.com/kent-rasmussen/azt.git and hit enter. This will give you an azt folder on your desktop, where the A-Z+T program files will stay.

Fonts

If you don't already have Charis SIL on your system, download and install the most recent version from here.

First Run of A−Z+T

The first time you run A−Z+T, it will check that you have all the necessary python modules installed. If you don't, this isn't a problem, but it will take a moment and install them for you. If you run into problems installing pyaudio (especially ones including Microsoft Visual C++), it may help to run these two commands

  • python -m pip install pipwin
  • pipwin install pyaudio

Set up A-Z+T for normal use

Once you have completed everything under Install Python and Install Git and Download A-Z+T:

  1. Click to open the azt folder on your desktop
  2. Right click on main.py (it may appear as main on your system), and select "Send to... Desktop (create shortcut)".
  3. Click on the shortcut/link to run A-Z+T (if you get nothing but a black flicker, see this page.)
  4. Celebrate your accomplishment; you're done installing A-Z+T!
  5. Read USAGE for how to use A-Z+T
  6. Send me information on any bugs you find, so I can help you and improve the program for others.

Additional Important Steps to get the most out of A-Z+T

Install Mercurial for better collaboration

Download and install this file.

Praat

  • If you use Praat, make sure the Praat executable is in your operating system's path. You may need to ask your IT support for help, if you don't know how to do this (Basically, put it in your Programs (?x86) directory).

Be ready to make and edit reports

Install the full XLingPaper package from here.

Update A-Z+T from the Help menu, assuming you have followed these instructions.