UniqueBibleApp webtop on macOS - eliranwong/UniqueBible GitHub Wiki
On Apple macOS, users simply need to set up docker to run Unique Bible App webtop version.
Set up Docker
-
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.]
-
Double-click the installer and move the app "Docker Desktop on Mac" to Applications directory.
-
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.