qqX Installation
As with much of computing, users will benefit from some basic understanding of English
However:
THIS PAGE IS INTENDED FOR PARALLEL TRANSLATION
Click here to GOOGLE AUTO-TRANSLATE THIS PAGE
Possible Pre-Installation Error messages
These webpages use a React sub-system. The contents lists, on the right, have problems with auto-translation >>
Where available, use these:
Top - - Error messages - - Installer Script - - qqX Updater
- Make sure you have read the installation procedure pages
Sorry, you need Bash, probably 5.0 or newer to run this script.
qqX has only been tested on up-to-date versions of Bash ....
> I have backups and I understand that some processes may fail to work ....
> [enter] to confirm [e] to exit
ERROR qqX source files not found
Problems switching to main folder
Please read the notes at the start of this installer script
NON Filesystem_Hierarchy_Standard system: "/tmp" or "/usr/share" not located
[q] to quit [enter] ignore & continue
Problem locating Bash.
The start line to the qqX main script may need to be adjusted.
Sorry, you need Bash, probably 5.0 or newer to run this script.
qqX has only been tested on up-to-date versions of Bash ....
I have backups and I understand that some processes may fail to work ....
[enter] to confirm
[e] to exit
ERROR qqX source files not found
Problems switching to main folder
Please read the notes at the start of this installer script
NON Filesystem_Hierarchy_Standard system: "/tmp" or "/usr/share" not located
[q] to quit
[enter] ignore & continue
Problem locating Bash. The start line to the qqX main script may need to be adjusted.
An 'ncurses' installation should normally be present. Test using 'tput -V'
'Curl' / 'jq' is a listed dependency of QuickEmu and is also used by qqX ...
"bc" "xrandr" "paste" should normally be present and are required by qqX
Sometimes a utils package can be missing or standard utils can be packaged differently ....
xrandr can be listed as xorg-xrandr or as part of x11-xserver-utils
A 'wget' installation should normally be present and may be needed in certain places ...
A command line '7zip'/'p7zip/p7zip-plugins' installation is needed for some distro downloads...
Check for 'spice' installations 'spicy', 'spice-vdagent' and 'spice-gtk'/'spice-client-gtk' ...
Check for 'qemu' installations: qemu-system-x86_64 or qemu-full, qemu-system etc ...
A second terminal can be opened and software installed ...
Return here to re-check:
[r] re-check [c] ignore and continue [q] to quit
An 'ncurses' installation should normally be present. Test using 'tput -V'
'Curl' / 'jq' is a listed dependency of QuickEmu and is also used by qqX ...
"bc" "xrandr" "paste" should normally be present and are required by qqX
Sometimes a utils package can be missing or standard utils can be packaged differently ....
xrandr can be listed as xorg-xrandr or as part of x11-xserver-utils
A 'wget' installation should normally be present and may be needed in certain places ...
A command line '7zip'/'p7zip/p7zip-plugins' installation is needed for some distro downloads...
Check for 'spice' installations 'spicy', 'spice-vdagent' and 'spice-gtk'/'spice-client-gtk' ...
Check for 'qemu' installations: qemu-system-x86_64 or qemu-full, qemu-system etc ...
A second terminal can be opened and software installed ...
Return here to re-check:
[r] re-check
[c] ignore and continue
[q] to quit
quickemu quickget X terminal project - setup, install, uninstall & update script for qqX
ERROR qqX install script must be run from inside the original qqX folder
User-Interactive Scripts:
Root installation is not currently available
Select a trusted UserLand folder
@ 2023 Quickemu scripts are intended for 64 bit LINUX X86 distributions only
Make sure that you have read this script and the docs before continuing
quickemu quickget X terminal project - setup, install, uninstall & update script for qqX
ERROR qqX install script must be run from inside the original qqX folder
User-Interactive Scripts:
Root installation is not currently available
Select a trusted UserLand folder
Quickemu scripts are intended for 64 bit LINUX X86 distributions only
Make sure that you have read this script and the docs before continuing
The main Installer script
Top - - Error messages - - Installer Script - - qqX Updater
quickemu quickget X terminal project - setup script 1.13.04
quickemu quickget X terminal project - setup script 1.13.04
Upgrade the current release 1.13.03 ...
Always make sure these scripts have been safely downloaded and stored.
See https://github.com/qqxproject/qqX for latest releases, for starring or adding to watch lists.
[enter] to auto-install from this terminal
[u] un-install scripts and settings [enter] re-install/upgrade [m] use manual installation [q] to quit
Upgrade the current release 1.13.03 ...
Always make sure these scripts have been safely downloaded and stored.
See https://github.com/qqxproject/qqX for latest releases, for starring or adding to watch lists.
[enter] to auto-install from this terminal
[u] un-install scripts and settings
[enter] re-install/upgrade
[m] use manual installation
[q] to quit
Auto-Installing ....
[sudo] password for xxx:
Files installed: All good
A Custom default VM directory has been found >>
/media/xxx/Files/VMQs
Starting Update:
OLD SETTINGS file is being moved TO THE TRASH BIN (for recovery, if needed)
The settings file has now been updated.
All recognised original settings have been transferred.
Auto-Installing ....
[sudo] password for xxx:
Files installed: All good
A Custom default VM directory has been found >>
/media/xxx/Files/VMQs
Starting Update:
OLD SETTINGS file is being moved TO THE TRASH BIN (for recovery, if needed)
The settings file has now been updated. All recognised original settings have been transferred.
Running settings file and desktop icons routines ...
A desktop launcher already exists >>
Unless changing the terminal size, the icon or similar, may be skipped ...
[enter] to skip [r] to reconfigure
Running settings file and desktop icons routines ...
A desktop launcher already exists >>
Unless changing the terminal size, the icon or similar, may be skipped ...
[enter] to skip
[r] to reconfigure
> r
The current qqX launcher is using 'mate-terminal'
Found:
1 mate-terminal
2 uxterm
3 xterm
[enter] for mate-terminal or [number] of terminal to use [h] for help
The current qqX launcher is using 'mate-terminal'
Found:
1 mate-terminal
2 uxterm
3 xterm
[enter] for mate-terminal or
[number] of terminal to use
[h] for help
Top - - Error messages - - Installer Script - - qqX Updater
>
Setting up the desktop:
qqX standard window size is 145 columns wide & 50 lines high
Use extra height (55) if you have high numbers of Vm's
You may also edit/create a 'CustomTerminalProfile' to store different values.
See the notes near the start of the 'system' folder's installer script.
Remember that column width units are normally based on the size of your terminal font,
so changing the font will usually change the physical terminal size.
System defaults may usually be changed in the terminal settings, under 'profile'
The system's terminal size will apply when starting qqX directly from the command line.
And may overide any options if 'remember size and position' has been set.
Select 'standard' if in doubt, or where terminals do not have a -geometry parameter.
If your terminal uses PIXELS, for example 'qterminal', try 1500 x 1000 in the settings.
In other cases, such as with tiling WM envs eg 'i3' the size may be auto-regulated.
[enter] continue at standard height [t] extra height [a] as host (auto) or [q] to exit
Setting up the desktop:
qqX standard window size is 145 columns wide & 50 lines high
Use extra height (55) if you have high numbers of Vm's You may also edit/create a 'CustomTerminalProfile' to store different values. See the notes near the start of the 'system' folder's installer script.
Remember that column width units are normally based on the size of your terminal font, so changing the font will usually change the physical terminal size.
System defaults may usually be changed in the terminal settings, under 'profile'
The system's terminal size will apply when starting qqX directly from the command line. And may overide any options if 'remember size and position' has been set.
Select 'standard' if in doubt, or where terminals do not have a -geometry parameter.
If your terminal uses PIXELS, for example 'qterminal', try 1500 x 1000 in the settings.
In other cases, such as with tiling WM envs eg 'i3' the size may be auto-regulated.
[enter] continue at standard height
[t] extra height
[a] as host (auto) or
[q] to exit
>
Height selected = 50
Select Desktop icon/logo color
[enter] standard yellow ICON [b] alternative blue ICON
Text color adjustments are found in the general settings file
>
Upgrade changes are now complete
[enter] to close current window and start [q] to quit
>
qqX installer: mate-terminal
Help and info always available at https://qqxproject.org/
Your terminal or distro/terminal combination may need, or may have needed
this window to stay open until qqX has completed its tasks ...
[enter] to close
Height selected = 50
Select Desktop icon/logo color
[enter] standard yellow ICON [b] alternative blue ICON
Text color adjustments are found in the general settings file
[enter]
Upgrade changes are now complete
[enter] to close current window and start [q] to quit
[enter]
qqX installer: mate-terminal
Help and info always available at qqxproject.org
Your terminal or distro/terminal combination may need, or may have needed
this window to stay open until qqX has completed its tasks ...
[enter] to close
> h > help
85% of users are probably covered by "gnome-terminal" "konsole" "mate-terminal"
"xfce4-terminal" and over 95% probably when "qterminal" and "alacritty" are added.
For qqX purposes, alacritty works better in tiling window managers.
Try "xterm/uxterm" or "foot" if you are having problems.
Otherwise, read the guidance notes at the start of the system_install file in qqX.main
Found:
1 mate-terminal
2 uxterm
3 xterm
[enter] for mate-terminal or [number] of terminal to use [h] for help
85% of users are probably covered by "gnome-terminal" "konsole" "mate-terminal"
"xfce4-terminal" and over 95% probably when "qterminal" and "alacritty" are added.
For qqX purposes, alacritty works better in tiling window managers.
Try "xterm/uxterm" or "foot" if you are having problems.
Otherwise, read the guidance notes at the start of the system_install file in qqX.main
Found:
1 mate-terminal
2 uxterm
3 xterm
[enter] for mate-terminal or
[number] of terminal to use
[h] for help
Top - - Error messages - - Installer Script - - qqX Updater
> m
MANUAL installation
Open another terminal IN THE SOURCE FOLDER
where the following commands should be issued:
sudo cp "qqX" "/usr/bin/qqX"
sudo ln -s "/usr/bin/qqX" "/usr/bin/qqx"
From qqX 1.6 onwards, a folder /usr/share/qqX should also be created
for the subfolders and files of qqX.main and from 1.8 onwards of qqX.builtins
Existing builtin, main and lib folders should be cleaned.
Custom should be left as is.
sudo mkdir -p "/usr/share/qqX/qqX.custom"
sudo rm -r "/usr/share/qqX/qqX.main"
sudo rm -r "/usr/share/qqX/qqX.builtins"
sudo rm -r "/usr/share/qqX/qqX.lib"
sudo cp -r "./qqX.main" "/usr/share/qqX"
sudo cp -r "./qqX.builtins" "/usr/share/qqX"
sudo cp -r "./qqX.lib" "/usr/share/qqX"
sudo chmod a+rx -R "/usr/share/qqX/"
sudo chmod a+rx "/usr/bin/qqX/"
sudo chmod a+rx "/usr/bin/qqx/"
NOTE command line installation only.
Auto-install is needed for desktop launchers and shortcuts
Manual uninstall, standard procedure >> remove the hidden .qqX folder from /home/xxx
and any desktop items in folder: /usr/share/qqX
followed by: sudo update-desktop-database "/usr/share/applications"
Sudo remove the scripts > sudo rm /usr/bin/qqX & sudo rm /usr/bin/qqx
From qqX 1.6 onwards also remove sudo rm -r /usr/share/qqX
[enter] changed mind, use auto-install [y] to confirm action completed
MANUAL installation
Open another terminal IN THE SOURCE FOLDER where the following commands should be issued:
sudo cp "qqX" "/usr/bin/qqX"
sudo ln -s "/usr/bin/qqX" "/usr/bin/qqx"
From qqX 1.6 onwards, a folder /usr/share/qqX should also be created for the subfolders and files of qqX.main and from 1.8 onwards of qqX.builtins
Existing builtin, main and lib folders should be cleaned. Custom should be left as is.
sudo mkdir -p "/usr/share/qqX/qqX.custom"
sudo rm -r "/usr/share/qqX/qqX.main"
sudo rm -r "/usr/share/qqX/qqX.builtins"
sudo rm -r "/usr/share/qqX/qqX.lib"
sudo cp -r "./qqX.main" "/usr/share/qqX"
sudo cp -r "./qqX.builtins" "/usr/share/qqX"
sudo cp -r "./qqX.lib" "/usr/share/qqX"
sudo chmod a+rx -R "/usr/share/qqX/"
sudo chmod a+rx "/usr/bin/qqX/"
sudo chmod a+rx "/usr/bin/qqx/"
NOTE command line installation only.
Auto-install is needed for desktop launchers and shortcuts
Manual uninstall, standard procedure >> remove the hidden .qqX folder from /home/xxx and any desktop items in folder: /usr/share/qqX followed by: sudo update-desktop-database "/usr/share/applications"
Sudo remove the scripts > sudo rm /usr/bin/qqX & sudo rm /usr/bin/qqx From qqX 1.6 onwards also remove sudo rm -r /usr/share/qqX
[enter] changed mind, use auto-install
[y] to confirm action completed
The qqX updater
Top - - Error messages - - Installer Script - - qqX Updater
A highlighted [dl] option will appear on the qqX menu pages when a new release is available.
[dl] >> view new qqX update details: release 1.13.04 <<
[dl] view new qqX update details
_ _ \/
(_| (_| /\
|. |. 1.13.03 updater
https://github.com/qqxproject/qqX/releases/latest
https://github.com/qqxproject/qqX/releases/download/1.13.04/qqX-1.13.04.tar.gz
1.13.04
Collection of several small updates, small improvements and small bugfixes
Includes earlier:
- Upgrades to new web pages system
- Massive upgrade for QuickGet, fixes, sorts and adds over 25 distros
- New Quickget filter system
- Fixes for qqX right click and Text Editor issues in Gnome
Includes earlier downstream fixes for Quickemu issues:
- Qemu version 10.0.0
- Windows Installer
Neatly download the release into its own sub-folder at:
[d] Downloads folder: /home/xxx/Downloads
[enter] Current/Default folder: /media/xxx/Files/VMQs
[w] popup qqX web pages with browser or [b] to go back
1.13.04
Collection of several small updates, small improvements and small bugfixes
Includes earlier:
-
Upgrades to new web pages system
-
Massive upgrade for QuickGet, fixes, sorts and adds over 25 distros
-
New Quickget filter system
-
Fixes for qqX right click and Text Editor issues in Gnome
Includes earlier downstream fixes for Quickemu issues:
-
Qemu version 10.0.0
-
Windows Installer
Neatly download the release into its own sub-folder at:
[d] Downloads folder: /home/xxx/Downloads
[enter] Current/Default folder: /media/xxx/Files/VMQs
[w] popup qqX web pages with browser
or [b] to go back
In the settings file:
# Option for a Specified folder, in which sub folder "qqX.releases" gets to be placed,
other than the usual like ~/Downloads
# Give full path eg "/media/xxx/Storage/qqX.files"
Specified_Updates_Location=
Option for a Specified folder, in which sub folder "qqX.releases" gets to be placed,
other than the usual like ~/Downloads
Give full path eg "/media/xxx/Storage/qqX.files"
Specified_Updates_Location=
Top - - Error messages - - Installer Script - - qqX Updater
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0
100 712k 100 712k 0 0 1484k 0 --:--:-- --:--:-- --:--:-- 1484k
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0
100 85 100 85 0 0 203 0 --:--:-- --:--:-- --:--:-- 203
SHA256 Check: qqX-1.13.04.tar.gz: OK
File download target /media/xxx/Files/VMQs/qqX.releases/1.13.04
Use the installer script to quickly refresh and add new features to your settings file.
All option settings, locations and preferences will be kept.
[enter] to run the installer script [r] to return to main menu
File download target /media/xxx/Files/VMQs/qqX.releases/1.13.04
Use the installer script to quickly refresh and add new features to your settings file.
All option settings, locations and preferences will be kept.
[enter] to run the installer script
[r] to return to main menu