meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
axolotl [2021/03/22 00:14]
joshbowyer
axolotl [2021/04/12 11:33]
arno_nuehm clean-up, qt version update, link to desktop files added
Line 58: Line 58:
 Flathub: https://​flathub.org/​apps/​details/​org.nanuc.Axolotl Flathub: https://​flathub.org/​apps/​details/​org.nanuc.Axolotl
  
-The flatpak appears to be web only for now; the QT version can be installed as per below.+The flatpak appears to be web only for now; the QT version can be installed as per below. IMPORTANT: The Qt version of Axolotl will be deprecated in v0.9.10.
  
  
 For now, the flatpakref can be installed one the following methods: For now, the flatpakref can be installed one the following methods:
  
-**qt / qml interface**+**qt / qml interface** ​IMPORTANT: The Qt version of Axolotl will be deprecated in v0.9.10.
  
 <​code>​ <​code>​
Line 80: Line 80:
 **web interface** //currently breaks after build// **web interface** //currently breaks after build//
  
-For server/​browser use, see "​Daemonized Server Setup" 
 <​code>​ <​code>​
 sudo apt install flatpak flatpak-builder sudo apt install flatpak flatpak-builder
Line 123: Line 122:
  
  
-== Daemonized Server Setup: ==+=== Daemonized Server Setup: ​===
  
-If you want Axolotl as a background process and be able to open the UI in a web page if neededcreate the two following .desktop files+You can start Axolotl as a background process and be able to open the UI in a web page, using cog or Firefox, for example. 
- +For this, you need two more desktop files and the browser.
-The first starts Axolotl as webserver. +
-The second starts ​the Axolotl-UI using Firefox ESR. Every other browser ​should do the work, but Firefox seems to be the most suitable/​stable at the moment (Midori is a resource friendly but laggy option). +
- +
-This command creates the desktop file+
  
 +Install cog via
 <​code>​ <​code>​
-echo -e "​[Desktop Entry]\nType=Application\nName=Axolotl-Server\nGenericName=Signal Chat Client (Server)\nPath=$HOME/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​\nExec=$HOME/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​axolotl -e server\nIcon=$HOME/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​axolotl-web/​dist/​axolotl.png\nTerminal=false\nCategories=Network;​Chat;​InstantMessaging;​\nStartupWMClass=axolotl"​ | sudo tee -a /​usr/​share/​applications/​axolotl.desktop+sudo apt install cog
 </​code>​ </​code>​
  
-or you can do it manually+You can find desktop files and further instructions here 
 +https://​github.com/​nuehm-arno/​axolotl-mobian-package
  
 +If you want Axolotl as daemon started automatically at login, copy the desktop file into the Gnome autostart folder with
 <​code>​ <​code>​
-sudo nano /​usr/​share/​applications/​axolotl-server.desktop+cd axolotl-mobian-package && ​sudo cp axolotl-server.desktop ​/​etc/​xdg/​autostart
 </​code>​ </​code>​
