How to install OBD Amigos on macOS

1. open a Terminal window
   
   
2. MacPorts requires the Apple Command Line Developer Tools, therefore if you haven't already installed them then do so by entering the following command:
   

   xcode-select --install
   

   
   
3. install MacPorts from the official MacPorts web site.
   
   After installing MacPorts to make sure that MacPorts is up-to-date run the following command:
   

   sudo port -v selfupdate
   

   
   
4. install 'wget' from MacPorts:
   

   sudo port install wget
   

   
   
5. create a directory for OBD Amigos and make it the current directory:
   

   mkdir ~/obd_amigos
   cd ~/obd_amigos
   

   
   
6. use the following commands to download all program files from http://obd-amigos.linuxtech.net/files/ into this directory:
   

   wget http://obd-amigos.linuxtech.net/files/obd_amigos.ini
   wget http://obd-amigos.linuxtech.net/files/OBD_Amigos.command
   wget http://obd-amigos.linuxtech.net/files/update
   wget http://obd-amigos.linuxtech.net/files/update-files.txt
   sh update
   

   
   
7. make the program and the desktop shortcut executable:
   

   chmod 755 obd_amigos.pl
   chmod 755 OBD_Amigos.command
   

   
   
8. move the desktop shortcut to the Desktop:
   

   mv OBD_Amigos.command ~/desktop/
   

   
   
9. install Perl and other required dependencies from MacPorts:
   

   sudo port install perl5
   sudo port install p5-datetime
   sudo port install p5-config-simple
   sudo port install p5-device-serialport
   sudo port install xorg
   sudo port install p5-tk
   sudo port install ImageMagick
   sudo port install liberation-fonts
   

   At this point you will need to reboot your Mac for the xorg package.
   
   
   
10. edit the configuration file (obd_amigos.ini) to suit your car and OBD2 adapter
    
    The two most important configuration parameters that you need to edit are the serial device file and
    baud rate of your OBDII adapter ("port_details" parameter) and your vehicle type ("gen" parameter).
    
    You should also uncomment the "screenshot" parameter preconfigured for macOS
    (remove the hash "#" at the beginning of the line).
    
    All other configuration parameters are optional and can usually be left at default values.
    
    
    
11. run obd_amigos.pl from the Terminal to check whether it starts successfully:
    

    cd ~/obd_amigos
    ./obd_amigos.pl
    

    If it starts successfully from the Terminal then you should also be able to start it from the Desktop shortcut.