### **Basic Installation Requirements :**

To run kew on Android please install the following applications :

- **Termux** : A terminal emulator for Android that allows you to run Linux commands on your device.

  [![Download Termux](https://img.shields.io/badge/Download-Termux-brightgreen?style=for-the-badge&logo=android)](https://github.com/termux/termux-app/releases/) - click to go to downloads page

- **Termux-Api** : A plugin for Termux that executes Termux-api package commands.

  [![Download Termux-Api](https://img.shields.io/badge/Download-Termux--API-blue?style=for-the-badge&logo=android)](https://github.com/termux/termux-api/releases/download/v0.53.0/termux-api-app_v0.53.0+github.debug.apk) - click to download

### **Termux Setup:**

1. **Update and install dependencies**
```sh
pkg install tur-repo -y && yes | pkg upgrade -y && pkg install clang pkg-config taglib fftw git make chafa glib libopus opusfile libvorbis libogg dbus termux-api
```

2. **Make sure termux has sound:**

On your phone, go to Settings -> Sound and Vibration -> Volume and make sure the level for Media is not 0.

<details>
<summary><b>Building Faad2 from source (needed to run .m4a files)</b></summary>

```sh
pkg install cmake make clang
git clone https://github.com/knik0/faad2
cd faad2
cmake -DCMAKE_EXE_LINKER_FLAGS="-lm" . -D CMAKE_INSTALL_PREFIX=/data/data/com.termux/files/usr
make install
```

</details>

3. **Enable storage permissions**
```sh
termux-setup-storage
```
Tap allow for the setup to finish

4. **Setup dbus for kew**
* edit/create `~/.bashrc`
```
nano ~/.bashrc
```

* In nano, add this line and save it (ctrl+x):
```bash
alias kew="dbus-launch kew"
```

* Restart the shell: `exec $SHELL

### **Compiling Kew:**

```sh
git clone https://codeberg.org/ravachol/kew.git
cd kew
make -j4
make install
```

This step is all you will need to do later to update the version.

### **Run kew:**

1. **Set kew's music library path**

This could be ~/storage/music for instance:
```
kew path <music path>
```

2. **Run kew**

```
kew
```

### To get volume buttons on your phone to work in Termux:

run
nano ~/.termux/termux.properties

Uncomment this line:

volume-keys = volume

Save (ctrl+x)

