Skip to content

UniqueBibleApp webtop on macOS

Eliran Wong edited this page Feb 22, 2022 · 1 revision

On Apple macOS, users simply need to set up docker to run Unique Bible App webtop version.

Set up Docker

  1. Download "Docker Desktop on Mac" from https://docs.docker.com/desktop/mac/install/ [choose an installer according to the chip on which your macOS runs.]

  2. Double-click the installer and move the app "Docker Desktop on Mac" to Applications directory.

  3. Run "Docker Desktop" from Applications directory at least once and agree the terms when prompted.

Enable Audio Features

On macOS, you need few extra steps to enable audio or text-to-speech features on our webtop,

Run the following commands on your macOS Terminal app (Applications > Utilities > Terminal.app):

1) Install brew

We use brew to install pulseaudio for connection macOS speakers to our webtop.

If you haven't installed brew, install it:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install pulseaudio and run it:

brew install pulseaudio

2) Run pulseaudio

pulseaudio --load=module-native-protocol-tcp --exit-idle-time=-1 --daemon

3) Auto-run pulseaudio for future startup

Depends on your macOS default SHELL, use only one of the following two commands:

(For zsh users)

echo 'pulseaudio --load=module-native-protocol-tcp --exit-idle-time=-1 --daemon' >> ~/.zshrc

(For bash users)

echo 'pulseaudio --load=module-native-protocol-tcp --exit-idle-time=-1 --daemon' >> ~/.bash_profile

About SHELL mentioned above:

Recent macOS versions use zsh by default, older versions use bash by default. If you are not sure, run the following command to check:

echo $SHELL

Set up Unique Bible App webtop version

Option (1) - On Apple macOS (Apple chip M1):

Run one of the following options according to the chop on which your macOS runs:

Option (1) - On Apple macOS (Apple chip M1):

docker run -d --name=uniquebibleapp --security-opt seccomp=unconfined -e PUID=501 -e PGID=20 -e TZ=Europe/London -e SUBFOLDER=/ -e KEYBOARD=en-gb-qwerty -p 3000:3000 -v ~/uniquebibleapp-webtop:/config -v /var/run/docker.sock:/var/run/docker.sock -v ~/.config/pulse:/config/.config/pulse --shm-size="1gb" --restart unless-stopped eliranwong/uniquebibleappapplechip

Option (2) - On Apple macOS (Intel chip):

docker run -d --name=uniquebibleapp --security-opt seccomp=unconfined -e PUID=501 -e PGID=20 -e TZ=Europe/London -e SUBFOLDER=/ -e KEYBOARD=en-gb-qwerty -p 3000:3000 -v ~/uniquebibleapp-webtop:/config -v /var/run/docker.sock:/var/run/docker.sock -v ~/.config/pulse:/config/.config/pulse --shm-size="1gb" --restart unless-stopped eliranwong/uniquebibleappaudiotweaked

To run Unique Bible App webtop version

Open "localhost:3000" on a web browser. Please note that the first run normally takes extra few minutes for set up.

More about Webtop version

https://github.com/eliranwong/uniquebibleapp-webtop

Clone this wiki locally