Skip to content

aarnt/octopi

Repository files navigation

This is Octopi, a powerful Pacman/AUR front end using Qt libs.

Main window

The project site is hosted on https://tintaescura.com/projects/octopi

Currently, 12 Linux distros are compatible with it

What you must install in order to have Octopi fully functional

You'll need:

  • Alpm_octopi_utils library
  • A helper to execute pacman commands called "octphelper", available on "./helper" dir
  • A privilege escalation tool called qt-sudo
  • qtermwidget package, in order to build Octopi with embedded terminal support

To install Octopi using pacman

If Octopi package is available in your distro's repository, you can just type:

# pacman -S octopi

Steps to build Octopi source code (qmake)

Assuming you have vala compiler and Qt5 libs properly installed, follow these steps:

$ git clone https://github.com/aarnt/alpm_octopi_utils
$ cd alpm_octopi_utils
$ make
# make install
$ cd ..
$ git clone https://github.com/aarnt/qt-sudo
$ cd qt-sudo
$ qmake-qt5
$ make
# make install
$ cd ..
$ git clone https://github.com/aarnt/octopi
$ cd octopi/helper
$ qmake-qt5
$ make
# make install
$ cd ../notifier
$ qmake-qt5
$ make
# make install
$ cd ../cachecleaner
$ qmake-qt5
$ make
# make install
$ cd ../repoeditor
$ qmake-qt5
$ make
# make install
$ cd ..
$ qmake-qt5
$ make
# make install

You can also use the available PKGBUILD script that helps you build Octopi with all its tools:

$ cd OCTOPI_PATH (where you git cloned the source code)
$ makepkg -f

Steps to build Octopi source code (CMake)

As an alternative to qmake, Octopi can also be built with CMake. Make sure that at least CMake 3.5 is installed.

First, build and install alpm_octopi_utils:

$ git clone https://github.com/aarnt/alpm_octopi_utils
$ cd alpm_octopi_utils
$ mkdir build_dir && cd build_dir
$ cmake -G "Unix Makefiles" .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
$ make
$ sudo make install

Next, build and install Octopi:

$ git clone https://github.com/aarnt/octopi
$ cd octopi
$ mkdir build_dir && cd build_dir
$ cmake -G "Unix Makefiles" .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
$ make
$ sudo make install

To run Octopi

$ /usr/bin/octopi

To run Octopi Notifier

$ /usr/bin/octopi-notifier

To enable AUR support (that "green alien" icon on toolbar)

You'll need to install pacaur, paru, pikaur, trizen or yay in your system. If neither of the previous tools are found Octopi will download latest "yay-bin" github binary. In KaOS, kcp will be supported out of the box.

Ways to help/support Octopi

Enjoy!