Install ArUco on Ubuntu Linux

aruco

ArUco is a library for Augmented Reality applications with a BSD license. The main features of ArUco are: detect markers with a single line of C++ code, detection of AR boards (markers composed by several markers), up to to 1024 different markers, trivial integration with OpenGL and OGRE, fast, reliable and cross-platform. ArUco will help you to get running your AR application in less than 5 minutes.

Install ArUco is simple, just follow these steps:

1. INSTALL OPENCV

The first step is install OpenCV on Ubuntu Linux.

3. DOWNLOAD AND DECOMPRESS ARUCO

Enter the ArUco official website and download the latest version for ArUco. Then decompress the downloaded file.

4. COMPILE ARUCO

Now, in your terminal, make sure you are within the ArUco directory and run the following commands:

mkdir build

cd build

cmake ..

make

sudo make install

5. CONFIGURE ARUCO

In your terminal, execute:

sudo gedit /etc/ld.so.conf.d/aruco.conf

Add the following line and save it:

/usr/local/lib

Now, in your terminal, execute:

sudo ldconfig

Again, execute:

sudo gedit /etc/bash.bashrc

Check if the following two lines are at the end of the file. If not, add them and save the file:

PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig
export PKG_CONFIG_PATH

Finally, reboot your computer.

6. TRY AN EXAMPLE

To test an example, from your terminal enters in the ArUco folder. Once you're inside it, enters in build/utils. Now, execute:

./aruco_create_board 5:2 board.png board.yml

With this, we have created a marker board with a size of 5×2. The image is board.png and board.yml is the board configuration.

boardaruco

5 comments:

  1. Replies
    1. Hi Manule,

      I'm truing use test project and during compilation I receiving this message:

      CMake Error at CMakeLists.txt:4 (find_package):
      By not providing "Findaruco.cmake" in CMAKE_MODULE_PATH this project has
      asked CMake to find a package configuration file provided by "aruco", but
      CMake did not find one.

      Could not find a package configuration file provided by "aruco" with any of
      the following names:

      arucoConfig.cmake
      aruco-config.cmake

      Add the installation prefix of "aruco" to CMAKE_PREFIX_PATH or set
      "aruco_DIR" to a directory containing one of the above files. If "aruco"
      provides a separate development package or SDK, be sure it has been
      installed.


      -- Configuring incomplete, errors occurred!

      I suppose that I have something wrong with configuration?
      Could you please advise?

      Thanks,
      Piotr

      Delete
    2. make install after make did the trick for me

      great library, inspired us to develop some awesome stuff

      Delete
  2. Hello Manuel Ignacio,
    I'm trying to install ARUCO in Ubuntu Server 12.04.2 LTS, but after installing and compiling (make and sudo make install) when i try to run the programs the output in terminal is as follows: Illegal Instruction ('core generado').

    I think is a libraries problem. But i followed all your steps (including OpenCV installation). Have you got any idea?

    Thank you very much.

    ReplyDelete
    Replies
    1. Anonymous: I test Aruco 1.2.4 on Ubuntu 12.04.2 LTS and it's work perfectly. I don't know exactly what happens in your machine. I'm sorry.

      Delete