[HowTo] Installing AMOR from source on Debian 12 (bookworm)

[Hallvor]

Disclaimer: This might just be the most useless howto ever, but who says that fun has to be useful? Keep in mind that the application below is made for KDE Plasma, so other desktop environments will have to install a lot of dependencies. (Please don't do it.)



What is AMOR?
AMOR is an acronym for Amusing Misuse of Resources. It creates an animation that sits on top of the current window.

Since AMOR has vanished from the Debian repositories, it requires compiling source code from GitHub.

A demonstration can be found here: https://www.youtube.com/watch?v=8dd7S4R2SPY

Store.kde.org has many skins, so you can have a cat, a woman, Darth Vader, Super Mario, etc. living on your desktop. Please be careful when adding code from external sources outside the official Debian repositories: https://store.kde.org/browse?cat=465&ord=top

Let's do this.


Privileges

# means that the command must be used with root or sudo
$ means that the command should be executed as your regular user


Preparing and building AMOR

Before building from source, it is a good idea to read a little on the project's page: https://github.com/KDE/amor

This page is especially useful, because it lists all the necessary requirements and dependencies: https://github.com/KDE/amor/blob/master/CMakeLists.txt Requirements and dependencies should always be checked before attempting to build anything from source.

Update your system:

Code: Select all

# apt update && apt upgrade

Install the required dependencies:

Code: Select all

# apt install build-essential cmake qtbase5-dev libqt5svg5-dev qttools5-dev libkf5windowsystem-dev libkf5configwidgets-dev libkf5xmlgui-dev libkf5dbusaddons-dev libkf5archive-dev libkf5notifications-dev libkf5completion-dev libkf5iconthemes-dev libkf5globalaccel-dev libkf5crash-dev libkf5kcmutils-dev libkf5declarative-dev libkf5service-dev libkf5parts-dev libkf5kio-dev libkf5coreaddons-dev libkf5guiaddons-dev

Clone the repository (as regular user)

Code: Select all

$ git clone https://github.com/KDE/amor.git

Navigate to AMOR's source code directory

Code: Select all

$ cd amor

Create a build directory

Code: Select all

$ mkdir build

Navigate to the build directory

Code: Select all

$ cd build

Now for the fun part: Generate the build files

Code: Select all

$ cmake ..

Build AMOR

Code: Select all

# make

Any build errors will be marked in red, for instance if you lack a dependency. Take note of what is missing, install it and try again.


Installing AMOR

If everything went well, install it to your system

Code: Select all

# make install

That's it! AMOR should now be in your menu, ready to entertain you.