Skip to content
/ qqX Public
forked from TuxVinyards/qqX

qqX - Quickemu Virtual Machine Manager - A powerful desktop integrated interface for both advanced users and quickemu beginners alike

License

Notifications You must be signed in to change notification settings

oSoWoSo/qqX

 
 

Repository files navigation

qqX

" quickemu quickget X terminal project "

1.6.02 introduced a new Custom Boot system that can run Arm64, Risc-V and others.

Release 1.7.01 has lots of new interface features and is now good to go 🚀

Except, on Fedora 39, expect a point release shortly to fix a problem with the coreutils ...

That said, 1.7 does fix the minor glitch in the 1.6 installer that some may have noticed. Apologies if you were affected.

Lots of details in the new Wiki pages and in the adjusted main readme.

Quickemu Virtual Machine Manager - A Safe and Powerful TUI

  • Full process & version controlled wrapping of both Quickemu & Quickget

  • Desktop Integrated. Works safely alongside other existing GUI installations

qqX-vmm

Why quickemu?

Quickemu is simply built and easy to use.

It has an active community and is the only virtual machine manager that makes easy work of running Microsoft Windows.

VirtualBox was good in its day .... developers are now moving to QEMU

Unfortunately, Qemu front-ends are often enterprise orientated and based on LibVirt, which can be quite abstract and complex.

And even beneath Gnome Boxes' initially simple interface, for example, something basic like moving the VM folder contains a whole learning curve. Forget anything more unless you wish to become an expert in xml, gnome3 & vala

Quickemu, on the other hand, is a simple and capable Bash script. Much easier for community contributions. Much easier to edit and easy to fix.

Why qqX?

qqX goes far beyond a front-end restricted to the basic quickemu API

  • A full menu system that improves on the traditional quickemu interfaces

  • Lots of power and functions. Even more than quickemu.

  • An easy installation with no additional software or dependencies required.

Quickemu only works on the command line and quickgui is very basic.

  • qqX is fully compatible with quickgui if it is already installed on your system.

Using qqX will power up existing VM's with improved display modes, utilities, optimizers and tools.

Not just a text interface

Less can be more.

new -vm-selector-qqX

qqX uses the same well-known scripting language that is used by quickemu.

And anything within quickemu can be easily taken, shaped and improved.

Install the latest ISO's at the click of a mouse

right-click-iso

No need to wait for Quickget to add in the distros or releases that you want.

Get the latest fixes too

There is no need to wait for official bug fixes to make their way through the system either. Any new input from the quickemu community activity can be directly accessed and put to work.

Confident Linux users should quickly find themselves at home.

Work continues

Release 1.1.01 improved the front end machine selector & makes clearer folder organisation:

Release 1.1.03 improved the main menu & added a gtk display option, while 1.5.02 now has GL toggle:

ubuntu-qqX-zsync

Release 1.5.02 added alphabetical zooming into list sections for the Quick Get multi distro menu:

alpha-zoom-qget

Release 1.7.01 now has a choice of 5 menu styles and of Custom Menus 🚀

vm-small-d

Earlier releases have added:

  • Distro homepage browser and link checker

  • Configuration tune-up wizard

  • Screen percentage switching (default & individual)

  • Multiple snapshot management, including of shared disks.

  • qcow2 repair & resize

  • Secondary storage creation

  • Progress reporting on distro downloads & zsync iso's.

  • Process logging and diagnostics

Screenshot at 2023-02-22 12-59-04-1920

How to Install

qqX will work happily alongside quickgui or any quickemu shortcuts. But these are not necessary.

Start from scratch. Or safely test out the qqX difference on your existing quickgui VM's

  • If you don't already have a standard Quickemu setup, start by installing that, complete with all its components and all its dependencies, as in the instructions on the quickemu-project pages

    You must be able to type quickemu at a command prompt and get the quickemu usage screen.

  • Download qqX. The latest release is available here. You can also download via the code/clone button. The 'dev' branch may be newer and may have the very latest tweaks and bug fixes too ...

    No other software, support structures or dependencies are needed.

See the installer Wiki for more details

FAQs and Help

FAQ: Wiki

Release notes

Testing has been carried out on a variety of mainstream distros.

All scripts have been carefully Shellcheck linted & have full error handling routines.

qqX always makes backups, as is standard good practice with any software.

Release 1.1.05, added an extra layer of qemu-img disk health checks to the disk info function.

disk error alert crop

Feedback, positive or constructive, at https://discord.gg/sNmz3uw

Development

When making clones of the repo to your local machine, you can easily run any new version of qqX directly from the working folder.

See the specific wiki for more details

Bash

Learning Bash, or improving your knowledge of it, is always time well spent. Bash is a flexible language of which all Linux users should know at least a little. There are none of steep learning curves that are often involved with GUI's

Use of a clear and well annotated qqX coding style means that even Bash novices should be able to find their feet. Any confident Linux user should find it relatively easy to make simple edits.

why 'X' ?

More technically speaking qqX runs in a 'terminal emulator' and can also run with Wayland display systems as well as with 'X'

But traditionally Linux uses the X window system from X.org, so 'X term' often gets used as shorthand ...

https://en.wikipedia.org/wiki/X_Window_System

https://en.wikipedia.org/wiki/Wayland_(protocol)

About

qqX - Quickemu Virtual Machine Manager - A powerful desktop integrated interface for both advanced users and quickemu beginners alike

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%