_{Don't edit this file, its generated from Releases.note in doc dir, converted to md and processed by releasepage tool.}

Note, a reasonably mature beta release fixes a couple of bugs and offers a new File Link feature, see https://github.com/tomboy-notes/tomboy-ng/releases/tag/v0.39d . This allows embedding links to other files (anything you OS knows how to open) so can point to image files, music directories etc.

Further, if your OS uses openssl 3.0 then version 0.39 cannot work with it, please try the beta 0.39c if you are doing eg github sync.

WARNING: if you used File Sync, previous to v0.34 and have not upgraded since, you must go into Settings->Sync>FileSync and tick the Enable box. Its a new setting and I cannot tell if you have it unticked because its new or because you want it unticked !

Downloads and information for specific platforms further down the page.

• Release Notes

• Windows Downloads

• MacOS Downloads

• Linux Downloads

• Qt5 and Qt6 now use native dialogues. But must use new libqt5pas or libqt6pas libraries, see below.

• All built with Lazarus 3.0.

• Display backlinks, click Links button with no text selected to see a list of notes that link to this note.

• An important bug fix affecting UTF8 characters in note titles.

• Linux Qt5 version now prefer to use libxcb rather than Wayland. This is mainly due to incomplete features in Wayland itself. Its expected that when Wayland complies with its own spec, this constraint can be removed. Particularly important with non Debian distributions.

• Linux Gnome systems, fixes to try and make usable under Wayland despite its missing features.

• Linux gtk2 version has extra command line switches to manage System Tray Icon. Particularly important with 32bit Linux systems, eg --useappind=yes|no

• Fixed a bug preventing use of Single Note Mode where you open a stand alone note, outside of its normal repository. Note that this bug is present in the Debian version of 0.39.

• Several minor bug fixes (writing of note links substantially faster, corrected text, gtk2 ver no longer depends on libcanberra).

Qt5 and Qt6 users MUST install a new libqt5pas1 or libqt6pas6 libraries, your distro version is almost certainly not suitable any more. Get the new libraries from the links below and install them before or at the same time as you install tomboy-ng

https://github.com/davidbannon/libqt5pas/releases

https://github.com/davidbannon/libqt6pas/releases

tomboy-ng is available for Linux, Mac and Windows. For Debian derivatives (Ubuntu, Mint, Neon etc), tomboy-ng is available from the normal repositories (note, v0.35 and later will be Qt5 based). However, usually newer releases are available here. Others, please see your operating system below -

Tested on 32bit Windows Vista and 64bit Windows 11. Windows users should download the Windows Installer, https://github.com/tomboy-notes/tomboy-ng/releases/download/v0.39/tomboy-ng-setup-0.39.exe, it works for both 32 and 64bit installs. Windows Defender will (quite rightly) tell you it stopped an unrecognised app, warning its risky. Click "More Info" and you will see a "Run Anyway". Now you will be asked if you want to allow an unknown publisher (me!) to change your device. If you do, click yes. Depending on your build of Win11, you may need to go through a process of clicking the More Info link and Run Anyway, possibly through several stages.

Tested and built on an Intel based Mac Monterey but Apple Silicon (aka aarch64) is now also directly supported. Use (https://github.com/tomboy-notes/tomboy-ng/releases/download/v0.39/tomboy-ng64_0.39.dmg). Install by double clicking the .dmg file and drag the tomboy-ng icon into the nearby Applications Folder. Because I don't pay a fee to Apple, first time users will need to control click (that is, hold the Control Key down and click) the tomboy-ng icon in Applications and select "Open".

This is a "Universal Package", will install on both Intel based and ARM64 based systems.

Linux users need to be a bit careful about which version they download. With quite a range of Distributions, Desktops, 32bit and 64bit and GTK2 v. Qt5 v. Qt6 to cater for, its not easy ! The Qt5 version requires Qt5.12 (preferably Qt5.15) or later and 64bit. The GTK version, needs GTK2, pre installed on most Distros at present.

If you use a dark theme with the QT5 version you should also read the man page (man tomboy-ng ) or Dark Theme.

As a general rule, the gtk2 version is your best bet on older operating systems, newer ones, should use the Qt5 or Qt6 ones. The Qt5 and especially the Qt6 may require a few more libraries at install time but they are mostly libraries other apps will want anyway.

New in 0.37, is the need to install a new, non-standard, libqt5pas or libqt6pas library. If using the Qt5 or Qt6 tomboy-ng of 0.37 or later, you MUST install special libraries until the distros catch up. They are at

https://github.com/davidbannon/libqt5pas/releases 64bit Intel or AMD users want libqt5pas-2.15-3.x86_64.rpm or libqt5pas1_2.15-1_amd64.deb

https://github.com/davidbannon/libqt6pas/releases 64bit Intel or AMD users want libqt6pas6-6.2.7-2.x86_64.rpm or libqt6pas6_6.2.7-1_amd64.deb

Download the appropriate library (for your system and for the type of tomboy-ng you intend to use) and install it before or during the tomboy-ng install.

Ubuntu and derivative users (of 64bit U18.04 and U20.04 to U22.04) can use a PPA to install and update this and subsequent releases of tomboy-ng. Please see https://launchpad.net/~d-bannon/+archive/Ubuntu/ppa-tomboy-ng for details. Available a few days after release here. New in version 0.37, the PPA will not be updating the Qt5 versions until the distros have caught up with the new LibQt5Pas library. So, it will be gtk2 only and that works badly with Gnome. Sorry, not anything I can do other than suggest a manual install.

For GTK based distributions that use .deb packages (but cannot use the PPA), do yourself a favour, install Gdebi before you start. But it will require a lot of gtk2 libraries you might otherwise not need.

Ubuntu 22.04 has tomboy-ng v0.34 available in its repository but v0.39 is new and shiny. I hope 0.39 will be in Ubuntu 24.04

Generally, all versions work fine but earlier distributions should use GTK2 and recent ones may use Qt5 based version.

• 16.04 and 18.04 (while out of date, we still test with tomboy-ng) Use GTK2 version 32bit or 64bit. Will not work with QT5.

• 20.04 the GTK2 64bit version which needs only a couple of extra things and is probably a better choice than the Qt5 64bit QT version which needs the Qt5 libraries

• 22.04 and beyond, I suggest the the Qt5 64bit QT version or Qt6 64bit QT version. The GTK2 64bit version is probably OK too as long as you are not using Gnome.

• If using Qt5 or Qt6, see the "Linux Qt5 and Qt6 Libraries" section above.

On Ubuntu, you can install the appropriate package in one of several way -

• Recommended, install gdebi first. Its available from your normal repos and is easy and reliable. Then download the appropriate tomboy-ng package, your browser will direct it to Gdebi. Strongly recommended for U16.04.

• Depending on your version, you may be able to download and get directed to another tool to install, perhaps Software Installer, it probably will not work.

• Thirdly, will work on all except U16.04, click on the appropriate link, download and save the file. Use the following apt command (note the './' in front of the filename, you must explicitly state the location of the file, else apt will look in its own repositories). Adjust the deb name for your specific downloaded file -

Like this -

sudo apt install ./tomboy-ng_0.39-0_amd64.deb [enter]

Pretty much the same as Ubuntu

Tested on Fedora 36, 37, 38, 39. Generally, earlier Fedora the GTK2 32bit or GTK2 64bit version is recommended. Newer versions should use Qt5 64bit QT version or Qt6 64bit QT version. If using Qt5 or Qt6, see the "Linux Qt5 and Qt6 Libraries" section above.

To install, please click on appropriate link, download and save, then use the yum or dnf command, eg -

sudo yum localinstall ./tomboy-ng-0.39-0.x86_64.rpm [enter]

Fedora's default install is based on Gnome and recent Gnome versions block the System Tray icon. Please see https://github.com/tomboy-notes/tomboy-ng/wiki/System-Tray-on-Linux . Other flavours of Fedora (eg Plasma, Cinnamon, XFce) all seem happy to display the System Tray Icon.

An older version of tomboy-ng, v0.32 is available in the Debian Bullseye repository and 0.36c in Bookworm. Sadly, changes were made to Bullseye after it was added to Debian, that version will have problems if you use a Gnome Desktop. Please see https://github.com/tomboy-notes/tomboy-ng/wiki/System-Tray-on-Linux . For other Desktops, you can install as you would for other repository applications but the version here is "bigger and better". Both Bullseye (11) and Bookworm (12) benefit from manually installing the latest release from here, I recommend the gtk2 type for simplicity, debs : 32bit or 64bit . Also available is the Qt5 64bit QT version or Qt6 64bit QT type.

I recommend downloading the file and using the apt command (note the full path to the filename, you must explicitly state the location of the file, else apt will look in its own repositories).

cd ~/Downloads
sudo apt install ./tomboy-ng_0.39-0_amd64.deb [enter]    -- note the Qt5 version has a slightly different name.

Bookworm has 0.36b and most desktops just work. However, Gnome-Shell may need an extension added, see https://github.com/tomboy-notes/tomboy-ng/wiki/System-Tray-on-Linux . In all cases, if using Qt5 or Qt6, see the "Linux Qt5 and Qt6 Libraries" section above.

Trixie (Testing) will probably have 0.37 available not too long after the 0.37 release.

If you wish to sync to a SMB: network share, open that connection before configuring tomboy-ng sync. If you cannot see it in the File Dialog, you probably will need to install gvfs and gvfs-fuse (but bookworm seems to have them preinstalled, good).

And other Linux Distributions that use the Arch, Pacman package system. This is new and therefore relatively untested but does look OK. I have made only a GTK 64bit version at this stage, could make other combinations if needed. Click the link, choose download and install with this command from ~/Downloads -

sudo pacman -U ./tomboy-ng-0.39-1-x86_64.pkg.tar.zst

Generally use the Qt5 64bit version or Qt6 64bit and look at https://github.com/tomboy-notes/tomboy-ng/wiki/System-Tray-on-Linux if you are using Gnome . Other Desktops should be OK with GTK2 32bit or GTK2 64bit. Almost all the necessary libraries seem to be pre installed in either case. If using Qt5 or Qt6, see the "Linux Qt5 and Qt6 Libraries" section above.

Suse is quite pushy about signing rpm packages, more work for me and it means you need to import the PGP signature I have used. So, please download tomboy-ng-GPG-KEY (you may need to right click and choose "Save Link as") and run this command in the directory you downloaded to, note this is only necessary once -

sudo rpm --import tomboy-ng-GPG-KEY [enter]

Next, to install tomboy-ng, please click on appropriate link, and if it suggests YaST2: Ruby, allow it to install, it works well. If you receive an error message, its almost certainly because you have not yet installed the signature file mentioned above. You may prefer to download and use the zypper command -

sudo zypper install ~/Downloads/tomboy-ngQt-0.36a-1-x86_64.rpm [enter]

Mageia warns you if you try to install a package who's signature it does not recognise. You can tell it not to worry and install anyway or, to put its mind at rest, download tomboy-ng-GPGKEY (you may need to right click and choose "Save Link as") and run this command in the directory you downloaded to, note this is only necessary once -

sudo rpm --import tomboy-ng-GPG-KEY [enter]

Then, you can just click on the appropriate tomboy rpm link GTK2 32bit , GTK2 64bit , Qt5 64bit or Qt6 64bit and allow Software Installer to install it for you but I found it occasionally generated an error that you don't get to see ! Try it by all means but if you don't find your tomboy-ng installed or upgraded, then revert to old fashioned way, download the file, save it, and use a command a bit like this -

sudo -c "yum localinstall ./tomboy-ng-0.39-1.x86_64.rpm" [enter]

• Mate, XFCE, KDE (ie Plasma) and Cinnamon work fine.

• Mageia with Enlightenment is probably better with the gtk2 or Qt5 version.

• Mageia Gnome, its likely that the comments relating to Fedora Gnome above apply but have not been tested.

To install, please download and save the file, then use the rpm command, note that rpm seems to require you to uninstall a previous version, doing so will not remove notes or config. Using the Qt5 version on Mageia is possible if you replace its very dated version of lib64qt6pas1 with the appropriate one from https://github.com/davidbannon/libqt5pas/releases.

Users of the official Raspberry Pi OS (previously know as Raspbian) can now download a deb and install it using the apt commands mentioned above.

If your Operating System is 32bit download Qt5 32bit

If your Operating System is a 64bit download gtk2 64bit

I have not made Raspberry Pi rpms, seems few users.