REX Rapid EXploitation (c) Visual Discovery Engine (c) for --- LINUX --- INSTALLATION INSTRUCTIONS Imagtek LLC (c) Oct/2024 www.imagtek.com ***************************************************** * SYSTEM CONFIGURATION REQUIREMENTS: * * LINUX or Windows-11 O/S required * * 24 Bit Truecolor Graphics must be enabled * * 8 Gigabyte RAM (Recommended) * ***************************************************** INTRODUCTION REX runs on LINUX, and LINUX is very much a 'hands-on' system. If your are uncomfortable working 'under the hood' of your computer using Command-line commands instead of a GUI, LINUX may not be a good choice for you. REX is designed from first principles to exploit high-resolution Giga-pixel color images in a unique, fast-paced interactive environment. REX can also exploit High Dynamic Range (HDR) imagery in native, scientific formats. (Yes, REX can exploit JWST raw-science imagery). Browse the 'REX User's Guide' to see what it can do. REX distributes from www.imagtek.com and will run on any LINUX or Microsoft (c) WINDOWS-11 system with Microsoft Windows Subsystem for LINUX (WSL) version 2. The REX system is extensible into new domains by users with programming ability. REX is built and maintained under Windows-11 / Ubuntu 22.04. Running an 'Installation Script' as Root is fraught with major security risks. REX is fully self-contained and requires no package manager or third party software. REX installs with a few simple LINUX commands that you enter on a command terminal. REX is a deep system designed for professional use. However, its Intelligence Wrapper shields casual users from complexity they have no use for. REX is no more difficult to understand and use than a typical video game. Note that '#' flags a comment in commands given below. REX DOWNLOAD FOR ALL x86 LINUX SYSTEMS 'rex6.0' UBUNTU / DEBIAN / RED HAT / Fedora / Windows-11 WSL If you are running LINUX under Windows-WSL, your download is probably under your 'Downloads' folder. If running native LINUX, it is wherever your downloads appear. For purposes of documentation, we will assume you have either a LINUX or Windows 'Downloads' folder. Note that the version 'rex*.*' may be different due to Version updates. **************** * SECURITY * **************** Security is a SERIOUS issue for anything that you download from the web! If you are running LINUX under Windows-WSL 2, you must install LINUX prior to running the Download security commands. Perform the LINUX installation under WSL (instructions below), then return to this section. Open a browser, go to www.imagtek.com and open the 'What's New?' page. At the top of the page you will see a security 'HASH CODE' for the REX download. You will also see the EXACT FILE SIZE, in bytes. These numbers must EXACTLY MATCH what is downloaded on your system. On the LINUX terminal, type: sha256sum $MHOME/Downloads/rex6.0.tar This is a LINUX utility for detecting dataset tampering or corruption. The output should EXACTLY MATCH the security code in the 'What's New?' page of the imagtek.com website. There is zero chance that the codes will match if the dataset has been tampered. The security code on the imagtek website is monitored for any unauthorized change. If the numbers match, your download is secure. SECURITY CODE DOES NOT MATCH!!! REX is regularly updated with incremental builds implementing enhancements and bug fixes. If the security hash code on the website does not match your distribution, check the date of the hash code. If the website code date is later than your download date, the REX distribution has been updated and you should download the most recent version. A persistent myth is that complex procedures are necessary to ensure Security. In fact, the opposite is the case. The more complex a Security Protocol, the more room there is for user errors to create vulnerabilities. ***************************************************** * DO NOT INSTALL REX IF YOUR 'sha256sum' OUTPUT * * DOES NOT MATCH THE SECURITY CODE * ***************************************************** REX ON WINDOWS-11 / WSL (Not relevant if running native LINUX). REX runs flawlessly under Windows-WSL (Windows Subsystem for Linux) Version 2. WSL is a native Microsoft (c) component of the Windows-11 operating system. If you are running on an old, slow computer you should install native LINUX on it. REX runs on any x86 LINUX distro. REX on WSL Version 2 REX works perfectly under WSL Version 2. Microsoft treats LINUX as just another app, and you can install, and delete, your entire LINUX environment just as simply as any other app. If you delete LINUX, its entire filesystem is also be deleted. Therefore, keep all your important local data files under your Microsoft account. To install WSL on Windows-11, type 'control panel' in the Windows search bar at bottom-left of the screen. Select 'features on or off'. The Control Panel will appear with a table of Windows-11 features that you enable by checking their box. Ensure that the 'Virtual Machine Platform' and 'Windows Subsystem for Linux' are BOTH checked, then click the OK button. [You need System Admin privileges.] You must reboot your computer to activate WSL. WSL has no effect on native Windows applications but runs under the Windows-11 Virtual Machine. LINUX is just another app under Windows. The following Microsoft website gives detailed instructions to install WSL on Windows-10 or Windows-11. https://www.windowscentral.com/how-install-wsl2-windows-10 With WSL activated, open the Microsoft Applications Store. It is an icon at the bottom of the screen shaped like a shopping bag. Search for 'ubuntu'. You will see several offerings. Select and install 'Ubuntu 22.04.4', or the latest version of Ubuntu offered, just as you would any other Microsoft application. You define your LINUX User Account Name when the LINUX install asks you to define a user account. This should be your Windows user name. Also, it is HIGHLY ADVISABLE to use the same User / Admin Passwords for LINUX that you use under Windows. The LINUX installation will ask you to define these. Under LINUX, the Admin is called 'root', but the User is granted Admin privileges by using the 'sudo' command. You can also set the User to 'root' with the 'su' command, and 'exit' to revert. Avoid Password Hell by thinking these things through BEFORE you install! When installation completes, activate UBUNTU by clicking it on the Windows applications menu, as you would with any Windows app. A LINUX terminal window with a commandline running the 'bash' interactive shell will appear. You will be able to launch multiple LINUX GUI applications from it. It is also simple to activate multiple simultaneous LINUX terminals. To verify your 'linuxUserName'; Type: whoami Now, you edit a configuration file to provide easy LINUX access to files residing under Windows-11. You only do this once. Type 'ls -al' on the command line. This will list your HOME Linux files. Look for the directory 'bin'. If 'bin' does not exist, create it. Type: mkdir bin Save a restore copy of the file '.bashrc'. Type: cp .bashrc .bashrcBAK Use the Linux 'vi' text editor to open the file '.bashrc' for editing. Type: vi .bashrc # do not forget '.' in front of bashrc Use 'arrow' keys to move cursor up and down The '#' flags a comment. All text after '#' is ignored by the system On the first BLANK LINE, type the character 'o' as in Open. This will open a new line underneath. Commands are Case Sensitive. Type: # WSL Windows filesystem Link and Executable path export MHOME=/mnt/c/Users/WindowsUserName/ # make MHOME/bin part of the executable search path export PATH=$PATH:/home/linuxUserName/bin/ Hit 'Return', then the Escape key. Enter ':x!' then 'Return' to save your edit Type: source .bashrc # Important! Activate the changes If error, restore .bashrc by typing: cp .bashrc.bak .bashrc You are done! Welcome to LINUX! You can now install and run REX on Windows-11. You can read/write files from the Microsoft Windows O/S, and LINUX. You can install and run REX and other LINUX GUI apps as well; even a browser! The X-Terminal window can be configured by 'right-click' on its upper window boundary. You can pin 'Ubuntu' to your task bar at the bottom of the Windows Desktop for quick '1-click' access. Also, right-click on the taskbar and set 'automatically hide taskbar in desktop mode' to 'ON'. This frees up display space for viewing full-screen images. You can install an entire LINUX software development environment under WSL and use it to extend the C/C++ REX application. REX is now maintained using WSL on Windows-11 / Ubuntu20.04.4. Note that the Windows filesystem appears under '/mnt/c' on LINUX and is directly accessable by LINUX programs. You created its alias 'MHOME' in .bashrc. The string '$MHOME' in any file path will reference your Windows account. LINUX also defines a system variable called $HOME that points to your LINUX account. $HOME LINUX home account $MHOME Windows-11 home account accessed from WSL LINUX To list the file contents of these two links: ll $MHOME # list Windows files under your account ll $HOME # list LINUX files under your account *** IMPORTANT *** It is advisable to maintain all important files under your Windows account, and restrict WSL to system files and LINUX applications. All files stored under a WSL/LINUX file system disappear if you unInstall that Linux distributon. If you have not run Security procedures (above) on the REX Download, do so now! NOTE: To make sure you have the latest version of WSL, type the following from the Windows-11 PowerShell (not LINUX Command terminal). Type: 'wsl --update' # update WSL to latest version You should be running Windows-11 WSL Version 2. Set to Version 2 if needed. Type: 'wsl --list -v' # show WSL version. 'wsl --set-version ubuntu-20.04.4 2' # set to WSL version 2 'wsl --set-default-version 2' # set default WSL version MULTIPLE WSL TERMINALS WSL opens a single LINUX command Terminal, however you can easily create multiple X-Terminals by downloading the free 'xterm' app. To install the app, in the LINUX terminal type: sudo apt install xterm Then, to create a new LINUX command terminal from the WSL terminal, type: xterm & The terminal that appears can be dragged anywhere on the Display. You now have 2 LINUX terminals. To destroy an 'xterm', type: 'exit' from it. ADVANCED WSL USERS You can download an app that will provide the complete GNOME LINUX Desktop GUI under WSL2 from: 'x410.dev' This company specializes in highly-advanced WSL2 configuration. Check it out. END WSL-------------- DECOMPRESSING THE REX DISTRIBUTION The REX distro is compressed, but a 'compressed' file extension is not present because web browsers automatically decompress such files on download. The security scan must be done on the original, compressed file. Use 'tar' command to install REX under the '/opt' system directory. *** IMPORTANT *** You MUST install REX under '/opt' or it will NOT run. cd /opt # IMPORTANT sudo tar -xvzf $HOME/Downloads/rex6.0.tar # WSL: $MHOME/Downloads/rex6.0.tar < password > cp /opt/imagtek/doc/REXdefaults.txt $HOME # REX default settings cd # return to home directory Your system will display all files that were decompressed and installed under the directory '/opt/imagtek'. You are 99% done at this point. REX INSTALLED FILE LIST The '/opt/imagtek' directory should now have the following sub-directories and files beneath the subdirectories. Delete the imagtek directory (see end of document) if the REX distribution does not match this list: Type: ls -R -l /opt/imagtek /opt/imagtek ; imagtek distribution directory bin/ ; all Imagtek executables rex6.0 ; the REX executable crypTool6.0 ; the REX batch encryption utility license/ ; empty. Copy Permanent License here doc/ ; REX documentation files REXinstall.txt ; this file REXdefaults.txt ; REX run-time configuration file (useful!) REXusrGuide.txt ; REX user's guide (useful...) REXdevGuide.txt ; developer tutorial on how to extend / improve REX CDLTlicense.txt ; licensing agreement (protects YOUR rights to IP) icon/ ; the REX desktop icons (Native LINUX only) rex.desktop *.sh *.png lib/ ; REX libraries *.so ; runtime libraries used by REX fonts/ ; text fonts used by REX *.ttf.gz src/ ; source code fftn.cc ; fourier transform code used by REX extDevel.cc ; extend REX functionality from this FOSS code more... inc/ ; the REX API ENABLING TEXT FONTS USED BY REX LINUX has no standardized Font environment, so REX comes with all the text fonts it needs. Do the following to make REX fonts accessible. --- You need only do this once --- Create a link your system can follow to find REX Fonts when REX runs. REX Fonts will also be available to other applications. First, make sure you have the necessry font-management tools pre-installed. Type: fc-list This command should display a list of all the fonts installed on your system. If 'fc-list' gives an error, you must install Linux Font configuration utilities as follows. Type: sudo apt-get update sudo apt-get install fontconfig Next, add the REX fonts directory to the Linux system fonts search path Type: sudo ln -s /opt/imagtek/lib/fonts/truetype /usr/share/fonts/truetype/rexFonts < password > Next, re-build the system font information cache files Type: sudo fc-cache -f -v [-r] < password > List the fonts your system now supports Type: fc-list | grep rexFonts # list REX fonts now supported by the system fc-list # list ALL fonts now supported by the system REX will now be able to find the fonts that it uses. Note: Issues with X11 Legacy bitmap fonts may require the following tools. Type: sudo apt-get install xfonts-utils REX uses contemporary TrueType fonts, but the Motif GUI used by REX uses the legacy X11 bitmapped fonts. To get a list of these fonts, Type: xlsfonts TEST REX INSTALLATION EXIT ROOT NOW IF YOU ARE ROOT USER! NEVER RUN REX (or any app) AS ROOT! You run REX in the background via a '&' symbol trailing the command. This allows you to continue issuing commands via the terminal with REX (or any other LINUX GUI-based app) active. You may have multiple REX sessions open simultaneously. If you have a 'multi-core' CPU and plenty of memory, multiple REX sessions should not degrade one another. On the terminal commandline, type: /opt/imagtek/bin/rex6.0 & The REX loader menu should appear. The menu has extensive HELP menus. If you know the location of some test images, load one and get a feel for REX. See 'Common Installation Errors' (below) if REX does not instantly run. CREATE A LINK TO REX UNDER $HOME/bin If you do not have a 'bin' directory, create it. mkdir bin To create the link to REX in your LINUX 'bin' directory, type: ln -s /opt/imagtek/bin/rex6.0 $HOME/bin/rex Add the following line to your .bashrc file. See WSL above for 'vi' Instructions. export PATH=$PATH:/home/linuxUserName/bin/ This done, simply typing 'rex' on the commandline should launch REX. You made $HOME/bin a part of the app search path when you configured .bashrc, above. If you upgrade to a later version of REX, simply type: 'rm ~/bin/rex', and create a link to the new version as shown above. You also do this for other apps you may install. This is simpler than repeatedly editing .bashrc and re-defining your search path. INSTALLING REX ICON ON THE LINUX DESKTOP (Not supported under Windows-WSL) Go to the directory hosting REX icons and installation scripts: cd /opt/imagtek/doc/icon List the icon installation and image files: ll rexIcon* # list the icon image files You will also find a text file: 'rex.desktop'. cat rex.desktop # display and inspect for security issues To make REX appear as an icon on your desktop, a very simple script 'creREXicon.sh' is provided to copy the files to their system locations. Since you must run this script as ROOT, it is important to inspect the script for security issues before running it. cat creREXicon.sh # display and inspect for security issues sudo ./creREXicon.sh < password > REX will now appear as an application on your system with an icon that anyone with a user account can click on to launch REX. The REX icon may not appear until after a system reboot. Note that the path to the REX executable in the 'rex.desktop' file MUST be correct or the O/S will not install the icon. Double check that the path and filenames exactly match if icon does not install. **** IMPORTANT **** If you upgrade to a more recent version of REX, read the text file /opt/imagtek/icon/rex.desktop. Basically, you simply copy the new version of rex.desktop over the older system version. If you do not do this, the REX Icon will NOT activate the most recent version of REX. DOUBLE CLICK IMAGE FILES TO ACTIVATE REX (Not supported under Windows WSL). You can configure LINUX so that double-clicking on an image file will auto- matically cause REX to load and display it. Right-click on an image file you want to open with REX and select 'Open-With|Other-Application|View All Applications'. Select REX from the list, and make it the Default application. Now, double clicking on any image file in that format will activate REX. FINISHED! REX is now fully installed and ready for evaluation on your system. The rest of this document deals with licensing and ancillary issues that you may ignore for now. Just have some fun playing with this thing. REX is very Toy-Like despite its depth and sophistication. REX RUNTIME DEFAULTS REX is delivered with a text file 'imagtek/REXdefaults.txt' that defines runtime default parameters for REX. You copied this file to your $HOME directory when you installed REX. Edit this file to configure REX to your wishes. Or not. This file is optional. In its absence REX looks for imagery in the current working directory. Remove the leading '#' to activate a configuration tag. Reference the REX User's Guide (doc/usrGuide.txt) for more information. # # File: $HOME/REXdefaults.txt # Desc: This OPTIONAL file manages REX runtime defaults Remove '#' to activate a tag. # NOTE: environment variables in PATH statements # $HOME refers to LINUX home account # $MHOME refers to Windows home account (if running Windows-WSL) # DISPLAY_SIZE=fit-to-buffer // minimum, fit-to-buffer, fullscreen, Xval,Yval IMAGE_PATH= $MHOME/Pictures/ // path to images SCRIPT_PATH=$MHOME/Pictures/scripts/ // path to scripts used by REX ISAVE_PATH= $MHOME/Pictures/art/ // path to images saved by REX WORK_PATH= $MHOME/Pictures/data/ // path to custom LUTS, saved sBUFF, etc. # USER_KEY ='?2-3:4/7*6$39,' // User Crypto Key (see REXusrGuide.txt) # ANCIL_DISP = false // ancillary display off # ALPHA = true // display ALPHA as overlay (if present) # FAST_MENU = false // use 'sticky' vs 'fast' popup menu mode # AUTOB = true // image loader auto buffer sequencing # SBUFF_WRITE= true // write-enable sBUFF for REX HDR apps~ # SBUFF_AUTO = true // auto refresh HDR display if scaling changes ZOOM_MODE = BICUBIC // REPLICATE | BILINEAR | BICUBIC | CATMULL-ROM # TWO_BUTTON_MOUSE = true // emulate 3 button mouse on 2 button mouse ************************************ *** COMMON INSTALLATION ERRORS *** ************************************ *** ERROR *** 'DISPLAY NOT FOUND' This was an old issue with Microsoft WSL Version 1. If you get this error under WSL Version 2, reference Microsoft WSL documentation. *** ERROR *** 'RUNTIME SHARED OBJECT [LIBRARY] NOT FOUND' To see a list of REX dependencies type: ldd $HOME/bin/rex or type: ldd /opt/imagtek/bin/rex6.0 This error means you installed REX under a directory other than '/opt' or you are running a RED HAT / FEDORA Linux distribution. Geniuses decided long ago that LINUX defines no cross-distribution standard for the location of shared object libraries, or which libraries included with the distro. If getting the above error message on a RED HAT/Fedora system; Type: sudo ln -s /usr/lib64 /lib/x86_64-linux-gnu < admin password > The above creates a link from where the libraries are actually located on your RED HAT / FEDORA system ( /usr/lib64 ), to where REX expects to find them on UBUNTU ( /lib/x86_64-linux-gnu ). Type: ls /lib/x86_64-linux-gnu You should get a screen-full of the shared objects under '/usr/lib64'. REX (or any UBUNTU app) should now run normally under RED HAT, FEDORA, etc. If the above does not fix the problem, type: sudo apt update sudo apt install --missing library name goes here-- That should fix the problem. REX LICENSING REX runs automatically in 'Evaluation Mode' for 7 days. There are complex issues with LINUX, Intellectual Property, and 'Free Open-Source Software' [FOSS]. The core issue is that LINUX imposes a coercive Marxist model, aka 'CopyLeft', on FOSS applications via the GNU GPL license. Imagtek summarily rejects Communism in all its forms. That said, LINUX is a VERY capable O/S; as long as you avoid legal exposure to the GNU GPL. REX is licensed under CDLT (c) (Collaborative Development Licensing Technology). You can review the CDLT License under: /opt/imagtek/doc/CDLTlicense.txt. CDLT supports unrestricted FOSS development, while protecting Developers' IP when using FOSS in applications. CDLT creates a path to a livelihood developing FOSS on LINUX. It explicitly prohibits use of source code licensed under the GNU GPL viral klepto license due to IP Copyright hijack and litigation issues. There is no GNU GPL code in REX, and its use is explicitly prohibited under CDLT. If you have a problem with this, it is easy to cleanly delete REX from your system with a few simple LINUX commands. Instructions are at the end of this document. The CDLT access control system for LINUX is available separately. The REX custom GUI X11 based source code is also available. See: imagtek/doc/CDLTfaq.txt Contact: imagtek@imagtek.com Subject: CDLT HOW IMAGTEK LICENSING WORKS When started, REX looks in 2 locations for licensing, in the following sequence; the system location: /opt/imagtek/license/REXlicense.txt the current user account: $HOME/REXlicense.txt If no license file exists, REX automatically creates $HOME/REXlicense.txt the first time you run REX. REX must have write access to do this. This Evaluation License lasts for 7 days. REX will NOT re-create it if you delete it when it expires, however a new version of REX will re-create it. ACQUIRING A REX LICENSE IS SIMPLE AND CHEAP You order a permanent (20 year) license by making a PayPal (c) or Venmo (c) ePayment to: imagtek@imagtek.com You enter a 'License Order Code' and your email address as a comment to your payment. You will receive your Permanent License code via email. Enter this code into REX, and REX converts the Evaluation License under your HOME directory into a Permanent License . You then copy the license file to /opt/imagtek/license/ and keep the copy under your $HOME account as a backup. That is all there is to it. There is NO 'background' license process, no internet validation, etc. On a commandline, display your LICENSE ORDER CODE. Type: rex -L Your REX license order code is: C4C6CF97 The code is a bit-hash that uniquely tags your system, but cannot be deciphered into any useful information. The REX Exploitation System will also display a Licensing reminder once per session. CREATING A LICENSE ORDER A license order consists of: the 'LICENSE ORDER CODE', an 'Access Level', and an email address to receive the Permanent License. A sample REX LICENSE ORDER: C4C6CF97 access 2 your@email.adr This order specifies Permanent Licensing at 'Level 2' functionality on the system that created the order code: C4C6CF97. YOUR EMAIL ADDRESS MUST TRAIL THE LICENSE ORDER OR WE HAVE NO WAY TO REPLY WITH YOUR PERMANENT LICENSE CODE. The order code, and license, are NOT case sensitive. PURCHASING A PERMANENT REX LICENSE VIA PAYPAL OR VENMO You purchase a permanent REX license via: www.paypal.com, or the smart-phone 'Venmo' app. Login to your PayPal or Venmo account and go to the payments page. Select that you want to 'SEND FUNDS' to: imagtek@imagtek.com ***************************** REX PRICING ************************************** In the payment area, enter the amount due for the license(s). ACCESS LEVEL 1 (no Encryption) $ 100 corporate ( corporate/government use ) $ 25 personal ( personal use ) $ 15 student ( student/educational '*.edu' mail domains) $ 5 student ( educational/Africa, SE Asia, S America ) You may request waiver of the Permanent license fee if it is a hardship. ACCESS LEVEL 2 (includes AES-256 Encryption) Encryption enables you to protect REX-created IP, requiring a KEY to access it. REX will also transparently read images that it encrypts. This supports numerous business models. $ 250 corporate ( corporate/government use ) $ 100 personal ( personal use ) ******************************* IMPORTANT ************************************* YOU MUST ENTER THE FULL LICENSE ORDER CODE, ACCESS LEVEL, AND RETURN EMAIL IN THE 'COMMENTS' SECTION OF THE PAYPAL/VENMO FINANCIAL TRANSACTION SCREEN! YOUR ORDER 'COMMENTS' SHOULD APPEAR AS BELOW: C4C6CF97 access 2 your@email.adr This information is parsed by computer. PLEASE DO NOT ADD ANY OTHER TEXT! If ordering multiple licenses, create a list, with one license order per line. Comments or communication to IMAGTEK must be done separately from orders. LICENSE RECEIPT After sending payment, you will receive a reply to your email containing your PERMANENT LICENSE CODE as a 16 character (64 bit) alphanumeric string: F9ADFDD1F5D76FFB Order# C4C6CF97 A license will only enable REX on the machine that created the order code! If you ordered multiple licenses, the licenses will arrive as a list. INSTALLING THE PERMANENT LICENSE Install the permanent license using the terminal commandline: Verify correct order code for license. Order# MUST match: rex -L Your REX license order code is: C4C6CF97 Verify that the license order code matches the Order # on the license. If the Order# does not match, REX will not run. To install the license, type the Permanent License on the commandline: rex -L F9ADFDD1F5D76FFB REX will notify you of success. To display the new license, type: cat ~/REXlicense.txt Retain this copy under your user account as a backup. If you accidentally entered the wrong code, simply repeat the operation. You may also use the REX licensing screen under 'ANCILLARY | LICENSE'. COPY THE PERMANENT LICENSE TO THE SYSTEM LOCATION You want any user on your computer to have full access to REX. To do this, copy the Permanent License created under your user account to '/opt/imagtek/license/' cd /opt/imagtek/license sudo cp $HOME/REXlicense.txt . Password? sudo chown root:root REXlicense.txt # change license file owner to root sudo chmod 644 REXlicense.txt # make license file read-only cd # return to $HOME You are done! REX is now fully licensed for any user on your machine. FREE SOFTWARE UPDATES FOR ONE YEAR When running REX, the exploitation menu has an 'ANCILLARY|LICENSE' pane. Selecting this pane will let you know how many days of 'Free Software Update' remain. To update REX, simply de-compress it on top of the existing release. No re-licensing is necessary. The new install will not overwrite your license. NOTE: If the REX version changed, you must update the 'rex.desktop' icon file. The icon file contains simple instructions how to do this. *** ERROR *** REX LICENSING FAILURE Probable causes: You made a mistake typing your machine's Order Code. Email request for a replacement license using correct Order Code. Your free software update period has expired. The permanent license displays the 1 year cutoff date for software updates Your evaluation license expired or was deleted. After the 60 day evaluation period, you must purchase a Permanent license. Deleting the evaluation license will NOT cause REX to renew it. You moved the REX installation to a new computer. REX licenses are non-transferable across machines. You are running REX in a 'sandbox' with no write privileges anywhere. REX must be able to write its 'Evaluation License' to your home account. REX kernel license works, but Derivative Work extension does not. Licensing issues with Derivative Works of REX must be resolved through the Derivative Work developer. There are no exceptions to this policy. Imagtek will unconditionally replace any non-functioning Permanent License for the kernel REX application within 14 days of receipt, no questions asked. Once. Email us the full text of the non-functioning license, and your new order code. If the license still does not work, we will consult via email, or refund the fee. Imagtek will not respond to any issues regarding Collaborative Works. All such issues must be taken up with the Collaborative Developer. Send REX licensing legal issues to: imagtek@imagtek.com Subject: REX Licensing BUGS REX consists of almost 100K SLOC. REX is stable but, like any non-trivial application, undetected bugs may remain. Improvement of REX is continuous with frequent updates. If a REX function produces strange or unanticipated results, or in the unlikely event that REX crashes [ ~:o ], we want to know about it!!! Also what happened vs what was expected to happen, the file format, and activities preceeding the anomaly. If REX crashed while reading a file, we need a copy of the file being read. If REX reads similar files without error, the file may be corrupted. That is not a bug. Please report bugs to: imagtek@imagtek.com Subject: REX bug KNOWN ISSUES: Windows WSL-2 only: Text Issues with Image Loader Motif GUI The REX image Loader is based upon the legacy Motif GUI interface. A problem occurs occasionally under Windows-11/WSL where text in the Motif GUI drop-down menus becomes garbled. This problem does not exist under Native LINUX. The GUI problem occurs randomly and infrequently but once the problem appears it persists; even if you Exit & Re-start REX, and even if you close, then re-open your WSL LINUX session. The fix is to Log-Off your computer, then Log-On. A Re-start also fixes the problem. Microsoft is actively maintaining WSL, and the Wayland interface is replacing X11, so this problem is likely temporary. To make sure you are always using the latest version of WSL, open a Microsoft PowerShell terminal and enter: wsl --update REX DEVEOPMENT You must install the following LINUX software development tools and runtime- libraries used by REX to modify and rebuild the REX application. The '*.h' files describing relevant APIs will be found under '/usr/include'. Microsoft Visual Studio Code [vscode] is a capable text editor [free]. You can download Ubuntu or other LINUX variants [free] from Microsoft.com applications store for WSL install. sudo apt update sudo apt install build-essential # C++ compiler, make utility, linker sudo apt install libx11-dev # X11 graphics sudo apt install libxft-dev # X11 font server; 'man xft' sudo apt install libmotif-dev # Motif GUI [image loader] sudo apt install libcfitsio-dev # fits image format sudo apt install libwebp-dev # webp " sudo apt install libjpeg-dev # jpeg " sudo apt install libtiff-dev # tiff " sudo apt install libpng-dev # png " sudo apt install libavif-dev # avif " sudo apt install fontconfig # linux font support # if you encounter device driver problems on legacy systems try... sudo apt install gnome-tweaks # gnome window manager extensions sudo apt install xorg-xwayland # successor to X11 on LINUX sudo apt install libxft-dev # contemporary scalable font support sudo apt install libfreetype-dev # libxft dependency DELETING THE REX INSTALLATION The REX installation is completely self contained and is easily deleted. Note that uninstalling LINUX under Windows/WSL will automatically uninstall REX and all files under your WSL/LINUX partition. Thus, under Windows/WSL it is advisable to store valuable files under your Windows-11 filesystem and not under LINUX. To cleanly delete REX: cd /opt/imagtek/icon/ # not relevant under WSL cat delREXicons.sh # perform script security inspection! sudo ./delREXicons.sh # delete REX desktop icons cd /opt sudo rm -rf imagtek # remove REX distribution sudo rm /usr/share/fonts/truetype/rexFonts # remove REX text fonts link sudo fc-cache -f -v # undefine removed fonts cd # set CWD to $HOME rm REXlicense.txt rm REXdefaults.txt rm Downloads/rex6.0.tar # remove the REX distribution file rm bin/rex # remove the link to the rex executable rm bin/crypTool5.1 # " rex encryption utility REX is now completely deleted from your system. THANK YOU!!! ~:D We hope that you enjoy REX. Creating it was... interesting. Using REX is FUN! Users will quickly discover that REX is not only a deep analytic system, but also a powerful artistic creative medium or just a fun image explorer. REX capabilities will challenge a scientist intellectually, blow an artist's mind, and amuse bright children age 7+ for hours on a junk laptop. So grab a cup of coffee, install REX, load a Giga-pixel color image of the Universe or whatever, and have fun Exploring! You WILL be amazed. There is nothing else like REX out there. Really. There isn't.