Giter Club home page Giter Club logo

trident-installer's Introduction

trident-installer

This provides a Qt5-based graphical front-end to the pc-sysinstall scriptable installer used by TrueOS.

This utility is designed to run stand-alone on the installer. It will automatically setup/start Xorg with either the "vesa" or "scfb" driver (based on whether the system is booting in Legacy or UEFI mode), setup and perform the installation through a series of prompts, and then provide the option to shutdown/reboot the system afterwards.

Bug Reports

Bug reports related to the ISO or the graphical installation procedure should be reported here.

  • Post-installation bug reports should be reported on the trident-core repository.
  • Package build/release bug reports should be reported on the trident-build repository.
  • Website or documentation bug reports should be reported on the trident-website repository.

Repo Heirarchy:

  • src-qt5: Source files for the graphical installer itself.
    • src-qt5/scripts/start-trident-installer : Initial startup script which runs on the ISO
    • src-qt5/files/ : Other setup/overlay files which need to be installed in special places on the ISO
    • src-qt5/packages.json : JSON file which details all the possible packages which can be selected for installation from the ISO.
  • pkg: FreeBSD port files
    • pkg/trident-installer : Template for the trident/trident-installer FreeBSD port
    • pkg/mkport.sh : Script to turn that template into a "real" port pointing at the latest revision of this repository

How to build the utility

The Trident installer is just a simple Qt5 utility that utilizes the "qmake" build framework.

  • Required Qt5 Modules: core, gui, widgets, concurrent
  • Required Qt5 Utilities: qmake, lrelease

Steps to build locally:

  • cd src-qt5
  • qmake
  • make To install the utility on the local system (hazardous - may overwrite some system files):
  • make install

Testing the utility

Once compiled locally, the trident-installer binary can be run on the developer system with user permissions to launch it in "debug mode" (there will be a note at the bottom of the installer which states if it is running in debug mode). This will allow full access to test out the graphical installer (in a window rather than full screen), and will simply skip the "installation" part of the utility and provide a fake 10-second timer in place of the actual installation process (for testing out the while-installing functionality). Similarly, the shutdown/reboot options in the window will just close down the utility rather than initiate the shutdown/reboot processes on the developer system.

trident-installer's People

Contributors

beanpole135 avatar berrandonea avatar mrt134 avatar q5sys avatar rodmyers avatar yater avatar yurkis avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.