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