Installation from source in Debian-based distributions

  1. Download Superkb

     wget 'https://github.com/alvarezp/superkb/archive/v0.23.tar.gz'
    
  2. Unpack it

     tar xvzf superkb-0.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
    
  4. Enter into the Superkb directory.

     cd superkb-0.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.