How To Compile Notepadqq on Debian/Ubuntu/Raspbian

In a previous tutorial, I showed you how to install Notepadqq, a Notepad++ clone, on Debian, Ubuntu, Linux Mint, Elementary OS and Arch Linux. A reader recently asked me how to install Notepadqq on Raspberry Pi. Installing Notepadqq on Raspbian using the PPA is an awkward experience. Instead I will show you how to compile Notepadqq source code and then install it on Debian, Ubuntu and Raspbian.

compile Notepadqq on Debian/Ubuntu/Raspbian

First install qt5 tools.

sudo apt-get install qt5-qmake
sudo apt-get install -y libqt5webkit5 libqt5svg5 coreutils
sudo apt-get install -y libqt5webkit5-dev libqt5svg5-dev qttools5-dev-tools

Then clone the notepadqq Git repository.

git clone
cd notepadqq

Configure the environment.

For 64 bit Debian/Ubuntu

./configure --prefix /usr --qmake /usr/lib/x86_64-linux-gnu/qt5/bin/qmake

For 32 bit Debian/Ubuntu

./configure --prefix /usr --qmake /usr/lib/i386-linux-gnu/qt5/bin/qmake


./configure --prefix /usr --qmake /usr/lib/arm-linux-gnueabihf/qt5/bin/qmake

Compile the source code and install it.

sudo make install

Now you can launch Notepadqq by typing notepadqq in the terminal window.

My Raspberry Pi is headless, so I create a VNC connection to it. The following screenshot shows Notepadqq running on Raspberry Pi. If you can’t see it clearly, then right-click the image and select open image in new tab to see the full image.

notepadqq running on Raspbian

notepadqq running on Raspbian

How to Remove Notepadqq

cd into the source directory

cd notepadqq

Uninstall it.

sudo make uninstall


Rate this tutorial
[Total: 3 Average: 5]
  • Klaus

    Your step by step instructions are really helpful for me as a Linux newbie.
    I know I wasn’t the only one asking for your help with this, but I hadn’t expected you to follow up so swiftly.
    Thank you!

    Having looked at your instructions for a while it hit me:
    Aren’t your instruction a recipe for compiling any software based on the qt5-qmake repository?
    The only instructions required to be adapted would be these:
    git clone
    cd notepadqq
    Replacing the string ‘notepadqq’ with the appropriate package name.
    Or am I mistaken?

    • The git clone command is used to fetch the source code from Github if the source code is available on Github. If not, you have to download the source code elsewhere.

      The Github address is not always For example, the github address for shadowsock android is:

      The configure command may also need to be adapted to the specific software package.

  • wordsforthewise

    In raspbian jessie on RPi 2 it gave me this error:

    Project ERROR: Unknown module(s) in QT: webkitwidgets svg
    Makefile:38: recipe for target ‘sub-src-ui-make_first’ failed
    make: *** [sub-src-ui-make_first] Error 3

    Then I noticed the qttools5-dev-too package isn’t there, but instead tried the qttools5-dev package, and it installed. Now, after trying ‘sudo make’, it’s giving the error:

    Makefile:508: recipe for target ‘make_translations’ failed
    make[1]: *** [make_translations] Error 1
    make[1]: Leaving directory ‘/home/pi/notepadqq/src/ui’
    Makefile:38: recipe for target ‘sub-src-ui-make_first’ failed
    make: *** [sub-src-ui-make_first] Error 2

  • wordsforthewise

    Did you test this on RPi at all?

    • The compilation and installation on my RPi was successful. I just don’t have a monitor to connect to it.

      • I created a VNC connection to my RPi, and captured a screenshot. See the updated article.

    • See the updated article. I created a VNC connection to my RPi, and captured a screenshot.

  • Zinas

    I’ve tested on Raspberry PI 3 and it’s running perfectly!

  • Emily Ann

    omg thank you! xoxo