## Manually Installing kew

#### Debian/Ubuntu

Install dependencies:

```bash
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](#install-kew)

#### Arch Linux

Install dependencies:

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

#### FreeBSD

```bash
sudo pkg install pkgconf faad2 taglib fftw3 opus opusfile libvorbis libogg git gcc gmake chafa glib gdk-pixbuf2

cd kew

gmake -j

sudo make install

```

#### NetBSD

```bash

sudo pkgin install pkgconf faad2 taglib fftw opus opusfile libvorbis libogg git-base gcc gmake chafa glib2 gdk-pixbuf2

cd kew

gmake -j

sudo make install

```


[Install kew](#install-kew)

#### Android

Follow the instructions here:

[ANDROID-INSTRUCTIONS.md](ANDROID-INSTRUCTIONS.md)

#### macOS

Install git:

```bash
xcode-select --install
```

Install dependencies:

```bash
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](#install-kew)

#### Fedora

Install dependencies:

```bash
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.

```bash
sudo dnf install faad2-devel faad2
```

[Install kew manually](#install-kew)/[Build an RPM package](FEDORA-RPM-INSTRUCTIONS.md)

#### OpenSUSE

Install dependencies:

```bash
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](#install-kew)

#### CentOS/Red Hat

Install dependencies:

```bash
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:

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

Install faad2:

```bash
sudo dnf install faad2-devel
```

[Install kew manually](#install-kew)/[Build an RPM package](FEDORA-RPM-INSTRUCTIONS.md)

#### Void Linux

Install dependencies:

```bash
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](#install-kew)


#### Alpine Linux

Install dependencies:

```bash
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](#install-kew)

#### Windows (MSYS), The preferred way for windows

Follow the instructions here:

[WINDOWS-INSTRUCTIONS.md](WINDOWS-INSTRUCTIONS.md)

#### Windows (WSL)

Install through package manager:

1) Install Windows Subsystem for Linux (WSL).

2) Run these commands:

```sh
sudo apt update

Install Kew:

sudo apt install kew

kew
```

Install from source:

1) Install kew using the instructions for Ubuntu.

2) 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/

3) 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 {#install-kew}

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

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

Then run:

```bash
make -j
```

```bash
sudo make install
```

### Uninstalling

If you installed kew manually, simply run:

```bash
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.

