Difference between revisions of "Gajim"

From ArchWiki
Jump to navigation Jump to search
(Add gajim sleep hook.)
m (Corrected the Query for Message History)
 
(48 intermediate revisions by 25 users not shown)
Line 1: Line 1:
From the [http://gajim.org/index.php?lang=en project page]
+
[[Category:XMPP]]
 +
[[ja:Gajim]]
 +
[https://gajim.org/index.php?lang=en Gajim] is a full featured and easy to use [[Wikipedia:XMPP|XMPP]] client.
  
Gajim a full featured and easy to use Jabber/XMPP client
+
== Installation ==
  
==Auto logout on suspend==
+
[[Install]] the {{Pkg|gajim}} package.
If you suspend your computer gajim stay connected for about 15 minutes. To prevent message loss, it is needed to set your status offline before suspending or hibernating. The status message won't be changed.
 
  
Therefore create a new systemd unit gajim-suspend@.serivce in /etc/systemd/system.
+
== D-Bus remote control ==
  
{{bc|<nowiki>
+
To enable D-Bus remote control support, go to ''Preferences > Advanced > Advanced Configuration Editor'', open the 'Advanced Configuration Editor', enable ''remote_control'', and then restart Gajim.
[Unit]
 
Description=Suspend Gajim
 
Before=sleep.target
 
StopWhenUnneeded=yes
 
  
[Service]
+
== Show/hide roster  ==
Type=oneshot
 
User=%I
 
RemainAfterExit=yes
 
Environment=DISPLAY=:0
 
ExecStart=-/usr/bin/bash -c ". /home/%I/.dbus/session-bus/$(</var/lib/dbus/machine-id)-0 && /usr/bin/gajim-remote change_status offline"
 
ExecStop=/usr/bin/bash -c ". /home/%I/.dbus/session-bus/$(</var/lib/dbus/machine-id)-0 && /usr/bin/gajim-remote change_status online"
 
  
[Install]
+
(This no longer works. It seems that this command is depreciated.) If you would like to be able to show/hide the roster using a script or your wm, you can use the following command from the terminal.
WantedBy=sleep.target
+
$ gajim-remote toggle_roster_appearance
</nowiki>}}
 
  
Then enable it with {{ic|systemctl enable gajim@<USER>}}, where {{ic|USER}} is the login name.
+
It may be necessary to restart Gajim if this doesn't work.
 +
 
 +
== OMEMO Support ==
 +
 
 +
[https://conversations.im/omemo/ OMEMO Multi-End Message and Object Encryption] is an XMPP Extension Protocol (XEP) for secure multi-client end-to-end encryption. It is an open standard based on Axolotl and PEP which can be freely used and implemented by anyone.
 +
 
 +
In order to use OMEMO in Gajim, follow these steps:
 +
 
 +
# [[Install]] the {{Pkg|python-axolotl}} and {{Pkg|python-qrcode}} packages.
 +
# Open Gajim and go to menu ''Gajim'' => ''Plugins'';
 +
# Go to the ''Available'' tab;
 +
# Mark the "OMEMO" plugin and click the ''Install/Update Plugin'' button;
 +
# Go back to the ''Installed'' tab;
 +
# Activate the "OMEMO" plugin;
 +
# Close dialogs to save the changes;
 +
# Restart Gajim;
 +
# Please refer to the official documentation for [https://dev.gajim.org/gajim/gajim-plugins/wikis/OmemoGajimPlugin#running running instructions]
 +
 
 +
== Advanced configuration ==
 +
 
 +
Settings in ''Preferences > Advanced > Advanced Configuration Editor'' can be adjusted in order to increase Gajim's usability.
 +
 
 +
=== Minimize / Close to tray ===
 +
 
 +
By default Gajim remains in the taskbar (for Docks) instead of minimizing to tray when closing it, to disable this behavior '''enable''' the '''hide_on_roster_x_button''' preference.
 +
 
 +
=== Hide chat banner ===
 +
 
 +
To hide the avatar banner that normally resides close to top of the two-person chat window '''enable''' the '''hide_chat_banner''' preference.
 +
 
 +
== Save History of Messages ==
 +
 
 +
If the Save of Message History is enabled, a file ~/.local/share/gajim/logs.db is created. This is a SQLite DataBase. (Open it with DB Browser for SQLite, install {{Pkg|sqlitebrowser}})
 +
To look for a message, first get the jid_id of the contact in table jids. Click on Tab Search Data. Choose Table jids.
 +
Now click the tab Run SQL and run the statement
 +
''SELECT time, kind, message FROM logs WHERE jid_id=(the jid_id from table jids) ORDER BY time ASC;''
 +
and click the run button. The result ist a list of your messages orderd by time (first message first, latest message at the bottom). The Column kind shows if the message was sent (Code: 6) or received (Code: 4).

Latest revision as of 14:51, 25 February 2020

Gajim is a full featured and easy to use XMPP client.

Installation

Install the gajim package.

D-Bus remote control

To enable D-Bus remote control support, go to Preferences > Advanced > Advanced Configuration Editor, open the 'Advanced Configuration Editor', enable remote_control, and then restart Gajim.

Show/hide roster

(This no longer works. It seems that this command is depreciated.) If you would like to be able to show/hide the roster using a script or your wm, you can use the following command from the terminal.

$ gajim-remote toggle_roster_appearance

It may be necessary to restart Gajim if this doesn't work.

OMEMO Support

OMEMO Multi-End Message and Object Encryption is an XMPP Extension Protocol (XEP) for secure multi-client end-to-end encryption. It is an open standard based on Axolotl and PEP which can be freely used and implemented by anyone.

In order to use OMEMO in Gajim, follow these steps:

  1. Install the python-axolotl and python-qrcode packages.
  2. Open Gajim and go to menu Gajim => Plugins;
  3. Go to the Available tab;
  4. Mark the "OMEMO" plugin and click the Install/Update Plugin button;
  5. Go back to the Installed tab;
  6. Activate the "OMEMO" plugin;
  7. Close dialogs to save the changes;
  8. Restart Gajim;
  9. Please refer to the official documentation for running instructions

Advanced configuration

Settings in Preferences > Advanced > Advanced Configuration Editor can be adjusted in order to increase Gajim's usability.

Minimize / Close to tray

By default Gajim remains in the taskbar (for Docks) instead of minimizing to tray when closing it, to disable this behavior enable the hide_on_roster_x_button preference.

Hide chat banner

To hide the avatar banner that normally resides close to top of the two-person chat window enable the hide_chat_banner preference.

Save History of Messages

If the Save of Message History is enabled, a file ~/.local/share/gajim/logs.db is created. This is a SQLite DataBase. (Open it with DB Browser for SQLite, install sqlitebrowser) To look for a message, first get the jid_id of the contact in table jids. Click on Tab Search Data. Choose Table jids. Now click the tab Run SQL and run the statement SELECT time, kind, message FROM logs WHERE jid_id=(the jid_id from table jids) ORDER BY time ASC; and click the run button. The result ist a list of your messages orderd by time (first message first, latest message at the bottom). The Column kind shows if the message was sent (Code: 6) or received (Code: 4).