Skip to content

Commit 1e89931

Browse files
committed
Mention libxcb-cursor0 in readme
1 parent edafd98 commit 1e89931

File tree

2 files changed

+47
-35
lines changed

2 files changed

+47
-35
lines changed

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,7 @@
6464
## Changes compared to v2.0.0.5608_rc2
6565

6666
- The new banner has been introduced.
67+
- The fact that EmuGUI on Linux now needs (lib)xcb-cursor0 is mentioned in the readme.
6768

6869
### Edit VM dialog - Progress
6970

README.md

Lines changed: 46 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -86,10 +86,18 @@ For the update checker, a version code is being used instead of the number. Here
8686
- RHEL: `sudo yum install qemu-kvm`
8787
- (open-)SUSE: `sudo zypper install qemu`
8888

89-
3. Get EmuGUI from this website and extract it.
90-
4. Run emugui in the EmuGUI directory (if it fails from file manager, open a terminal inside the directory and type `./emugui`).
91-
5. Set the QEMU paths at the Settings/QEMU tab (either `/usr/bin/qemu-system-*` or just `qemu-system-*`).
92-
6. Create a new virtual machine and start it.
89+
3. Starting with EmuGUI 2.0, you also need to install (lib)xcb-cursor0 in order for this to work.
90+
- Arch: `sudo pacman -S libxcb-cursor`
91+
- Debian/Ubuntu: `sudo apt install libxcb-cursor-dev`
92+
- Fedora: `sudo dnf install libxcb-cursor`
93+
- Gentoo: `sudo emerge -av x11-libs/libxcb-cursor`
94+
- RHEL: `sudo yum install libxcb-cursor`
95+
- (open-)SUSE: `sudo zypper in libxcb-cursor`
96+
97+
4. Get EmuGUI from this website and extract it.
98+
5. Run emugui in the EmuGUI directory (if it fails from file manager, open a terminal inside the directory and type `./emugui`).
99+
6. Set the QEMU paths at the Settings/QEMU tab (either `/usr/bin/qemu-system-*` or just `qemu-system-*`).
100+
7. Create a new virtual machine and start it.
93101

94102
**Another tip:** If you want a machine to run with KVM, you must open a terminal inside the directory and type: `sudo ./emugui`.
95103

