forked from ivan-hc/Boxes-appimage
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.md.old
115 lines (77 loc) · 6.19 KB
/
README.md.old
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
Unofficial AppImage of GNOME Boxes built on top of "Conty", the portable Arch Linux container that runs everywhere.
|  |  |  |
| - | - | - |
---------------------------------
## Important!
Since its internal bubblewrap version mounts /var, you need to install "libvirt" daemons and drivers from your package manager.
On Debian and derivatives:
```
sudo apt install libvirt-daemon libvirt-daemon-system
```
On Arch Linux and derivatives:
```
sudo pacman -S libvirt
```
---------------------------------
### How it works
1. Download the AppImage from https://github.com/ivan-hc/Boxes-appimage/releases
2. Made it executable
```
chmod a+x ./*.AppImage
```
3. Run it, do this the first time from terminal, since the internal "Conty" script may detect if you need Nvidia drivers for your GPU
```
./*.AppImage
```
this may need seconds before you can use GNOME Boxes.
This AppImage does NOT require libfuse2, being it a new generation one.
---------------------------------
### How to build it
Currently, the AppImage I produced contains the following structure:
```
|---- AppRun
|---- bottles.desktop
|---- org.gnome.Boxes.svg
|---- conty.sh
```
1. The AppRun is the core script of the AppImage
2. The .desktop file of GNOME Boxes
3. The icon of GNOME Boxes
4. The Arch Linux container named "conty.sh", it contains GNOME Boxes.
Points 1, 2 and 3 are the essential elements of any AppImage.
The script "conty.sh" (4) is the big one among the elements of this AppImage.
This is what each file of my workflow is ment for:
1. [create-arch-bootstrap.sh](https://github.com/ivan-hc/Boxes-appimage/blob/main/create-arch-bootstrap.sh) creates an Arch Linux chroot, where GNOME Boxes is installed. This is the first script to be used ("root" required);
2. [create-conty.sh](https://github.com/ivan-hc/Conty/blob/master/create-conty.sh) is the second script used in this process, it converts the Arch Linux chroot created by "create-arch-bootstrap.sh" into a big script named "conty.sh", that includes "conty-start.sh";
3. [conty-start.sh](https://github.com/ivan-hc/Conty/blob/master/conty-start.sh) is the script responsible of startup inizialization processes to made Conty work. It includes a function that detects the version of the Nvidia drivers needed, if they are needed, the script downloads and installs them in ~/.local/share/Conty. Also it is responsible of full integration of Conty with the host system, using "bubblewrap;
4. [utils_dwarfs.tar.gz](https://github.com/ivan-hc/Conty/releases/download/utils/utils_dwarfs.tar.gz) contains "dwarfs", a set of tools similar to squashfs to compress filesystems, and it is needed to compress "conty.sh" as much as possible;
5. [gnome-boxes-conty-builder.sh](https://github.com/ivan-hc/Boxes-appimage/blob/main/virtualbox-conty-builder.sh) is a script i wrote to pundle "conty.sh" near the AppRun, the .desktop file and the icon to convert everything into an AppImage. It is ment to be used in github actions.
Files 1, 2, 3 and 4 come from my fork of https://github.com/Kron4ek/Conty
Files 1, 2 and 3 are a mod of the original ones to made them smaller and with only what its needed to made GNOME Boxes work.
To learn more about "Conty", to download more complete builds or to learn more on how to create your own, visit the official repository of the project:
https://github.com/Kron4ek/Conty
--------------
---------------------------------
## Troubleshot
### ◆ Very slow first startup for Nvidia users
At the first start, if necessary, the drivers for your video card will be downloaded, via Conty (see screenshot above). This may take several seconds or even minutes. This behaviour will only be noticed if when you first start it, you launch GNOME Boxes from the terminal instead of using the launcher.
### ◆ 3D Acceleration
Currently not supported, keep the "3D Acceleration" flag disabled or consider using [VirtualBox AppImage](https://github.com/ivan-hc/VirtualBox-appimage).
---------------------------------
## Credits
- Conty https://github.com/Kron4ek/Conty
------------------------------------------------------------------------
## Install and update it with ease
### *"*AM*" Application Manager*
#### *Package manager, database & solutions for all AppImages and portable apps for GNU/Linux!*
[](https://github.com/ivan-hc/AM)
[](https://github.com/ivan-hc/AM/stargazers) [](https://github.com/ivan-hc/AM/blob/main/LICENSE)
*"AM"/"AppMan" is a set of scripts and modules for installing, updating, and managing AppImage packages and other portable formats, in the same way that APT manages DEBs packages, DNF the RPMs, and so on... using a large database of Shell scripts inspired by the Arch User Repository, each dedicated to an app or set of applications.*
*The engine of "AM"/"AppMan" is the "APP-MANAGER" script which, depending on how you install or rename it, allows you to install apps system-wide (for a single system administrator) or locally (for each user).*
*"AM"/"AppMan" aims to be the default package manager for all AppImage packages, giving them a home to stay.*
*You can consult the entire **list of managed apps** at [**portable-linux-apps.github.io/apps**](https://portable-linux-apps.github.io/apps).*
## *Go to *https://github.com/ivan-hc/AM* for more!*
------------------------------------------------------------------------
| [***Install "AM"***](https://github.com/ivan-hc/AM) | [***See all available apps***](https://portable-linux-apps.github.io) | [***Support me on ko-fi.com***](https://ko-fi.com/IvanAlexHC) | [***Support me on PayPal.me***](https://paypal.me/IvanAlexHC) |
| - | - | - | - |
------------------------------------------------------------------------