You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* If the file does not exist, create it. If it does, delete everything inside it.
19
21
* Extract the zip release so all the contents are in that file.
20
22
* Start GOG Galaxy.
21
23
22
24
### Logging:
23
-
We tried to kill as many bugs and test as many behaviors as possible, but we aren't perfect. You may find some case we haven't tested. Please raise an issue here, and in the comment, attach your logs. They can be found here:
24
-
* For windows, this is `%programdata%\GOG.com\Galaxy\logs`
25
-
* For MacOS, this is `/Users/Shared/GOG.com/Galaxy/Logs`
25
+
We tried to kill as many bugs and test as many behaviors as possible, but we aren't perfect.
26
+
<br>You may find some case we haven't tested.
27
+
<br>Please raise an issue here, and in the comment, attach your logs.
28
+
<br>They can be found here:
29
+
* Windows:<br>`%programdata%\GOG.com\Galaxy\logs`
30
+
* MacOS: <br>`/Users/Shared/GOG.com/Galaxy/Logs`
26
31
27
32
We typically only need the `steam_<numbers and letters>.log` file.
28
33
29
34
## Setup (For Developers)
30
35
* Download [Python 3.7.9 32-bit][Python379]
31
36
* Install it with the defaults
32
37
* Create a new virtual env:
33
-
- If you only have Python 3.7.9<br/>
38
+
- If you only have Python 3.7.9<br>
34
39
`python -m venv .venv`
35
-
- If you have multiple Python versions installed (assumes you have `py` as well)<br/>
40
+
- If you have multiple Python versions installed (assumes you have `py` as well)<br>
36
41
`py -3.7 -m venv .venv`
37
42
* Activate the virtual env
38
-
- Windows, Powershell:<br/>
39
-
`.\.venv\Scripts\activate.ps1`
40
-
- MacOS, terminal:<br/>
43
+
- Windows, Powershell:<br>
44
+
`.venv\Scripts\activate`
45
+
- MacOS, terminal:<br>
41
46
`.venv/Scripts/activate`
42
-
* Install the dev dependencies:<br/>
47
+
* Install the dev dependencies:<br>
43
48
`pip install -r requirements/dev.txt`
44
49
* Make your edits
45
50
* Update the protobufs (See README_UPDATE_PROTOBUF_FILES.md for more info)
46
-
Take notice of the initial diff between the files in `protobuf_files` and `protobuf_files/orig`
47
-
Generating the python files is done via:
51
+
<br>Take notice of the initial diff between the files in `protobuf_files` and `protobuf_files/orig`
52
+
<br>Generating the python files is done via:
48
53
`inv GenerateProtobufMessages`
49
54
* Build your edits:
50
55
`inv build`
@@ -70,48 +75,55 @@ Please do the following:
70
75
<br> If using Windows, make sure you have enabled the setting that `adds Python to the PATH environmental variable`.
71
76
<br> These should be the default settings, but make sure anyway.
72
77
* Create a new virtual env:
73
-
- If you only have python 3.7.9<br/>
78
+
- If you only have python 3.7.9<br>
74
79
`python -m venv .venv`
75
-
- IF you have multiple python versions installed (assumes you have `py` as well)<br/>
80
+
- IF you have multiple python versions installed (assumes you have `py` as well)<br>
76
81
`py -3.7 -m venv .venv`
77
82
* Activate the virtual env
78
-
- Windows, Powershell:<br/>
79
-
`.\.venv\Scripts\activate.ps1`
80
-
- MacOS, terminal:<br/>
81
-
`.venv/Scripts/activate.sh`
82
-
* Use Pip to get the python tools we need to install the plugin. These will only be applied to the venv you created earlier:<br/>
83
+
- Windows, Powershell:<br>
84
+
`.venv\Scripts\activate`
85
+
- MacOS, terminal:<br>
86
+
`.venv/Scripts/activate`
87
+
* Use Pip to get the python tools we need to install the plugin.
88
+
<br>These will only be applied to the `.venv` virtual environment you created earlier:<br>
83
89
`pip install -r requirements/install.txt`
84
-
* Install the plugin. It should work if you have deleted the original plugin, but will patch it if it is there.<br/>
90
+
* Install the plugin. It should work if you have deleted the original plugin, but will patch it if it is there.<br>
85
91
`inv install`
86
92
87
-
### Installation (non-dev, Tl;Dr):
93
+
### Installation (non-dev, TL;DR):
88
94
89
95
<b>Windows (Powershell recommended)</b>
90
96
```
91
-
echo You must have installed python 3.7.9 (32 bit). If not, the rest of this won't work.
97
+
@echo You must have installed python 3.7.9 (32 bit). If not, the rest of this won't work.
92
98
py.exe -3.7 -m venv .venv
93
-
echo if the previous command did not work, you do not have py installed or py is not in your PATH. If you only have python 3.7.9, run the next command. If it worked, skip the next command.
99
+
@echo If the previous command did not work, you do not have py installed or py is not in your PATH.
100
+
@echo If you only have python 3.7.9, run the next command.
101
+
@echo If it worked, skip the next command.
94
102
python.exe -m venv .venv
95
-
echo virtual environment is installed. on to the next step.
96
-
.\.venv\Scripts\activate.ps1
103
+
@echo virtual environment is installed. on to the next step.
104
+
.venv\Scripts\activate
97
105
pip install -r requirements/install.txt
98
106
inv install
99
107
```
100
108
101
109
<b>MacOS</b> (assumes your shell is bash, which is the default. if you are good enough to change that, you can figure out how to run these)
102
110
```
103
-
echo I have installed python 3.7.9 (MacOS). If not, the rest of this won't work.
111
+
echo You must have installed python 3.7.9 (MacOS). If not, the rest of this won't work.
104
112
py -3.7 -m venv .venv
105
-
echo if the previous command did not work, you do not have py installed or py is not in your PATH. If you only have python 3.7.9, run the next command. If it worked, skip the next command.
113
+
echo If the previous command did not work, you do not have py installed or py is not in your PATH.
114
+
echo If you only have python 3.7.9, run the next command.
115
+
echo If it worked, skip the next command.
106
116
python -m venv .venv
107
117
echo virtual environment is installed. on to the next step.
108
-
./.venv/Scripts/activate.sh
118
+
.venv/Scripts/activate
109
119
pip install -r requirements/install.txt
110
120
inv install
111
121
```
112
122
113
123
### Install Error fixes:
114
-
If `inv install` throws a bunch of errors, make sure you have the proper python venv set up. It should complain about `getargspec`. If this happens, you created the wrong virtual environment. You can either delete .venv and reinstall it, or create a new virtual environment with a different name and use that. make sure you use `py -3.7` when creating your venv. If you don't have py, get it. You can specify the full path to python 3.7 instead if you want, but that's harder to do and harder to explain here.
124
+
If `inv install` throws a bunch of errors, make sure you have the proper python venv set up. It should complain about `getargspec`. If this happens, you created the wrong virtual environment. You can either delete the `.venv` folder and reinstall it, or create a new virtual environment with a different name and use that.
125
+
126
+
Make sure you use `py -3.7` when creating your venv. If you don't have `py`, get it. You can specify the full path to python 3.7 instead if you want, but that's harder to do and harder to explain here.
115
127
116
128
## Why this fork?
117
129
@@ -122,10 +134,10 @@ Well, without being too complicated, Steam changed how they do authentication. W
122
134
### Current Version:
123
135
This is a fork of https://github.com/FriendsOfGalaxy/galaxy-integration-steam
124
136
125
-
The new Authorization flow implementation is heavily influenced by SteamKit. https://github.com/SteamRE/SteamKit<br/>
137
+
The new Authorization flow implementation is heavily influenced by SteamKit. https://github.com/SteamRE/SteamKit<br>
126
138
While we have not utilized their source code, they have implemented the new authentication workflow before we did, and we used their knowledge of how to do so in order to implement it ourselves. If you are doing anything steam related in C#, you should check them out; their project has far more features than our own.
127
139
128
-
Some work was influenced by ValvePython. https://github.com/ValvePython/steam<br/>
140
+
Some work was influenced by ValvePython. https://github.com/ValvePython/steam<br>
129
141
Our projects do the same thing, but use different methods (we use asyncio, they use gevent, for example). Both projects were working on the new Auth Flow simultaneously, with little collaboration between us. That said, their scope is much larger than our own and lets you do a lot more things. If you are looking for a python means of implementing a steam network authentication, you should use their work instead.
130
142
131
143
### The names of individual developers will appear here, soon(ish). Any thanks can be directed there
0 commit comments