diff options
| author | Antenore Gatta <antenore@simbiosi.org> | 2021-11-19 15:55:58 +0300 |
|---|---|---|
| committer | Antenore Gatta <antenore@simbiosi.org> | 2021-11-19 15:55:58 +0300 |
| commit | af808a2bdec5e681ee2bf7a7d4df8c76d2c7d84a (patch) | |
| tree | b82c234d89792909897ba5a7b44d3c9d0d645136 /public/_gtk_socket-feature-is-not-available-in-a-_wayland-session_8md_source.html | |
| parent | d607f950c2bee15843b2c9c4425661e4cbaf18a4 (diff) | |
Automatic doc build by remmina-ci
Diffstat (limited to 'public/_gtk_socket-feature-is-not-available-in-a-_wayland-session_8md_source.html')
| -rw-r--r-- | public/_gtk_socket-feature-is-not-available-in-a-_wayland-session_8md_source.html | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/public/_gtk_socket-feature-is-not-available-in-a-_wayland-session_8md_source.html b/public/_gtk_socket-feature-is-not-available-in-a-_wayland-session_8md_source.html index c060a48d5..60ed8466d 100644 --- a/public/_gtk_socket-feature-is-not-available-in-a-_wayland-session_8md_source.html +++ b/public/_gtk_socket-feature-is-not-available-in-a-_wayland-session_8md_source.html @@ -86,7 +86,7 @@ $(document).ready(function(){initNavTree('_gtk_socket-feature-is-not-available-i <div class="title">GtkSocket-feature-is-not-available-in-a-Wayland-session.md</div> </div> </div><!--header--> <div class="contents"> -<a href="_gtk_socket-feature-is-not-available-in-a-_wayland-session_8md.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> Firstly, the only Remmina protocol plugin which uses the old GTK feature `GtkSocket` is the `X2Go plugin`.</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> Trying to start a X2Go session in Remmina in a Wayland session will popup a dialog like this:</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> </div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> </div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> The `GtkSocket` feature has been deprecated for a while now and is no longer supported in GTK4. It uses the X11-only feature `XEmbed`. Which means that it can't be used in a Wayland session natively. It is just not compatible with the architecture of GTK4.</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> </div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> # Best workaround</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> </div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> **Don't worry! There is a possible solution for you, if you want to use Remmina in a Wayland session instead of a X11 session.**</div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> </div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> You can force Remmina to start as a `X client` instead of a native `Wayland client` (see illustration below) by setting an `environment variable` before starting Remmina.</div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> </div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> Try to start Remmina like this:</div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> </div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> - First open a terminal emulator. (like gnome-terminal, mate-terminal, alacritty, xterm...) More than likely you don't have to install one yourself since most distributions come with a terminal emulator preinstalled.</div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> - Type in the following and press the enter key:</div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> </div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> ```shell</div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> GDK_BACKEND=x11 remmina</div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> ```</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> </div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> - Remmina should start and everything should **just work** ;)</div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> </div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> # Future solutions.</div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> </div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> We would like to significantly change the architecture of the X2Go plugin in the future by **removing the X11-only** `XEmbed` feature dependency.</div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> </div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> This propably requires a lot of work though and discussions about this topic still need to be held.</div></div><!-- fragment --></div><!-- contents --> +<a href="_gtk_socket-feature-is-not-available-in-a-_wayland-session_8md.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> # General information</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> Trying to start an X2Go session in Remmina in a Wayland session will popup a dialog like this:</div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> </div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> </div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> </div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> **(Not final, text and buttons may change.)**</div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> </div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> The _`GtkSocket`_ feature has been deprecated for a while now and is no longer supported in GTK4. It uses the X11-only feature _`XEmbed`_. Which means **that it can't be used under _`Wayland`_ natively.**</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> </div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> # Best workaround</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> </div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> **Don't worry! There is a possible solution for you, if you want to use Remmina in a _Wayland_ session instead of an _X11_ session.**</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> </div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> You can force Remmina to start as an _`X client`_ instead of a native _`Wayland client`_ (see illustration below) by setting an _`environment variable`_ before starting Remmina.</div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> </div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> Try to start Remmina like this:</div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> </div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> - First open a _`terminal emulator`_. (like gnome-terminal, mate-terminal, alacritty, xterm...) More than likely you don't have to install one yourself since most distributions come with a terminal emulator preinstalled.</div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> - Type in the following and press the enter key:</div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> </div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> ```shell</div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> GDK_BACKEND=x11 remmina</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> ```</div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> </div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> - Remmina should start and everything should **just work** ;)</div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> [Source: wayland.freedesktop.org](https://wayland.freedesktop.org/architecture.html)</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> </div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> # Future solutions.</div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> </div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> We would like to significantly change the architecture of the X2Go plugin in the future by **removing the X11-only** _`XEmbed`_ feature dependency.</div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> </div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> This probably requires a lot of work though. If you can imagine funding this heavy lift of work, please get in touch with the Remmina project maintainers.</div></div><!-- fragment --></div><!-- contents --> </div><!-- doc-content --> <!-- start footer part --> <div id="nav-path" class="navpath"><!-- id is needed for treeview function! --> |