Skip to content

Commit 55b7101

Browse files
WhipstickgostopWhipstickgostop
committed
docs: add tabs for instructions varying on install location
1 parent 3377268 commit 55b7101

1 file changed

Lines changed: 96 additions & 62 deletions

File tree

‎streamerbot/1.get-started/1.installation/1.linux/4.uiautomationcore.md‎

Lines changed: 96 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -8,77 +8,94 @@ author: JoacoSlime
88
Guide provided by **JoacoSlime** in the `#linux-mac-os` channel on Discord
99
::
1010

11-
Since the problem is caused by wine's incomplete UIAutomationCore implementation, there are two ways to fix it
11+
The problem is caused by Wine's incomplete UIAutomationCore implementation; there are two ways to fix it:
1212

1313
## Option 1: Getting `UIAutomationCore.dll` from Windows (or an ISO)
1414

15-
You will need to get the `UIAutomationCore.dll` file from `C:\Windows\System32\UIAutomationCore.dll`.
15+
You will need to get the `UIAutomationCore.dll` file from `C:\Windows\System32\UIAutomationCore.dll`
1616

17-
- If you have dual boot or another computer with windows 10 or 11 available, then you can copy the file from there to the prefix's `drive_c/Windows/System32`
18-
- If the options above are not available, then you can download a clean Win 10 ISO from Microsoft and use that:
19-
1. Download the ISO from: `https://www.microsoft.com/en-us/software-download/windows10ISO`
17+
- If you have dual boot or another computer with Windows 10 or 11 available:
18+
- You can simply copy the file from there to the prefix's `drive_c/Windows/System32` [see below](#where-to-put-uiautomationcoredll)
19+
- If the options above are not available, then you can download a clean Windows 10 ISO from Microsoft and use that:
20+
1. Download the ISO from here: [https://www.microsoft.com/en-us/software-download/windows10ISO](https://www.microsoft.com/en-us/software-download/windows10ISO){target=_blank}
2021
2. Either use the attached `UIAC.sh` script to extract the file (requires `p7zip`) **OR** do the following:
2122
1. Mount the Win 10 ISO and go to the `sources` folder inside **OR** extract `install.wim` using p7zip: `7z e ISO_PATH sources/install.wim`
2223
2. Either mount the `install.wim` file using `wimlib` and copy the file from `Windows/System32/UIAutomationCore.dll` **OR** extract the file using p7zip `7z e install.wim 1/Windows/System32/UIAutomationCore.dll`
2324

24-
::code-collapse
25-
26-
```bash [UIAC.sh]
27-
#!/bin/bash
28-
# Saving the script directory
29-
DIR=$(pwd)
30-
31-
# Changing to a temporal working directory
32-
cd "$(mktemp -d)" || echo Error changing to a temporal directory, \
33-
will use the script directory instead.
34-
35-
# Verifing that we have a working environment
36-
37-
if ! command -v 7z &>/dev/null; then
38-
echo Install the needed package: p7zip
39-
echo Fedora: sudo dnf install p7zip
40-
echo Debian/Ubuntu: sudo apt-get install p7zip-full
41-
exit 1
42-
fi
43-
44-
# Asking for the ISO file
45-
echo Insert the path to the Windows ISO file:
46-
read -r ISO_PATH
47-
ISO_PATH=$(realpath "$ISO_PATH") # Solving path, just because
48-
echo
49-
50-
echo Extracting install.wim...
51-
# Getting the install.wim from the ISO
52-
if ! 7z e "$ISO_PATH" sources/install.wim &>/dev/null; then
53-
echo An error ocurred extracting the Windows installation file.
54-
exit 1
55-
fi
56-
echo
57-
58-
echo Extracting UIAutomationCore.dll...
59-
# Get the UIAutomationCore.dll from the .wim
60-
if ! 7z e install.wim 1/Windows/System32/UIAutomationCore.dll &>/dev/null; then
61-
echo An error ocurred extracting UIAutomationCore.dll from the installation file.
62-
exit 1
63-
fi
64-
echo
65-
66-
# Move the file where the script is called from and clean the directory
67-
mv UIAutomationCore.dll "$DIR/UIAutomationCore.dll"
68-
rm install.wim
69-
70-
echo "Done! UIAutomationCore.dll was extracted and moved to $DIR/UIAutomationCore.dll"
71-
```
72-
73-
::
25+
::code-collapse
26+
27+
```bash [UIAC.sh]
28+
#!/bin/bash
29+
# Saving the script directory
30+
DIR=$(pwd)
31+
32+
# Changing to a temporal working directory
33+
cd "$(mktemp -d)" || echo Error changing to a temporal directory, \
34+
will use the script directory instead.
35+
36+
# Verifing that we have a working environment
37+
38+
if ! command -v 7z &>/dev/null; then
39+
echo Install the needed package: p7zip
40+
echo Fedora: sudo dnf install p7zip
41+
echo Debian/Ubuntu: sudo apt-get install p7zip-full
42+
exit 1
43+
fi
44+
45+
# Asking for the ISO file
46+
echo Insert the path to the Windows ISO file:
47+
read -r ISO_PATH
48+
ISO_PATH=$(realpath "$ISO_PATH") # Solving path, just because
49+
echo
50+
51+
echo Extracting install.wim...
52+
# Getting the install.wim from the ISO
53+
if ! 7z e "$ISO_PATH" sources/install.wim &>/dev/null; then
54+
echo An error ocurred extracting the Windows installation file.
55+
exit 1
56+
fi
57+
echo
58+
59+
echo Extracting UIAutomationCore.dll...
60+
# Get the UIAutomationCore.dll from the .wim
61+
if ! 7z e install.wim 1/Windows/System32/UIAutomationCore.dll &>/dev/null; then
62+
echo An error ocurred extracting UIAutomationCore.dll from the installation file.
63+
exit 1
64+
fi
65+
echo
66+
67+
# Move the file where the script is called from and clean the directory
68+
mv UIAutomationCore.dll "$DIR/UIAutomationCore.dll"
69+
rm install.wim
70+
71+
echo "Done! UIAutomationCore.dll was extracted and moved to $DIR/UIAutomationCore.dll"
72+
```
73+
74+
::
7475

7576
### Where to put `UIAutomationCore.dll`
7677

7778
Depending on how you installed Streamer.Bot, the location of where you have to place the obtained file varies:
7879

79-
- Using Lutris: Go to `Game options`, go to the directory set in `Wine Prefix`, then go to `drive_c/windows/system32`.
80-
- Using Bottles: Inside the SB bottle, click the `Browse C:/ drive` option, then go to `windows/system32`.
81-
- Using the install script: `~/.local/lib/streamer.bot/pfx/drive_c/windows/system32`
80+
::tabs
81+
:::tabs-item{label="Install Script" Script icon=mdi:bash}
82+
83+
The install script creates a prefix in `~/.local/lib/streamer.bot/pfx`{lang=sh}, so you have to place the file in:
84+
85+
`~/.local/lib/streamer.bot/pfx/drive_c/windows/system32`{lang=sh}
86+
87+
:::
88+
:::tabs-item{label=Lutris icon=i-simple-icons-lutris}
89+
90+
Go to `Game options`, go to the directory set in `Wine Prefix`, then go to `drive_c/windows/system32`.
91+
92+
:::
93+
:::tabs-item{label=Bottles icon=mdi:bottle-wine}
94+
95+
Inside the SB bottle, click the `Browse C:/ drive` option, then go to `windows/system32`.
96+
97+
:::
98+
::
8299

83100
## Option 2: Update to wine-staging
84101

@@ -92,12 +109,29 @@ For both Lutris and Bottles, you have to manage and install other runners than t
92109

93110
Depending on how you installed Streamer.Bot, the way of changing the wine version used is different:
94111

95-
- Using Lutris, change the runner (in `runner options`) to either:
112+
::tabs
113+
:::tabs-item{label="Install Script" Script icon=mdi:bash}
114+
115+
Check that your wine version is `11.9 (staging)` or newer (use `wine --version`), if it's not, then you'll have to update wine.
116+
117+
Use your distribution's way of doing that or follow [winehq](https://wiki.winehq.org/) guide to add their repos.
118+
119+
:::
120+
:::tabs-item{label=Lutris icon=i-simple-icons-lutris}
121+
122+
- Open Lutris, right click on Streamer.bot and select `Configure`
123+
- Go to the `Runner options` tab and change the runner to either:
96124
- `wine 11.14 staging`
97125
- `System` (if it's 11.9 or newer)
98-
- Using Bottles, change the runner to either:
126+
127+
:::
128+
:::tabs-item{label=Bottles icon=mdi:bottle-wine}
129+
130+
- Open Bottles, select the Streamer.bot bottle and click on `Settings`
131+
- Go to the `Runner` tab and change the runner to either:
99132
- `kron4ek's 11.14 staging` or newer (NOT tkg, **Recomended**)
100133
- `Built-in wine 11` or newer
101134
- `kron4ek's 11.14 staging tkg` or newer
102-
- Using the install Script:
103-
- Check that your wine version is `11.9 (staging)` or newer (use `wine --version`), if it's not, then you'll have to update wine, use your distribution's way of doing that or follow winehq guide to add their repos.
135+
136+
:::
137+
::

0 commit comments

Comments
 (0)