ANDROID-INSTRUCTIONS.md

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.

  - click to go to downloads page

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

  - click to download

Termux Setup:

1. Update and install dependencies

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.

Building Faad2 from source (needed to run .m4a files)

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

3. Enable storage permissions

termux-setup-storage

Tap allow for the setup to finish

Compiling Kew:

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)