- 
-with this content and check for missing line breaks after copy/paste 
- 
-<​code>​ 
-[Desktop Entry] 
-Type=Application 
-Name=Axolotl-Server 
-GenericName=Signal Chat Client (Server) 
-Path=/​home/​mobian/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​ 
-Exec=/​home/​mobian/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​axolotl -e server 
-Icon=/​home/​mobian/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​axolotl-web/​dist/​axolotl.png 
-Terminal=false 
-Categories=Network;​Chat;​InstantMessaging;​ 
-StartupWMClass=axolotl 
-</​code>​ 
- 
- 
-and this creates the starter icon for the browser 
- 
-<​code>​ 
-echo -e "​[Desktop Entry]\nType=Application\nName=Axolotl-Browser\nGenericName=Signal Chat Client (Browser)\nExec=firefox-esr -private-window http://​127.0.0.1:​9080\nIcon=$HOME/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​axolotl-web/​dist/​axolotl.png\nTerminal=false\nCategories=Network;​Chat;​InstantMessaging;"​ | sudo tee -a /​usr/​share/​applications/​axolotl.desktop 
-</​code>​ 
- 
-or manually 
- 
-<​code>​ 
-sudo nano /​usr/​share/​applications/​axolotl-browser.desktop 
-</​code>​ 
- 
-with this content and check for missing line breaks after copy/paste 
- 
-<​code>​ 
-[Desktop Entry] 
-Type=Application 
-Name=Axolotl-Browser 
-GenericName=Signal Chat Client (Browser) 
-Exec=firefox-esr -private-window http://​127.0.0.1:​9080 
-Icon=/​home/​mobian/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​axolotl-web/​dist/​axolotl.png 
-Terminal=false 
-Categories=Network;​Chat;​InstantMessaging;​ 
-</​code>​ 
- 
-For Midori as UI, change the Exec line into this 
- 
-<​code>​ 
-Exec=midori -e Fullscreen -a http://​127.0.0.1:​9080 -p 
-</​code>​ 
- 
- 
-If you want Axolotl-Server to be started at login, copy the desktop file to the autostart folder 
- 
-<​code>​ 
-sudo cp /​usr/​share/​applications/​axolotl-server.desktop /​etc/​xdg/​autostart 
-</​code>​ 
- 
- 
  
 === Manual installation:​ === === Manual installation:​ ===
  
-The manual installation can be done by using the experimental installer or the following commands separatelyAxolotl can be started via Phosh icon it uses electron though.+The manual ​building and installation can be done by using a Makefile found here 
 +https://​github.com/nuehm-arno/​axolotl-debian-packaging
  
-//(starting Axolotl with option -e qt results in a white screen and some qml errors)// +Or you can follow ​these steps
- +
- +
-== Installer: == +
-There is an experimental installer available, which uses the commands for manual installation and which can be used for updates, too. +
- +
-https://​github.com/​nuehm-arno/​axolotl-mobian-installer +
- +
- +
-Follow ​these steps for manual installation+
  
 <​code>​ <​code>​
-sudo apt-get update && sudo apt-get install golang nodejs npm python ​qmlscene qml-module-qtwebsockets qml-module-qtmultimedia qml-module-qtwebengine +sudo apt-get update && sudo apt-get install golang nodejs npm python
-#the following qml modules have to be installed separately (regex issue) +
-sudo apt-get install qml-module-qtquick.controls +
-sudo apt-get install qml-module-qtquick.dialogs+
 go get -d -u github.com/​nanu-c/​axolotl/​ go get -d -u github.com/​nanu-c/​axolotl/​
 cd $(go env GOPATH)/​src/​github.com/​nanu-c/​axolotl && go mod download cd $(go env GOPATH)/​src/​github.com/​nanu-c/​axolotl && go mod download
Line 230: Line 161:
  
 then create axolotl.desktop then create axolotl.desktop
- 
-<​code>​ 
-echo -e "​[Desktop Entry]\nType=Application\nName=Axolotl\nGenericName=Signal Chat Client\nPath=$HOME/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​\nExec=$HOME/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​axolotl\n#​Exec=$HOME/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​axolotl -e qt\nIcon=$HOME/​go/​src/​github.com/​nanu-c/​axolotl/​build/​linux-arm64/​axolotl-web/​dist/​axolotl.png\nTerminal=false\nCategories=Network;​Chat;​InstantMessaging;​Qt;​\nStartupWMClass=axolotl"​ | sudo tee -a /​usr/​share/​applications/​axolotl.desktop 
-</​code>​ 
- 
-or manually 
  
 <​code>​ <​code>​
Line 256: Line 181:
  
 You should now have an Axolotl icon in Phosh. You should now have an Axolotl icon in Phosh.
 +
 +For testing the Qt version of Axolotl you have to install these dependencies. IMPORTANT: The Qt version of Axolotl will be deprecated in v0.9.10.
 +<​code>​
 +sudo apt install qmlscene qml-module-qtwebsockets qml-module-qtmultimedia qml-module-qtwebengine
 +#the following qml modules have to be installed separately (regex issue)
 +sudo apt-get install qml-module-qtquick.controls
 +sudo apt-get install qml-module-qtquick.dialogs
 +</​code>​