Installation from source in Debian-based distributions

These instructions apply to D distributions based on Debian like Ubuntu, Mint, Kali, etc. Please note that these instructions are generic. Your distribution may require extra steps, for example, to add some repositories.

So, your mileage may vary. Your distribution might not include some of the required dependencies. They are known to work under Ubuntu. If you try it in a different distribution please let me know by opening a Gitlab issue, whether you succeed or fail.

  1. Download Superkb

     wget 'https://gitlab.com/alvarezp2000/superkb/-/archive/v0.23/superkb-v0.23.tar.gz'
  2. Unpack it

     tar xvzf superkb-v0.23.tar.gz
  3. Install Superkb dependencies.

     sudo apt-get install libcairo2-dev libcairo2-dev libgdk-pixbuf2.0-dev \
     libimlib2-dev libpango1.0-dev libpango1.0-dev x11proto-render-dev \
     libx11-dev libxft-dev libxinerama-dev libxrender-dev libc6 libcairo2 \
     libgdk-pixbuf2 libglib2.0-0 libimlib2 libpango-1.0-0 \
     libpangocairo-1.0-0 libx11-6 libxext6 libxft2 libxinerama1 \
     libxrender1 aosd-cat help2man
  4. Enter into the Superkb directory.

     cd superkb-v0.23
  5. Compile Superkb.

     MODTYPE=y make force
  6. Install Superkb.

     sudo make install
  7. Download a sample configuration into your home directory as ‘.superkbrc’.

     wget -O ~/.superkbrc 'http://superkb.org/extra/debian/sample-config.txt'
  8. The sample configuration uses a custom-made script. Unless you tweak your configuration to remove its use, download it.

     mkdir -p ~/bin
    
     wget -O ~/bin/notify-aosd 'http://superkb.org/extra/debian/notify-aosd'
  9. Launch Superkb

     superkb

    or, if you want to send it to the background,

     superkb &
  10. You may need to tweak the configuration. If you do, reload Superkb by killing it:

    killall superkb

and reloading it as in step 8.