Installing labelbuddy

Installing a binary copy

On Ubuntu

Packages built for different Ubuntu distributions are published on this Personal Package Archive. Add it to your system by executing:

sudo add-apt-repository -y ppa:jdockes/labelbuddy
sudo apt update

Then the latest release of labelbuddy (and any future releases) can be installed with:

sudo apt install labelbuddy

If you don’t want to add the PPA to your sources list you can manually choose and download one of the published packages, then install it with apt, for example:

sudo apt install ./labelbuddy_0.0.11-1~jammy1_amd64.deb

To use labelbuddy without installing anything, see below.

On Debian

Binary packages can be downloaded from the downloads page. Once you have downloaded the package, you can install it with apt, for example:

sudo apt install ./labelbuddy_0.0.11-1~bookworm1_amd64.deb

To use labelbuddy without installing anything, see below.

On any Linux distribution

An AppImage is provided in the downloads page (file name: labelbuddy-0.0.11-x86_64.AppImage). You can download it by clicking this link. That is a single self-contained executable that can be run on any of the common Linux distributions. Simply download the .AppImage file, make it executable and run it. This can be done by executing:

wget https://github.com/jeromedockes/labelbuddy/releases/download/v0.0.11/labelbuddy-0.0.11-x86_64.AppImage

chmod u+x ./labelbuddy-0.0.11-x86_64.AppImage
./labelbuddy-0.0.11-x86_64.AppImage

You can optionally rename the executable (.AppImage file) to labelbuddy, and move it to a location in your $PATH. This will enable using the command labelbuddy to start the program.

On Windows

An installer for Windows is provided in the downloads page (file name: labelbuddy-0.0.11-windows-installer.exe). You can download it by clicking this link. Download the installer and execute it. Windows will warn that labelbuddy is an "unrecognized app", displaying a message like "Windows protected your PC …​". Click on "more info", then "run anyway".

labelbuddy can be uninstalled from the Windows applications menu, or by running the maintenancetool.exe executable found in the labelbuddy installation folder.

You can also use labelbuddy without installing it. Instead of using the installer, download the file named labelbuddy-0.0.11-windows.zip from the downloads page (or click this download link). Extract the contents of the .zip file, then execute the file labelbuddy.exe that it contains to start labelbuddy.

On MacOS

An Apple Disk Image is provided in the downloads page (file name: labelbuddy-0.0.11.dmg). You can download it by clicking this link. Double-click the downloaded file, and from the window that opens, drag labelbuddy into the /Applications folder in Finder.

The first time you try to open labelbuddy, MacOS will warn that it "cannot verify the developer". To start labelbuddy anyway you can press Ctrl while you click the labelbuddy icon, then in the dialog that appears select "Open" (you may have to do the Ctrl-click twice). Another way is to visit System Preferences  Security & Privacy once the warning appears, and click "Open Anyway".

You can also run labelbuddy without installing it: instead of dropping it into /Applications, visit the .dmg file in Finder and double-click (or Ctrl-click, see above) the labelbuddy file it contains.

If you also want to use labelbuddy’s command-line interface, add a symlink in a location in your $PATH for your shell to find the labelbuddy command. For example:

ln -s /Applications/labelbuddy.app/Contents/MacOs/labelbuddy /usr/local/bin/labelbuddy

Building from source

Download a source distribution from the downloads page, or get the latest code by cloning or downloading the labelbuddy git repository.

labelbuddy uses Qt 5. Qt can probably be installed with your package manager, for example:

apt install qtbase5-dev

or

yum install qt5-qtbase
yum install qt5-qtbase-devel

Otherwise you can get it from the Qt downloads page.

labelbuddy can be built with CMake. In an empty directory run:

cmake /path/to/labelbuddy/CMakeLists.txt
cmake --build .

Then labelbuddy can (optionally) be installed with:

sudo make install

labelbuddy can also be built with qmake:

qmake /path/to/labelbuddy/labelbuddy.pro
make

Building labelbuddy should be straightforward, so if you run into any difficulties please open a GitHub issue.