@@ -235,17 +243,18 @@ For the update checker, a version code is being used instead of the number. Here
235243
3. Install Git using the install command of your distribution.
236244
4. Install Visual Studio Code. You can get it [here](https://code.visualstudio.com/download)
237245
5. Open a terminal and type: `git clone https://github.com/Tech-FZ/EmuGUI.git`
238-
6. Open Visual Studio Code in that folder.
239-
7. Open a terminal WITHIN VS Code and type: `python3 -m pip install --upgrade pip venv`
240-
8. After that is done, type: `python3 -m venv your-venv-name`. OUTSIDE of the code folder. That's why Git is only going to be used to clone the code, but not to commit - that's to be done manually.
241-
9. Wait until VS Code notices your venv and select it. You might need to restart the editor for it to recognize your virtual environment after it has been created.
242-
10. With your virtual environment selected, try to run a Python script. If it throws an error, that's okay. We just need to activate the venv anyway.
243-
11. Within the terminal VS Code just opened, type: `pip install --upgrade pip PyInstaller PySide6 python-magic requests python-dateutil psutil pyqtdarktheme`
244-
12. After this is done, run the main.py script.
245-
13. To compile the program for users who don't have Python installed, type: `PyInstaller --onefile emugui.py` (for those who can get a VENV to work) or `python3 -m PyInstaller --onefile emugui.py`
246-
14. After that is finished, copy the code into the dist folder PyInstaller created.
247-
15. Run the executable in the dist folder. If your antivirus puts it into quarantine, don't worry as this should be a false positive and restore it.
248-
16. If it works, have fun! If not, try to start again from number 7.
246+
6. As you already have the terminal open, install (lib)xcb-cursor0. Commands for that can be found on [Installation (Linux)](#installation-linux).
247+
7. Open Visual Studio Code in that folder.
248+
8. Open a terminal WITHIN VS Code and type: `python3 -m pip install --upgrade pip venv`
249+
9. After that is done, type: `python3 -m venv your-venv-name`. OUTSIDE of the code folder. That's why Git is only going to be used to clone the code, but not to commit - that's to be done manually.
250+
10. Wait until VS Code notices your venv and select it. You might need to restart the editor for it to recognize your virtual environment after it has been created.
251+
11. With your virtual environment selected, try to run a Python script. If it throws an error, that's okay. We just need to activate the venv anyway.
252+
12. Within the terminal VS Code just opened, type: `pip install --upgrade pip PyInstaller PySide6 python-magic requests python-dateutil psutil pyqtdarktheme`
253+
13. After this is done, run the main.py script.
254+
14. To compile the program for users who don't have Python installed, type: `PyInstaller --onefile emugui.py` (for those who can get a VENV to work) or `python3 -m PyInstaller --onefile emugui.py`
255+
15. After that is finished, copy the code into the dist folder PyInstaller created.
256+
16. Run the executable in the dist folder. If your antivirus puts it into quarantine, don't worry as this should be a false positive and restore it.
257+
17. If it works, have fun! If not, try to start again from number 7.
249258

250259
## Building on Linux (Python Venv, Qt installed via official installer)
251260

@@ -256,17 +265,18 @@ For the update checker, a version code is being used instead of the number. Here
256265
5. Install Qt from the following [site](https://www.qt.io/download-open-source?__hstc=152220518.4df0e407aa37c96fa5547ca135b274e3.1659787309440.1659787309440.1659787309440.1&__hssc=152220518.1.1659787309441&__hsfp=1951994995&hsCtaTracking=9f6a2170-a938-42df-a8e2-a9f0b1d6cdce%7C6cb0de4f-9bb5-4778-ab02-bfb62735f3e5) (you need a Qt account for that)
257266
6. You only need the Qt Creator.
258267
7. Open a terminal and type: `git clone https://github.com/Tech-FZ/EmuGUI.git`
259-
8. Open Visual Studio Code in that folder.
260-
9. Open a terminal WITHIN VS Code and type: `python3 -m pip install --upgrade pip venv`
261-
10. After that is done, type: `python3 -m venv your-venv-name`. OUTSIDE of the code folder. That's why Git is only going to be used to clone the code, but not to commit - that's to be done manually.
262-
11. Wait until VS Code notices your venv and select it. You might need to restart the editor for it to recognize your virtual environment after it has been created.
263-
12. With your virtual environment selected, try to run a Python script. If it throws an error, that's okay. We just need to activate the venv anyway.
264-
13. Within the terminal VS Code just opened, type: `pip install --upgrade pip PyInstaller PySide6 python-magic requests python-dateutil psutil pyqtdarktheme`
265-
14. After this is done, run the main.py script.
266-
15. To compile the program for users who don't have Python installed, type: `PyInstaller --onefile .\emugui.py`
267-
16. After that is finished, copy the code into the dist folder PyInstaller created.
268-
17. Run the executable in the dist folder. If your antivirus puts it into quarantine, don't worry as this should be a false positive and restore it.
269-
18. If it works, have fun! If not, try to start again from number 9.
268+
8. As you already have the terminal open, install (lib)xcb-cursor0. Commands for that can be found on [Installation (Linux)](#installation-linux).
269+
9. Open Visual Studio Code in that folder.
270+
10. Open a terminal WITHIN VS Code and type: `python3 -m pip install --upgrade pip venv`
271+
11. After that is done, type: `python3 -m venv your-venv-name`. OUTSIDE of the code folder. That's why Git is only going to be used to clone the code, but not to commit - that's to be done manually.
272+
12. Wait until VS Code notices your venv and select it. You might need to restart the editor for it to recognize your virtual environment after it has been created.
273+
13. With your virtual environment selected, try to run a Python script. If it throws an error, that's okay. We just need to activate the venv anyway.
274+
14. Within the terminal VS Code just opened, type: `pip install --upgrade pip PyInstaller PySide6 python-magic requests python-dateutil psutil pyqtdarktheme`
275+
15. After this is done, run the main.py script.
276+
16. To compile the program for users who don't have Python installed, type: `PyInstaller --onefile .\emugui.py`
277+
17. After that is finished, copy the code into the dist folder PyInstaller created.
278+
18. Run the executable in the dist folder. If your antivirus puts it into quarantine, don't worry as this should be a false positive and restore it.
279+
19. If it works, have fun! If not, try to start again from number 9.
270280

271281
## Building on Linux (Anaconda)
272282

@@ -276,15 +286,16 @@ For the update checker, a version code is being used instead of the number. Here
276286
4. Install Visual Studio Code. You can get it from [here](https://code.visualstudio.com/download)
277287
5. Install Qt. You can get it from [here](https://www.qt.io/download-open-source?hsCtaTracking=9f6a2170-a938-42df-a8e2-a9f0b1d6cdce%7C6cb0de4f-9bb5-4778-ab02-bfb62735f3e5)
278288
6. Open a terminal and type: `git clone https://github.com/Tech-FZ/EmuGUI.git`
279-
7. Open Visual Studio Code in that folder.
280-
8. Open Anaconda Navigator and create a new virtual environment.
281-
9. Open the venv in VS Code and try to run a Python script with it.
282-
10. Within the VS Code terminal, type: `& pip install --upgrade pip PyInstaller PySide6 python-magic PyQt6 requests python-dateutil psutil pyqtdarktheme`
283-
11. After this is done, run the main.py script.
284-
12. To compile the program for users who don't have Python installed, type: `& PyInstaller --onefile .\emugui.py`
285-
13. After that is finished, copy the code into the dist folder PyInstaller created.
286-
14. Run the executable in the dist folder. If your antivirus puts it into quarantine, don't worry as this should be a false positive and restore it.
287-
15. If it works, have fun! If not, try to start again from number 9.
289+
7. As you already have the terminal open, install (lib)xcb-cursor0. Commands for that can be found on [Installation (Linux)](#installation-linux).
290+
8. Open Visual Studio Code in that folder.
291+
9. Open Anaconda Navigator and create a new virtual environment.
292+
10. Open the venv in VS Code and try to run a Python script with it.
293+
11. Within the VS Code terminal, type: `& pip install --upgrade pip PyInstaller PySide6 python-magic PyQt6 requests python-dateutil psutil pyqtdarktheme`
294+
12. After this is done, run the main.py script.
295+
13. To compile the program for users who don't have Python installed, type: `& PyInstaller --onefile .\emugui.py`
296+
14. After that is finished, copy the code into the dist folder PyInstaller created.
297+
15. Run the executable in the dist folder. If your antivirus puts it into quarantine, don't worry as this should be a false positive and restore it.
298+
16. If it works, have fun! If not, try to start again from number 9.
288299

289300
## Documentation
290301

0 commit comments

Comments
 (0)