Aletheia-Mobile

Setting Music and Soundscape Directories

The defaults are ~/Music/ and ~/Sounds/. To change this, modify the following line(s) in ~/.aletheia-mobile/config:

MUSIC_DIR=/full/linux/path/Music/
SOUND_DIR=/full/linux/path/Sounds/ (Optional)

Setting Language and Speech Engine (Optional)

Add or modify the following line in ~/.aletheia-mobile/config:

LANGUAGE=German

Available options are English, German, Spanish, Hindi, Chinese, and Japanese.

SPEECH_ENGINE=gtts

Available options are gtts (or gtts-cli) for a natural voice that downloads speech clips from the Internet and espeak (or espeak-ng) for a fast, local speech engine (Default).

Android/Termux

Termux Dependencies

pkg update && pkg upgrade
pkg install bc calc espeak exiftool ffmpeg imagemagick jq mpv nodejs socat

Start the server

In the project directory, run:

./aletheia-mobile

Install as a PWA

Once the server is loaded, open Chrome (or any Chromium-based browser), navigate to http://localhost:1111/, and click "Add to Home screen" in the browser menu to install the client as a Progressive Web App (PWA).

Important

To ensure the Aletheia-mobile server stays running in the background, make sure "Keep screen on" is checked in the Termux menu.

Bluetooth Controls (Optional)

Optional .flo files can be imported into the Automate Android app by LlamaLab to enable bluetooth controls.

GNU/Linux

General Dependencies

• bash
• bc
• calc
• espeak-ng
• exiftool
• ffmpeg
• imagemagick
• jq
• mpv
• nodejs
• socat

Optional Dependencies

• gtts

Key Controls

Speed Adjustments

Key	Action
j	Shift pitch/tempo down by 1/60th interval
k	Shift pitch/tempo up by 1/60th interval
y	Reset to 60-EDO (Equal Division of the Octave)
4	Reset to Default Speed
o	Double the precision
m	Halve the precision
x	Lock the adjustment
u	Unlock the adjustment

Playback

Key	Action
p	Play / Pause
f	Stop
h	Seek 5% backward
l	Seek 5% forward
b	Previous song
n	Next song
\	Restart song
e	Toggle Loop Song

Playlist

Key	Action
<	Move song down
>	Move song up
a	Sort
r	Shuffle
w	Queue New Downloads after the current track

Playlist Editor

Key	Action
;	Open the Playlist Editor
Enter, p	Queue Song(s) after the current track
<	Move song down
>	Move song up
b	Previous song
n	Next song

System

Key	Action
8	Software Volume Down
9	Software Volume Up
!	Toggle Fade Volume
d	Toggle Voice Feedback
Space	Toggle Simplified View
?	Toggle Help Screen

Looping

Key	Action
5	Set Start Point
7	Set End Point
6	Play Loop

Slackware

SlackBuilds.org Dependencies

• mpv (and dependencies)
• calc
• nodejs24-bin
• exiftool
• jq

You can use the sqg and sbopkg tools from sbopkg.org to easily create a queue file to install all the dependencies:

sqg -p mpv
sbopkg -i mpv -i calc -i nodejs24-bin -i exiftool -i jq

./create_archive
sudo ./aletheia-mobile.SlackBuild
sudo installpkg /tmp/aletheia-mobile-3-noarch-3_SBo.tgz

RHEL/Fedora (Requires RPMFusion)

sudo dnf install rpm-build
sudo ./create_rpm
sudo dnf install ./aletheia-mobile-*.noarch.rpm

SLES/openSUSE

sudo zypper install rpm-build
sudo ./create_rpm
sudo zypper install ./aletheia-mobile-*.noarch.rpm

Ubuntu/Debian

sudo ./create_deb
sudo apt install /tmp/aletheia-mobile_*.deb