-
Notifications
You must be signed in to change notification settings - Fork 3
/
linux.html
175 lines (175 loc) · 11 KB
/
linux.html
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
169
170
171
172
173
174
175
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy for HTML5 for Windows version 5.1.25" />
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<meta name="description" content="Game Backup Monitor - Automatically backup your save games and add cloud support to any game for free!" />
<meta name="keywords" content="Game, Games, Save, Saves, Saved, Backup, Restore, Sync, Download, Cloud, Dropbox, GOG, Steam, Origin, Time, Monitor, PC" />
<meta name="author" content="Michael J. Seiferling" />
<title>Game Backup Monitor [Linux]</title>
<script type="text/javascript" language="javascript" src="script/jquery-1.10.2.min.js">
</script>
<script type="text/javascript" language="javascript" src="script/jquery.hoverIntent.min.js">
</script>
<link rel="stylesheet" type="text/css" href="styles/styles.css" />
<link rel="shortcut icon" href="images/gbm.ico" />
</head>
<body>
<div id="top">
<!--Include the Header (Starts Content)-->
<script type="text/javascript">
//<![CDATA[
$(function(){
$("#header").load("header.html");
});
//]]>
</script>
<div id="header"></div>
<div id="content">
<div id="leftcontent">
<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" src="images/screens/gbm_linux_native.jpg" width="856" height="467" alt="Native Example" /><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>
<li>Arch Linux users can install from the <a href="https://aur.archlinux.org/packages/gbm/">Arch Linux User Repository</a>.</li>
<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>
<li>Use the command <b>sudo make uninstall</b> to uninstall after using the install script.</li>
<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>
<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>
<li>SQLite3 library
<ul>
<li>The <b>libsqlite3-0</b> package on debian based distros.</li>
</ul>
</li>
<li>7-Zip
<ul>
<li>The <b>p7zip-full</b> package on debian based distros.</li>
</ul>
</li>
<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>
<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 wait cursor may not be shown on some desktop environments. This can make the application look like it froze until a task is completed.</li>
<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>
<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>
<li>GBM can't detect games using a window title, this is due to an unimplemented property in Mono, it may work in future versions.</li>
<li>The Global Hotkey feature is not supported in Linux.</li>
<li>You may encounter other 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 type/version.</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>
<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>
<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>
<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>
<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" src="images/screens/gbm_linux_wine.jpg" width="573" height="287" alt="Wine Example" /><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>
<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>
<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" src="images/screens/gbm_linux_wine_details.jpg" width="915" height="440" alt="Wine Configuration Example" /><br />
<p class="large">Can GBM share the same backup folder between Linux and Windows?</p>
<ul>
<li>Technically you can do this, but it is <b>not recommended and not supported</b>.</li>
<li>If you're playing a game on multiple platforms, you can manually import saved game backups between Windows and Linux using the "Import Backup" feature in the Game Manager.</li>
</ul>
<img class="centered" src="images/screens/gbm_linux_backup_import.jpg" width="915" height="440" alt="Wine Configuration Example" /><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>
<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>
<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><!--End Left Panel-->
</div><!--Include the Footer-->
<script type="text/javascript">
//<![CDATA[
$(function(){
$("#footer").load("footer.html");
});
//]]>
</script>
<div id="footer"></div><!--End Content-->
</div><!--End Top-->
</div>
</body>
</html>