base on An elegant virtual machine manager for the desktop <div align="center"> <img src=".github/logo.png" alt="Quickgui" width="256" /> # Quickgui **An elegant virtual machine manager for the desktop** **Made with 💝 for <img src=".github/tux.png" align="top" width="24" alt="Tux (Linux)"/>** <!--& <img src=".github/apple.png" align="top" width="24" alt="Apple (macOS)"/>--> </div> <p align="center"> &nbsp;<a href="https://wimpysworld.io/discord" target="_blank"><img alt="Discord" src="https://img.shields.io/discord/712850672223125565?style=for-the-badge&logo=discord&logoColor=%23ffffff&label=Discord&labelColor=%234253e8&color=%23e4e2e2"></a> </p> # Introduction Quickgui is a graphical user interface for the [Quickemu](https://github.com/quickemu-project/quickemu) virtual machine manager. Quickgui enables you to create and manage virtual machines from a simple and elegant interface. Nearly 1000 operating systems supported including Windows, macOS, BSDs, and 100s of Linux distros. All with automated downloads and configuration. # Install Quickgui depends on Quickemu. Most package managers will automatically install Quickemu when you install Quickgui. If you don't have Quickemu installed then go and follow the Quickemu installation steps for your operating system: - [**Quickemu Installation**](https://github.com/quickemu-project/quickemu/wiki/01-Installation) ## Debian A .deb package is available for Debian on our [release page](https://github.com/quickemu-project/quickgui/releases). - Download the latest .deb package - Install it with `apt-get install ./quickgui-1.2.10+1-linux.deb` ## Fedora A .rpm package is available for Fedora on our [release page](https://github.com/quickemu-project/quickgui/releases). ## NixOS ### Flake [](https://flakehub.com/flake/quickemu-project/quickgui) Stable releases of Quickgui are published to FlakeHub for NixOS users. See the Quickemu flake on FlakeHub for more details: - <https://flakehub.com/flake/quickemu-project/quickgui> ### Nixpkgs Add Quickgui to your `systemPackages`. For example: ```nix systemPackages = with pkgs; [ quickgui ]; ``` ## Ubuntu Ubuntu users can install Quickgui using the [.deb package described above for Debian](#debian) or from our PPA. ```shell sudo apt-add-repository ppa:flexiondotorg/quickemu sudo apt-get update sudo apt-get install quickgui ``` ## Other Linux We provide an AppImage and a pre-compiled binary of Quickemu in a .zip file. ### AppImage The AppImage should work on most Linux distributions. * [Download](https://github.com/quickemu-project/quickgui/releases) the latest AppImage. * `chmod +x quickgui-1.2.10+1-linux.AppImage` * `./quickgui-1.2.10+1-linux.AppImage` ### Pre-compiled binary * [Download](https://github.com/quickemu-project/quickgui/releases) the latest .zip file. * `unzip quickgui-1.2.10+1-linux.zip` * `cd quickgui-1.2.10+1-linux` * `chmod +x quickgui` * `./quickgui` # Compile To compile the Quickgui yourself: * [Install Flutter](https://docs.flutter.dev/get-started/install/linux/desktop) * `git clone https://github.com/quickemu-project/quickgui.git` * `cd quickgui` * `flutter pub get` * `flutter config --enable-linux-desktop` * `flutter build linux --release` The compiled binary will be in `build/linux/x64/release/bundle/quickgui`. You can run it with: ```shell ./build/linux/x64/release/bundle/quickgui ``` # Usage <div align="center"> <small><b>Main Screen</b></small><br /><br /> <img src="assets/github/screenshot_01_main.png" width="346" height="290" alt="Quickgui Main screen"> </div> ## Downloader - From the main screen, click "Create new machines" - Select the Operating System you want to install - Select the Version of the operating system you want to use. - Click the "Download" button. - The ISO will be downloaded - When the download is complete, click the "Dismiss" button. <div align="center"> <small><b>Downloader</b></small><br /> <img src="assets/github/screenshot_02_downloader.png" width="346" height="290" alt="Quickgui Downloader"> </div> ## Manager - From the main screen, click "Manage existing machines" - The Manager screen will list available Quickemu VMs in the directory you have chosen to store them. - Start a VM by clicking the "Play" (▶) button. - Kill a running VM by clicking the "Stop" (■) button. - Clicking the "Trash" (🗑) button will prompt you to delete the whole VM or just its disk image. <div align="center"> <small><b>Manager</b></small><br /> <img src="assets/github/screenshot_03_manager.png" width="346" height="290" alt="Quickgui Manager"> </div> When a VM is running, Quickgui will display the host ports that are mapped to the SPICE and SSH ports on the guest. These ports are used to connect to the guest for display and SSH access. ### SPICE If you close the SPICE display and wish to reconnect, you can click the "Connect display with SPICE" button. To open an SSH session, you can click the "Connect with SSH" button. If the "Connect display with SPICE" button is disabled, the `spicy` client cannot be found. Ensure it is installed, and in your PATH (it should have been installed with `quickemu`). ### SSH If the "Connect with SSH" button is disabled, an SSH server cannot be detected on the guest. Most guest operating systems will not install an SSH server by default, so if it was not an option during installation, you will need to install one yourself. It must be listening on port 22 (the default SSH port). Once a server is installed and running, it should be detected automatically. "Connect with SSH" will open a terminal and attempt to connect to the guest. If the connection is successful, you will be prompted for the password. If the connection is unsuccessful, you might need to remove the host key for the guest from your `~/.ssh/known_hosts` file using something like `ssh-keygen -R [localhost]:22220`. ", Assign "at most 3 tags" to the expected json: {"id":"11045","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"