aboutsummaryrefslogtreecommitdiff
path: root/doc/MACOS.md
diff options
context:
space:
mode:
authorXavier Del Campo Romero <xavi.dcr@tutanota.com>2023-09-29 10:53:41 +0200
committerXavier Del Campo Romero <xavi.dcr@tutanota.com>2023-09-29 10:53:49 +0200
commitd1f04bf33ed4e2b6f17bdc32784aa23c6dfd6a20 (patch)
tree25dee3e79bcc98c5b4cc753eedb6e10c176f93c5 /doc/MACOS.md
parentf25bfb00969a7e09996da2d5500e6718f4cc0148 (diff)
downloaddino-d1f04bf33ed4e2b6f17bdc32784aa23c6dfd6a20.tar.gz
Import wiki documentation from upstream
Imported from: commit 2484d45a8abcb55e900de8538de6ec646992d682 (HEAD) Author: Marvin W <git@larma.de> Date: Fri Aug 19 14:41:11 2022 +0200 Destroyed _Footer (markdown)
Diffstat (limited to 'doc/MACOS.md')
-rw-r--r--doc/MACOS.md45
1 files changed, 45 insertions, 0 deletions
diff --git a/doc/MACOS.md b/doc/MACOS.md
new file mode 100644
index 00000000..19a8c226
--- /dev/null
+++ b/doc/MACOS.md
@@ -0,0 +1,45 @@
+**macOS is currently not officially supported**. This should change in the future. Until then, this page provides the information you need to get Dino running. Problems are to be expected.
+
+## Compiling with Homebrew
+The following instructions expect you to use a Terminal emulator, for example the Terminal.app included with macOS. Open it and type in the commands as described.
+
+1. If you don't have XCode tools installed, install them using
+ ```sh
+ $ xcode-select --install
+ ```
+2. If you don't already have homebrew installed, install it using
+ ```sh
+ $ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
+ ```
+ See https://brew.sh for updated installation instructions of homebrew.
+3. Make sure all the required dependencies are installed by running
+ ```sh
+ $ brew install adwaita-icon-theme glib glib-networking gpgme icu4c libgpg-error libgcrypt gtk+3 libsignal-protocol-c libgee libsoup sqlite cmake gettext ninja vala qrencode libxml2 gspell gst-plugins-base srtp libnice
+ ```
+4. Download the source code from the git in a directory of your choice (use `cd` to change the current working directory)
+ ```sh
+ $ git clone https://github.com/dino/dino.git
+ $ cd dino
+ ```
+5. Configure and compile the dino in a brew shell
+ ```sh
+ $ brew sh
+ $ ./configure
+ $ make
+ $ exit
+ ```
+6. Fix the filename of plugins
+ ```sh
+ $ zsh -e -x -c 'for plugin in build/plugins/*.dylib;
+ do mv ${plugin} ${plugin%.dylib}.so;
+ done'
+ ```
+
+You are done. Start dino by typing `./build/dino`. If you want to update to the latest version, run `git pull` and redo steps 5 and 6.
+
+TODO: Package dino in a bundle for nice installation.
+
+## Developer notes
+Guides to run virtualized macOS:
+- VirtualBox: https://github.com/myspaghetti/macos-guest-virtualbox
+- KVM/QEMU/libvirt: https://github.com/foxlet/macOS-Simple-KVM