Skip to content

MANUAL-INSTALL-INSTRUCTIONS.md

Latest commit

 

History

History
209 lines (139 loc) · 4.62 KB

MANUAL-INSTALL-INSTRUCTIONS.md

File metadata and controls

209 lines (139 loc) · 4.62 KB

Manually Installing kew

kew dependencies are:

  • FFTW
  • Chafa
  • libopus
  • opusfile
  • libvorbis
  • TagLib
  • faad2 (optional)
  • libogg
  • pkg-config
  • glib2.0

Install the necessary dependencies using your distro's package manager and then install kew. Below are some examples.

Debian/Ubuntu

Install dependencies:

sudo apt install -y pkg-config libfaad-dev libtag1-dev libfftw3-dev libopus-dev libopusfile-dev libvorbis-dev libogg-dev git gcc make libchafa-dev libglib2.0-dev libgdk-pixbuf-2.0-dev

Install kew

Arch Linux

Install dependencies:

sudo pacman -Syu --noconfirm --needed pkg-config faad2 taglib fftw git gcc make chafa glib2 opus opusfile libvorbis libogg

Install kew

Android

Follow the instructions here:

ANDROID-INSTRUCTIONS.md

macOS

Install git:

xcode-select --install

Install dependencies:

brew install gettext faad2 taglib chafa fftw opus opusfile libvorbis libogg glib pkg-config make

Notes for mac users:

  1. A sixel-capable terminal like kitty or WezTerm is recommended for macOS.
  2. The visualizer and album colors are disabled by default on macOS, because the default terminal doesn't handle them too well. To enable press v and i respectively.

Install kew

Fedora

Install dependencies:

sudo dnf install -y pkg-config taglib-devel fftw-devel opus-devel opusfile-devel libvorbis-devel libogg-devel git gcc make chafa-devel libatomic gcc-c++ glib2-devel

Option: add faad2-devel for AAC, M4A support.

sudo dnf install faad2-devel faad2

Install kew manually/Build an RPM package

OpenSUSE

Install dependencies:

sudo zypper install -y pkgconf taglib fftw3-devel opusfile-devel libvorbis-devel libogg-devel git chafa-devel gcc make glib2-devel faad2 faad2-devel gcc-c++ libtag-devel

Install kew

CentOS/Red Hat

Install dependencies:

sudo dnf config-manager --set-enabled crb

sudo dnf install -y pkgconfig taglib taglib-devel fftw-devel opus-devel opusfile-devel libvorbis-devel libogg-devel git gcc make chafa-devel glib2-devel gcc-c++

Option: add faad2-devel for AAC,M4A support (Requires RPM-fusion to be enabled).

Enable RPM Fusion Free repository:

sudo dnf install https://download1.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %rhel).noarch.rpm

Install faad2:

sudo dnf install faad2-devel

Install kew manually/Build an RPM package

Void Linux

Install dependencies:

sudo xbps-install -y pkg-config faad2 taglib taglib-devel fftw-devel git gcc make chafa chafa-devel opus opusfile opusfile-devel libvorbis-devel libogg glib-devel

Install kew

Alpine Linux

Install dependencies:

sudo apk add pkgconfig faad2-dev taglib-dev fftw-dev opus-dev opusfile-dev libvorbis-dev libogg-dev git build-base chafa-dev glib-dev

Install kew

Windows (WSL)

  1. Install Windows Subsystem for Linux (WSL).

  2. Install kew using the instructions for Ubuntu.

  3. If you are running Windows 11, Pulseaudio should work out of the box, but if you are running Windows 10, use the instructions below for installing PulseAudio: https://www.reddit.com/r/bashonubuntuonwindows/comments/hrn1lz/wsl_sound_through_pulseaudio_solved/

  4. To install Pulseaudio as a service on Windows 10, follow the instructions at the bottom in this guide: https://www.linuxuprising.com/2021/03/how-to-get-sound-pulseaudio-to-work-on.html

Install kew

Download the latest release (recommended) or, if you are feeling adventurous, clone from the latest in main:

git clone https://codeberg.org/ravachol/kew.git
cd kew

Then run:

make -j4
sudo make install

Uninstalling

If you installed kew manually, simply run:

sudo make uninstall

If you want, you can also delete the settings files:

Linux: ~/.config/kew/ macOS: ~/Library/Preferences/kew/

Then delete the kewstaterc file:

Linux: ~/.config/kew/kewstaterc macOS: ~/Library/Preferences/kew/kewstaterc

Faad2 is optional

By default, the build system will automatically detect if faad2 is available and includes it if found.