Linux Mantra is a set of interconnected Bash/Lua scripts and configuration files, which perform automated fine-grained setup of personal Linux/Java/AEM development environment. Linux Mantra has been used on a daily basis for over a year. It has undergone rigorous testing and stands as one of the most sophisticated programs of its kind.
-
Linux Mantra performs automized setup of personal Linux/Java/AEM development environment right after installation of an operating system. It installs basic packages (e.g.
curl,ffmpeg,xclip,traceroute,fzf,xdotool,tree,unzip,wget,htop,trash-cli,vim), adjusts.bashrc, customizes fonts, fixes some bugs, sets up locale formats, mounts a decompiler, personalizes directories in$HOME, remaps appropriate input keys, loads dumpeddconf, configures terminal file manager (xplr), initiates often used Bash scripts, establishes GNOME extensions, modifies run modes (.desktop) of certain default applications, associates mime types etc. -
With Linux Mantra, time required to perform the whole setup of personal Linux/Java/AEM development environment is usually less than 45 minutes (depends on the quality of internet connection).
-
Besides the initial setup after installation of an operating system, Linux Mantra can be used to keep record of the ongoing configuration changes in order to assure their reproducibility.
-
Linux Mantra was tested and can be run on Linux Ubuntu 22.x. Other Linux distributions might require adjustments of the program.
Personal Linux/Java/AEM development environment is subject to continuous change, e.g. due to obsolescence of some programs, software updates and need for new scripts. For that reason Linux Mantra is designed to be open for easy modification. Thanks to that, changes to the environment can be smoothly and handily implemented into Linux Mantra so that they will be reproducible during next setup.
-
Linux Mantra consists of two interdependent parts: a bash script
linux_mantra.shand a directoryresources. The first one is the script that drives the whole program from the very start till the very end. The directoryresources, in turn, contains files that are used (copied, modified and triggered) bylinux_mantra.sh. -
linux_mantra.shandresourcesmust be sibling files, i.e. they must be located in the same directory. -
linux_mantra.shhas hardcoded paths to files insideresources. It means that changes of files hierarchy insideresourcesmust be appropriately reflected inlinux_mantra.sh.
-
linux_mantra.shconsists of set of code blocks, each of which is visually marked by a big comment-header. -
The first code block is a set of common functions used throughout the script and the rest of blocks are procedural ones.
-
Every procedural code block starts with informing about the name of a procedure that now will be performed. In the end of every procedure the user is informed about completion, the script stops the execution to give the user time for facultative checks and prompts for continuation.
-
Procedural code blocks have numbers in headings. Those numbers represent sequence-priorities in which blocks should be run. Lower numbers (1, 2, 3…) mean higher priority, higher numbers (14, 15, 16…) mean lower priority and equal numbers (7, 7, 7…) mean the same priority. In some cases those priorities are very strict so that if the procedure with higher priority is not executed before the procedure with lower priority, the latter one will fail. In other cases those priorities are loosely coupled and arbitrary.
-
Linux Mantra files incorporate some code related to macOS as the basis for future cross-platform solution. However, at this moment during the execution of Linux Mantra on a Linux machine, the macOS related code isn’t executed and has no relevant impact on the flow of the program.
-
By design, Linux Mantra performs personalized setup. Moreover, that setup is highly personalized. Technically, anyone can run Linux Mantra and achieve the result intended by the program, but due to the mentioned particular individualization, that result might not be satisfiable (e.g. someone might prefer different key bindings or wallpaper). Therefore, Linux Mantra isn’t supposed to be a universal tool, but rather inspiration for creating other similar tools.
-
Before running Linux Mantra, perform installation of Linux Ubuntu 22.x. The installation should be done in a minimal mode (i.e. without preinstalled set of additional packages like LibreOffice) and in an erasing the disk mode, so that the operating system is clean. Among other options, choose Download updates while installing Ubuntu, but don’t choose install third-party software for graphics…
-
Right after the first boot do not install any additional programs. Right after the first boot just download this repository as a
.ziparchive and unzip it. -
Run
linux_mantra.shscript located in the root of this repository. Run it as a usual user, withoutsudo(otherwise, incorrect$HOMEvariable might be set up). -
Running
linux_mantra.shscript will start and drive the whole execution of Linux Mantra. Running that script is the only thing required to perform the setup; accompanying files from theresourcesdirectory will be accessed by the script itself. -
Follow the instructions and prompts that will appear in the terminal where
linux_mantra.shscript is running. -
linux_mantra.shcan be run from any path other than$HOME/TEMP. It resolves its actual path (and therefore - also the actual path of relativeresources) itself. -
Note that Linux Mantra isn’t run in a fully automatic mode and requires certain interaction with the user (e.g. provision of an e-mail address). The reasons for that are security considerations and open for easy modification principle mentioned above. Another reason is also ineffectiveness of full automation: certain aspects of certain programs (e.g. the location of setting for the download target in the browser) are practically nondeterministic due to constant change of those programs.
The program is subject to MIT No Attribution License
Copyright © 2022-2024 Herman Ciechanowiec
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so.
The Software is provided 'as is', without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the Software or the use or other dealings in the Software.