How to install OBD Amigos on Linux

These instructions have been tested on Ubuntu 20.04 LTS, they should work with most Ubuntu and Debian derived distros.
  1. open a Terminal window

  2. create a directory for OBD Amigos and make it the current directory:
    mkdir ~/obd_amigos
    cd ~/obd_amigos

  3. download all program files from into this directory:
    sh update

  4. make the program executable:
    chmod 755

  5. install the required dependencies:
    sudo apt update
    sudo apt install perl-tk
    sudo apt install libdatetime-perl
    sudo apt install libconfig-simple-perl
    sudo apt install libdevice-serialport-perl
    sudo apt install imagemagick
    sudo apt install fonts-liberation
    sudo apt install gnome-accessibility-themes

  6. edit the OBD_Amigos.desktop file and fix the following line:


    by replacing 'username' with you actual Linux username.

  7. move the desktop file to the Desktop:
    mv OBD_Amigos.desktop `xdg-user-dir DESKTOP`
    In the above command please make sure you use backticks (`), not normal single quotes.

    In the Ubuntu Gnome desktop environment you need to explicitly allow launching applications
    from the desktop icon. To do this right-click on the OBD_Amigos.desktop icon and
    select "Allow Launching" in the pop-up menu that appears (see screenshot).

  8. 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).
    All other configuration parameters are optional and can usually be left at default values.

  9. add your username to the 'dialout' group to have permission to access the serial device:
    sudo adduser yourusername dialout
    (to apply this change you have to logout and then login again.
    You can check that this has worked by running the command 'id', check that the 'dialout' group is listed)

  10. run from the Terminal to see if it starts successfully:
    cd ~/obd_amigos
    If it starts successfully from the Terminal then you should also be able to start it from the Desktop icon.

Please note:
The ELM327 compatible OBD2 adapter must be connected to your laptop first, before starting OBD Amigos.
In case you get the error "Couldn't find an ELM module" check that the serial device file (usually /dev/ttyUSB0 for USB adapters or /dev/rfcomm0 for bluetooth adapters) exists.

In case of problems with the installation you can get in touch using the email address provided on the main page. Please provide an exact description of the problem including the complete output you get from OBD Amigos on the Terminal, including any error message, specify the OBD2 adapter you are using (if it's a unknown cinese one then please make a photo of the adapter), the Linux distribution and version, and the exact model of the car you are trying to connect to.

'OBD Amigos' is copyright © 2020-2023 LinuxTECH.NET, all rights reserved,
the current version of this program is free for personal use but redistribution is strictly prohibited.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE

 [OBD Amigos main page]