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: 12 Average: 4.2]

10 Responses to “How To Compile Notepadqq on Debian/Ubuntu/Raspbian

  • Excellent!
    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?

    • Xiao Guoan
      2 years ago

      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
    2 years ago

    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
    2 years ago

    Did you test this on RPi at all?

    • Xiao Guoan
      2 years ago

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

    • Xiao Guoan
      2 years ago

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

    • Xiao Guo-An (Admin)
      2 years ago

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

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

  • Emily Ann
    2 years ago

    omg thank you! xoxo

  • Joseph
    1 week ago


    I used to be able to do this previously with a Raspberry Pi 3 (stretch) but now if I follow the tutorial I run into these problems at the command ./configure –prefix /usr –qmake /usr/lib/arm-linux-gnueabihf/qt5/bin/qmake

    checking for Qt5WebEngine library… not found!
    checking for Qt5WebEngineWidgets library… not found!
    checking for Qt5WebSockets library… not found!
    checking for Qt5WebChannel library… not found!

    Subsequently, if I proceed to make, the error surfaces:
    Project ERROR: Unknown module(s) in QT: webenginewidgets webchannel websockets
    Makefile:43: recipe for target ‘sub-src-ui-make_first’ failed
    make: *** [sub-src-ui-make_first] Error 3

    I really liked notepadqq and would appreciate any help to get it working again!

    Thanks in advance!

Leave a Comment

  • Comments with links are moderated by admin before published.
  • Your email address will not be published.
  • Use <pre> ... </pre> HTML tag to quote the output from your terminal/console.
  • * Some of my previous answers are lost after I uninstalled Disqus comment system from my website. I try to recover those answers whenever I can.