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.3]

18 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
      8 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
    8 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
    8 years ago

    Did you test this on RPi at all?

    • Xiao Guoan
      8 years ago

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

      • Xiao Guoan
        8 years ago

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

    • Xiao Guo-An (Admin)
      8 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
    8 years ago

    omg thank you! xoxo

  • Hi,

    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!

  • I solved the

    Project ERROR: Unknown module(s) in QT: webenginewidgets webchannel websockets

    error by compiling an older version of Notepadqq (1.2.0 instead of the current 1.4.0). I guess they added these dependencies lately…

    Compile from this:

  • Joe Momma
    5 years ago

    Any chance you could update this for the latest versions of QT? It looks like something is different at this point, and the make files are missing dependencies

    • Joe Momma
      5 years ago

      OK, here’s the deal. Versions of notepadqq after 1.4.8 are using stuff from the qtwebengine5-dev package. However, that package has been removed from the Raspbian package sources because it is setting off some “armv7 contamination” checker.

      Luckily, you CAN build version 1.4.8. After you do the “git clone” above and change to the notepadqq directory, type the following:

      git checkout -f v1.4.8

      You can then follow the instructions above. It can’t hurt to just install all the packages that notepadqq is suggesting to install, like so:

      sudo apt-get install qt5-default qttools5-dev-tools qtwebengine5-dev libqt5websockets5-dev libqt5svg5 libqt5svg5-dev libuchardet-dev

      If you run this, you’ll see that qtwebengine5-dev will fail. The main thing, though, is to make sure that when you run the ./configure line up above that none of the packages show as “not found”

  • hello, i followed your steps, but in the end i ghet the message “bash: notepadqq: command not found”. i have a raspberry pi 3 model b+ with the latest raspbian. what should i do?

  • Helmut Nebauer
    5 years ago

    I performed the steps described in the main area. Then i called

    git checkout -f v1.4.8

    and installed

    sudo apt-get install libqt5webengine-data
    sudo make install

    Hardware: raspberry pi 3B+
    Raspbian stretch freshly installed – 2018-11-13
    Now it works – only the icon is missing 😉

  • Helmut Nebauer
    5 years ago

    For Raspbian Buster I called

    git checkout -b v1.4.8

    instead of

    git checkout -f v1.4.8
  • Norrabder
    3 years ago

    Following Joe Momma’s instructions above for Raspberry Pi 4B and latest Buster OS worked

  • I seem to be the only person installing on Debian, 2 issues so far:
    Using Debian 11.

     git clone >/pre>
    Failed. So I ran:
     sudo apt install git 

    and the came to a stop at

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

    This responded:
    checking for QT5 qmake... /usr/lib/x86_64-linux-gnu/qt5/bin/qmake
    checking for lrelease... /usr/bin/qtchooser -run-tool=lrelease -qt=5
    checking for c++... not found!

    Can anybody help with a fix for this?

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.
  • Please use the community ( for questions unrelated to this article.
  • I don't have time to answer every question. Making a donation would incentivize me to spend more time answering questions.

The maximum upload file size: 2 MB. You can upload: image. Links to YouTube, Facebook, Twitter and other services inserted in the comment text will be automatically embedded. Drop file here