-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathfaqlinux.htm
168 lines (163 loc) · 9.82 KB
/
faqlinux.htm
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Linux F.A.Q</title>
<meta name="GENERATOR" content="WinCHM">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<style>
html,body {
/* Default Font */
font-family: Arial, Helvetica, sans-serif;
font-size: 11pt;
}
</style>
</head>
<body>
<div class="pageSection">
<div class="pageSectionHeader">
Linux F.A.Q
</div>
<div class="pageSectionContent">
<p class="large">Can I run GBM on Linux?</p>
<ul>
<li>GBM will run on Linux using Mono. You can detect and backup saved games from Linux native games and games running in Wine.</li>
</ul><IMG class=centered alt="Native Example" src ="./GBM_files/gbm_linux_native.jpg" width=611 height=443 ><br>
<p class="large">How do I install and run GBM on Linux?</p>
<ul>
<li>If you're using Debian or a Debian-based distro such as Ubuntu or Mint. Download the latest deb package from <A href="https://github.com/MikeMaximus/gbm/releases">Releases</a>.
<li>Arch Linux users can install from the <A href="https://aur.archlinux.org/packages/gbm/">Arch Linux User Repository</a>.
<li>If you prefer a manual install, download the latest 7z package from <A href="https://github.com/MikeMaximus/gbm/releases">Releases</a> and extract it to a folder. Navigate to the folder in a terminal and choose from the following options:
<ul>
<li>Use the command <b>sudo make install</b> to automatically install and setup GBM as an application on your
system.
<li>Use the command <b>sudo make uninstall</b> to uninstall after using the install script.
<li>Use the command <b>mono GBM.exe</b> to run GBM from the current location without doing any installation.</li>
</ul></li>
</ul>
<p class="large">Can I compile the GBM source code with Mono?</p>
<ul>
<li>No, not without significant work. GBM was initially created on Windows using .NET 4. It uses syntax and features that are not currently supported by the vbnc compiler.</li>
</ul>
<p class="large">What's required to run GBM on Linux?</p>
<ul>
<li>GBM requires a few prerequisites to be installed. Many of these may be pre-installed on your distribution.
<ul>
<li>Mono Framework with Visual Basic .NET and WinForms
<ul>
<li>The <b>mono-vbnc</b> package
and it's dependencies should cover this on debian based distros.
<li>Visit <a href="http://www.mono-project.com/download/">mono-project.com</a> for the best way to install this on your distro.</li>
</ul>
<li>SQLite3 library
<ul>
<li>The <b>libsqlite3-0</b> package on debian based distros.</li>
</ul>
<li>7-Zip
<ul>
<li>The <b>p7zip-full</b> package on debian based distros.</li>
</ul>
<li>readlink
<ul>
<li>readlink is part of the <b>coreutils</b> package and should be installed by default on debian based distros.</li>
</ul>
<li>df
<ul>
<li>df is part of the <b>coreutils</b> package and should be installed by default on debian based distros.</li>
</ul>
</li>
</ul>
</li>
</ul>
<p class="large">Are there any recommended packages to install when running GBM on Linux?</p>
<ul>
<li>GBM (v1.1.0 or later) will use libnotify to send native notifications if it's available.
<ul>
<li>libnotify4 and libnotify-bin
<ul>
<li>GBM requires the utilities package (libnotify-bin on debian) to be installed. The utility package isn't commonly installed by default.</li>
</ul>
</li>
</ul>
</li>
</ul>
<p class="large">Are there any limitations while running in Linux?</p>
<ul>
<li>The tray icon may not be shown or function correctly
on some desktop environments. Try updating Mono to the most recent stable
version if this is an issue.
<li>The main window cannot be closed and hidden to the
system tray in Linux, it will always minimize to the taskbar instead.
<li>GBM can't automatically detect a game's icon,
publisher, or version in Linux. That information can be manually set in the
Game Manager.
<li>You may encounter slight visual or functional glitches with the interface. These glitches are related to Mono's implementation of certain controls and possibly your window manager, video driver or display server version. I've done my best to minimize the worst of these issues.</li>
</ul>
<p class="large">How do I find the process name and save games?</p>
<ul>
<li>Running processes can be searched with this: <pre>ps ax | grep -i wesnoth</pre>
<li>Checking standard folders for configuration and save game folders with this: <pre>name='wesnoth';
find ~/.local ~/.config -iname "*${name}*"; #folders like ~/.local/share/wesnoth
echo ~/.* | tr ' ' '\n' | grep -i "${name}"; #folders like ~/.wesnoth</pre>
<li>Tracking all files, a game writes to:<pre>strace -f -y -e trace=%file -o /tmp/traced.log wesnoth; less /tmp/traced.log</pre> In Steam it would be the following launch option:<pre>strace -f -y -e trace=%file -o /tmp/traced.log %command%</pre>Searching the log file could be done like this:<pre>grep "\(\.local\|\.config\)" /tmp/traced.log</pre>
<li>Checks for <A href="https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG Base Directory Specification</a> compliance could be done like this:<pre>mkdir -p /tmp/test_{data,conf};
XDG_DATA_HOME=/tmp/test_data/ XDG_CONFIG_HOME=/tmp/test_conf/ wesnoth;
ls /tmp/test_*;</pre>
<li>Don't forget to move game configurations to the trash folder (not rm!) and check whether restore works.</li>
</ul>
<p class="large">How do I configure GBM to detect Wine games?</p>
<IMG class=centered alt="Wine Example" src ="./GBM_files/gbm_linux_wine.jpg" width=611 height=443 ><br>
<ul>
<li>You don't need to do anything special. Simply set the
game's "Process" field to it's Windows executable name (without the
extension), exactly the same as configuring a game on Windows.
<li>Please note that while GBM displays games running as
"wine-preloader" from the Wine folder, it still knows the game's actual
working directory and will properly backup a relative path configuration.
<li>In recent versions of GBM, you may also import Windows game configurations directly from the offical list. You can also view and edit details regarding the Wine configuration of each game.</li>
</ul>
<IMG class=centered alt="Wine Configuration Example" src ="./GBM_files/gbm_linux_wine_details.jpg" width=915 height=742 ><br>
<p class="large">Can GBM share the same backup folder between Linux and Windows?</p>
<ul>
<li>Yes it can, you can play a game on Linux and have GBM
restore your saved games to continue on Windows and vice versa.
<li>Linux and Windows will rarely ever share the same
backup configurations. It's highly recommended to turn off "Enable syncing" in
Settings. This way you can still share your saved games, but backup
configurations will remain separate.
<li>Games run with Wine or Steam Play, who use
configurations imported form the Windows list, are always fully compatible
with the Windows version.
<li>This feature is no longer fully supported in v1.1.0 or later because sycning can no longer be disabled.</li>
</ul><IMG class=centered alt="Settings Example" src ="./GBM_files/gbm_linux_settings.jpg" width=646 height=389 ><br>
<p class="large">I'm getting an error message when I run GBM!</p>
<ul>
<li>The following are some common errors and the reason:
<ul>
<li>The entry point method could not be loaded.
<ul>
<li>This indicates that Mono Visual Basic or WinForms support is not installed.</li>
</ul>
<li>7-Zip was not found. The application cannot continue.
<ul>
<li>This indicates that 7-Zip is not installed or that 7za is not located in /usr/bin.</li>
</ul>
<li>Other exceptions or crashes on startup.
<ul>
<li>Any other error message is probably related to SQLite3 not being installed or detected by Mono.</li>
</ul>
</li>
</ul>
</li>
</ul>
<p class="large">I'm having other problems running GBM in Linux!</p>
<ul>
<li>Please <A href="https://github.com/MikeMaximus/gbm/issues?q=is%3Aissue">report any issues</a> you may be experiencing.</li>
</ul>
</div>
<div class="pageSectionFooter">
<a href="faq.htm">Back to F.A.Q</a>
</div>
<div> </div><!--End Left Panel-->
<div></div><!--Include the Footer-->
</body>
</html>