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 Both sides next revision
axolotl [2021/04/10 13:26]
arno_nuehm adding cog browser to daemonized server setup
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 "​cog"​ - a lightweight & fast browser. +
- +
-This installs cog+
  
 +Install cog via
 <​code>​ <​code>​
 sudo apt install cog sudo apt install cog
 </​code>​ </​code>​
  
-This command creates the server-desktop ​file+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>​
-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+cd axolotl-mobian-package && sudo cp axolotl-server.desktop ​/etc/xdg/autostart
 </​code>​ </​code>​
- 
-or you can do it manually 
- 
-<​code>​ 
-sudo nano /​usr/​share/​applications/​axolotl-server.desktop 
-</​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-desktop file 
- 
-<​code>​ 
-echo -e "​[Desktop Entry]\nType=Application\nName=Axolotl-Browser\nGenericName=Signal Chat Client (Browser)\nExec=cog --doc-viewer 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=cog --doc-viewer 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>​ 
- 
-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 separately. Axolotl 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 white screen and some qml errors)// +
- +
- +
-== 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+Or you can follow ​these steps
  
 <​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 229: 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 255: 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>​