Skip to content

Latest commit

 

History

History
120 lines (84 loc) · 2.67 KB

INSTALL.md

File metadata and controls

120 lines (84 loc) · 2.67 KB

Binaries

  • In Debian sid, buster or their Ubuntu derivatives, install alttab from the official repository:

    apt install alttab
    

    Also, unofficial deb packages for snapshots and backports are available. Follow setup instructions there.

  • In FreeBSD, install the port:

    cd /usr/ports/x11/alttab/ && make install clean
    

    or add the package:

    pkg install alttab
    
  • In Arch Linux, alttab is available in AUR.

  • In Alpine Linux, alttab is in aports/testing repository.

  • In openSUSE, alttab is available in Tumbleweed and from the X11:Utilities repository:

    zypper ar -f obs://X11:Utilities x11utils
    zypper ref
    zypper in alttab
    

Building from source

  1. Install build dependencies. Basic Xlib, Xft, Xrender, Xrandr, libpng, libxpm libraries and uthash macros are required. In Debian or Ubuntu:

    apt install libx11-dev libxmu-dev libxft-dev libxrender-dev libxrandr-dev libpng-dev libxpm-dev uthash-dev
    

    Maintainer or packager may also install autotools and ronn:

    apt install autoconf automake ronn
    
  2. Download:

    git clone https://github.com/sagb/alttab.git && cd alttab
    
  3. Maintainer or packager may want to update autotools stuff and refresh documentation with ronn:

    ./bootstrap.sh
    
  4. Build:

    ./configure  
    make  
    make install
    make check  # optional
    

In OpenBSD (as of OpenBSD 7.4 amd64):

  1. Install build dependencies.
    Xlib, Xft, Xrender, Xrandr and libxpm come from xbase file set
    perl is part of base file set.
    In order to install others:

    # may omit autoconf-2.69 as it is pulled in as a dependency of automake-1.16.5
    pkg_add git png uthash automake-1.16.5
    

    If you intend to run make check, then also:

    pkg_add gawk
    
  2. Download:

    git clone https://github.com/sagb/alttab.git && cd alttab
    
  3. Update autotools stuff - mandatory step for OpenBSD:

    ./bootstrap.sh -f
    
  4. Build:

    CPATH=/usr/local/include ./configure --mandir /usr/local/man
    CPATH=/usr/local/include make
    make install
    makewhatis /usr/local/man  # update mandoc.db with alttab.1
    make check  # optional
    

Usage notes

See README.md