diff --git a/README.md b/README.md deleted file mode 100644 index b3860f4..0000000 --- a/README.md +++ /dev/null @@ -1,82 +0,0 @@ -# Luke's Auto-Rice Bootstraping Scripts (LARBS) - -[Official Website: larbs.xyz](http://larbs.xyz) - -This is a set of scripts either can either (1) install Arch Linux automatically with a typical Arch ISOed USB, and perhaps more prominently (2) automatically install and configure all of the prerequisites for an advanced Linux desktop environment, using my configs [here](https://github.com/LukeSmithxyz/voidrice) as a base. - -Really, the goal of this script is to start a kind of Linux meta-distribution which makes the more nuanced aspects of an advanced Linux setup available to even Linux newbies. Of course, it's also a great tool for advanced users who want to get into tiling window managers and just generally cool-looking and efficient worksetups. - -All the core stuff we be installed without prompt, but you'll have the option to install some of the larger non-essential packages (LaTeX, LibreOffice, Blender, etc.). - -## Installation - -### Installing my setup on an already existing Arch install - -This is just as easy. Log in as the root user and run the following. - -``` -curl -O http://larbs.xyz/larbs.sh #Downloads the script. -bash larbs.sh #Runs it. -``` - -After prompting you for some settings and some package choices, the system will install my full i3-gaps tiling window manager Desktop Environment. If you don't know what that means, don't worry, because I've gone to great lengths to write readable instructions about how to go PRO super quick with this system. - -Finally, it will use `git` to download my [Voidrice](https://github.com/lukesmithxyz/voidrice) dotfiles and will plop them in their proper location for instant use! - -Then, finally, once that all is done, you should be able to log out, then log in as your newly created user and type `startx` to begin the graphical environment. Congrats! - - -### Installing Arch Automatically - -I also have a script here for installing Arch automatically. I *only* wrote this script so I could quickly install then test the other scripts on new computers, but theoretically you could use it as well. *BUT* this is a lazy, pre-alpha script which does not give you many options (it automatically chooses the New York time zone, US English, GRUB, Network Manager, etc). Even more important, it automatically partitions /dev/sda without asking, so unless, you have no non-backed up data on your machine, I don't advise running it unless you don't mind a full wipe. That said, you can run it like this after booting into an Arch live environment: - -``` -curl -O http://larbs.xyz/arch.sh #Downloads the script. -bash arch.sh #Runs it. -``` - -After the system installs, you'll have the option of bootstrapping automatically into installing my configs as well. - -## How to Use - -Once you're in the environment, just type Super/Mod/Windows+F1 to pull up a document that will explain everything. - -## Permission Details (sudoers file) - -These script will give your new created user (and those others you put in the `wheel` group) sudo access (with a password), but will also allow some commands to be run without any password confirmation. Those include: - -+ `shutdown` -+ `reboot` -+ `pacman -Syyu`/`pacman -Syu` -+ `packer -Syyu`/`packer -Syu` -+ `mount` -+ `umount` -+ `systemctl restart NetworkManager` - -Additionally, if you've put your password in a terminal window already, you will not need to repeat putting it in in other terminal windows. - -## Version - -We're basically on Version 2.0 now, which is still pretty primitive. I'm adding some error handling, if the script fails, check the contents of LARBS.log in whatever directory you've run the script. Still, this script is still in the Wild West, so I recommend only running it on fresh installs. - -## Why I made this - -When you've installed Arch Linux 6 gorrillian times like me, you get pretty sick of having to reproduce your favorite configuration on fresh installs over and over. When you're a C-list YouTube celebrity, it gets even more difficult when literally thousands of people ask you how to do X or get Y. - -The LARBS are a final solution to all of that. These scripts are to be run on a fresh install of Arch Linux, and they create a user, install all required programs and set up dotfiles directly from Github to give normal people a fairly sleek Linux configuration without hundreds of autsitic hours. I did the work, so why should you? - -I've also documented the configuration fairly well, check out the documentation on my **voidrice** repository for that. - -## Bugs? - -### When I type `startx` I get some kind of non-descript error! - -Some computers might require some additional drivers to run a graphical environment, for example, some ThinkPads might require you to install `xf86-video-intel`. If you search your model or graphics card along with "Arch Linux" on your preferred search engine, you'll probably get the answer fast. - -### I have some other problem and it didn't install correctly. - -In normal circumstances, there are two main causes of misinstalls: faulty internet connections and errors with particular package upgrades or with the pacman keyring. Check yourself if the former may be at fault, but feel free to inform me in the latter case; I may be able to provide a quick fix. - -### >still using systemd botnet distro and/or not a 100% free-as-in-freedumb Parabola GANOO slash Linocks - -I do plan on making an alternative script option for Parabola sooner or later, after all Parabola *is* the distro I actually use. If you want to use Arch OpenRC or another Arch-based non-systemd distro, I think this script still *should* work, although you may have to manually enable Network Manager or Pulseaudio. I haven't tested this though. If you have, tell me the results and I might implement it. diff --git a/README.md b/README.md new file mode 120000 index 0000000..0e01b43 --- /dev/null +++ b/README.md @@ -0,0 +1 @@ +docs/README.md \ No newline at end of file diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..2390c97 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,156 @@ +# Luke's Auto-Rice Bootstraping Scripts (LARBS) + +[Official Website: larbs.xyz](http://larbs.xyz) + +This is a set of scripts either can either (1) install Arch Linux automatically +with a typical Arch ISOed USB, and perhaps more prominently (2) automatically +install and configure all of the prerequisites for an advanced Linux desktop +environment, using my configs [here](https://github.com/LukeSmithxyz/voidrice) +as a base. + + +## Table of Contents + + - [About](#about) + - [Installation](#installation) + - [On an already existing Arch install](#on-an-already-existing-arch-install) + - [Installing Arch automatically](#installing-arch-automatically) + - [How to Use](#how-to-use) + - [Permission Details (sudoers file)](#permission-details-sudoers-file) + - [Version](#version) + - [Why I made this](#why-i-made-this) + - [Bugs?](#bugs) + + +## About + +Really, the goal of this script is to start a kind of Linux meta-distribution +which makes the more nuanced aspects of an advanced Linux setup available to +even Linux newbies. Of course, it's also a great tool for advanced users who +want to get into tiling window managers and just generally cool-looking and +efficient worksetups. + +All the core stuff we be installed without prompt, but you'll have the option +to install some of the larger non-essential packages (LaTeX, LibreOffice, +Blender, etc.). + + +## Installation + +### On an already existing Arch install + +This is just as easy. Log in as the root user and run the following. + +```sh +curl -O http://larbs.xyz/larbs.sh #Downloads the script. +bash larbs.sh #Runs it. +``` + +After prompting you for some settings and some package choices, the system will +install my full i3-gaps tiling window manager Desktop Environment. If you don't +know what that means, don't worry, because I've gone to great lengths to write +readable instructions about how to go PRO super quick with this system. + +Finally, it will use `git` to download my +[Voidrice](https://github.com/lukesmithxyz/voidrice) +dotfiles and will plop them in their proper location for instant use! + +Then, finally, once that all is done, you should be able to log out, then log in +as your newly created user and type `startx` to begin the graphical environment. +Congrats! + +### Installing Arch automatically + +I also have a script here for installing Arch automatically. I *only* wrote this +script so I could quickly install then test the other scripts on new computers, +but theoretically you could use it as well. *BUT* this is a lazy, pre-alpha +script which does not give you many options (it automatically chooses the New +York time zone, US English, GRUB, Network Manager, etc). Even more important, it +automatically partitions /dev/sda without asking, so unless, you have no +non-backed up data on your machine, I don't advise running it unless you don't +mind a full wipe. That said, you can run it like this after booting into an Arch +live environment: + +```sh +curl -O http://larbs.xyz/arch.sh #Downloads the script. +bash arch.sh #Runs it. +``` + +After the system installs, you'll have the option of bootstrapping automatically +into installing my configs as well. + + +## How to Use + +Once you're in the environment, just type `Super` / `Mod` / `Windows` + `F1` to +pull up a document that will explain everything. + + +## Permission Details (sudoers file) + +These script will give your new created user (and those others you put in the +`wheel` group) sudo access (with a password), but will also allow some commands +to be run without any password confirmation. Those include: + ++ `shutdown` ++ `reboot` ++ `pacman -Syyu`/`pacman -Syu` ++ `packer -Syyu`/`packer -Syu` ++ `mount` ++ `umount` ++ `systemctl restart NetworkManager` + +Additionally, if you've put your password in a terminal window already, you will +not need to repeat putting it in in other terminal windows. + + +## Version + +We're basically on Version 2.0 now, which is still pretty primitive. I'm adding +some error handling, if the script fails, check the contents of LARBS.log in +whatever directory you've run the script. Still, this script is still in the +Wild West, so I recommend only running it on fresh installs. + + +## Why I made this + +When you've installed Arch Linux 6 gorrillian times like me, you get pretty sick +of having to reproduce your favorite configuration on fresh installs over and +over. When you're a C-list YouTube celebrity, it gets even more difficult when +literally thousands of people ask you how to do X or get Y. + +The LARBS are a final solution to all of that. These scripts are to be run on a +fresh install of Arch Linux, and they create a user, install all required +programs and set up dotfiles directly from Github to give normal people a fairly +sleek Linux configuration without hundreds of autsitic hours. I did the work, so +why should you? + +I've also documented the configuration fairly well, check out the documentation +on my **voidrice** repository for that. + + +## Bugs? + +### When I type `startx` I get some kind of non-descript error! + +Some computers might require some additional drivers to run a graphical +environment, for example, some ThinkPads might require you to install +`xf86-video-intel`. If you search your model or graphics card along with "Arch +Linux" on your preferred search engine, you'll probably get the answer fast. + +### I have some other problem and it didn't install correctly. + +In normal circumstances, there are two main causes of misinstalls: faulty +internet connections and errors with particular package upgrades or with the +pacman keyring. Check yourself if the former may be at fault, but feel free to +inform me in the latter case; I may be able to provide a quick fix. + +### >still using systemd botnet distro and/or not a 100% free-as-in-freedumb Parabola GANOO slash Linocks + +I do plan on making an alternative script option for Parabola sooner or later, +after all Parabola *is* the distro I actually use. If you want to use Arch +OpenRC or another Arch-based non-systemd distro, I think this script still +*should* work, although you may have to manually enable Network Manager or +Pulseaudio. I haven't tested this though. If you have, tell me the results and +I might implement it. + diff --git a/arch.sh b/src/arch.sh similarity index 100% rename from arch.sh rename to src/arch.sh diff --git a/chroot.sh b/src/chroot.sh similarity index 100% rename from chroot.sh rename to src/chroot.sh diff --git a/larbs.sh b/src/larbs.sh similarity index 89% rename from larbs.sh rename to src/larbs.sh index 049f219..52e1684 100755 --- a/larbs.sh +++ b/src/larbs.sh @@ -12,12 +12,12 @@ dialog --title "Welcome!" --msgbox "Welcome to Luke's Auto-Rice Bootstrapping Sc dialog --no-cancel --inputbox "First, please enter a name for the user account." 10 60 2> /tmp/.name dialog --no-cancel --passwordbox "Enter a password for that user." 10 60 2> /tmp/.pass1 -dialog --no-cancel --passwordbox "Reype password." 10 60 2> /tmp/.pass2 +dialog --no-cancel --passwordbox "Retype password." 10 60 2> /tmp/.pass2 while [ $(cat /tmp/.pass1) != $(cat /tmp/.pass2) ] do dialog --no-cancel --passwordbox "Passwords do not match.\n\nEnter password again." 10 60 2> /tmp/.pass1 - dialog --no-cancel --passwordbox "Reype password." 10 60 2> /tmp/.pass2 + dialog --no-cancel --passwordbox "Retype password." 10 60 2> /tmp/.pass2 done chmod 777 /tmp/.name @@ -108,9 +108,89 @@ cat << "EOF" EOF sleep .5 -blue Now installing main programs... -pacman --noconfirm --needed -Sy base-devel xorg-xinit xorg-server noto-fonts rxvt-unicode feh ffmpeg pulseaudio pulseaudio-alsa wireless_tools arandr pavucontrol pamixer mpv wget rofi vim w3m ranger mediainfo poppler highlight tmux calcurse htop newsboat mpd mpc ncmpcpp network-manager-applet networkmanager imagemagick atool libcaca compton transset-df markdown mupdf evince rsync git youtube-dl youtube-viewer cups scrot unzip unrar ntfs-3g offlineimap msmtp notmuch notmuch-mutt dosfstools r pandoc python-dbus python-gobject xf86-video-intel || (red Error installing basic packages. Check your internet connection and pacman keyring.) +blue \[1\/6\] Now installing main programs \(system basics\)... +pacman --noconfirm --needed -Sy \ + base-devel \ + xorg-xinit \ + xorg-server \ + compton \ + arandr \ + noto-fonts \ + rxvt-unicode \ + unzip \ + unrar \ + wget \ + atool \ + ntfs-3g \ + xf86-video-intel \ + dosfstools \ + cups \ + transset-df \ + htop || (red Error installing system basics. Check your internet connection and pacman keyring.) + + +blue \[2\/6\] Now installing main programs \(productivity\)... +pacman --noconfirm --needed -Sy \ + calcurse \ + ranger \ + vim \ + tmux \ + rofi \ + poppler \ + mupdf \ + evince \ + pandoc || (red Error installing productivity packages. Check your internet connection and pacman keyring.) + + +blue \[3\/6\] Now installing main programs \(network and internet\)... +pacman --noconfirm --needed -Sy \ + wireless_tools \ + network-manager-applet \ + networkmanager \ + w3m \ + offlineimap \ + msmtp \ + notmuch \ + notmuch-mutt \ + rsync \ + newsboat || (red Error installing network packages. Check your internet connection and pacman keyring.) + + +blue \[4\/6\] Now installing main programs \(graphics\)... +pacman --noconfirm --needed -Sy \ + feh \ + imagemagick \ + scrot \ + libcaca || (red Error installing graphic packages. Check your internet connection and pacman keyring.) + + +blue \[5\/6\] Now installing main programs \(audio\)... +pacman --noconfirm --needed -Sy \ + ffmpeg \ + pulseaudio \ + pulseaudio-alsa \ + pavucontrol \ + pamixer \ + mpd \ + mpc \ + ncmpcpp \ + youtube-dl \ + youtube-viewer \ + mediainfo \ + mpv || (red Error installing audio packages. Check your internet connection and pacman keyring.) + + +blue \[6\/6\] Now installing main programs \(devel\)... +pacman --noconfirm --needed -Sy \ + python-dbus \ + python-gobject \ + markdown \ + git \ + r \ + highlight || (red Error installing devel packages. Check your internet connection and pacman keyring.) + + pacman --noconfirm --needed -S fzf || (red Error with peripheral programs.) cat << "EOF" @@ -234,12 +314,12 @@ cat << "EOF" || || EOF -curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/sudoers_tmp > /etc/sudoers +curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/src/sudoers_tmp > /etc/sudoers cd /tmp blue Changing working directory to /tmp/... blue Downloading next portion of the script \(larbs_user.sh\)... -curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/larbs_user.sh > /tmp/larbs_user.sh && blue Running larbs_user.sh script as $NAME... +curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/src/larbs_user.sh > /tmp/larbs_user.sh && blue Running larbs_user.sh script as $NAME... sudo -u $NAME bash /tmp/larbs_user.sh || red Error when running larbs_user.sh... rm -f /tmp/larbs_user.sh @@ -262,7 +342,7 @@ rmmod pcspkr echo "blacklist pcspkr" > /etc/modprobe.d/nobeep.conf blue Implementing temporary sudoers file... -curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/sudoers > /etc/sudoers +curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/src/sudoers > /etc/sudoers dialog --title "All done!" --msgbox "Congrats! Provided there were no hidden errors, the script completed successfully and all the programs and configuration files should be in place.\n\nTo run the new graphical environment, log out and log back in as your new user, then run the command \"startx\" to start the graphical environment.\n\n-Luke" 12 80 clear diff --git a/larbs_user.sh b/src/larbs_user.sh similarity index 100% rename from larbs_user.sh rename to src/larbs_user.sh diff --git a/larbs_userp.sh b/src/larbs_userp.sh similarity index 100% rename from larbs_userp.sh rename to src/larbs_userp.sh diff --git a/larbsp.sh b/src/larbsp.sh similarity index 99% rename from larbsp.sh rename to src/larbsp.sh index eaa5c25..83aa2c7 100755 --- a/larbsp.sh +++ b/src/larbsp.sh @@ -234,12 +234,12 @@ cat << "EOF" || || EOF -curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/sudoers_tmp > /etc/sudoers +curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/src/sudoers_tmp > /etc/sudoers cd /tmp blue Changing working directory to /tmp/... blue Downloading next portion of the script \(larbs_userp.sh\)... -curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/larbs_userp.sh > /tmp/larbs_userp.sh && blue Running larbs_userp.sh script as $NAME... +curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/src/larbs_userp.sh > /tmp/larbs_userp.sh && blue Running larbs_userp.sh script as $NAME... sudo -u $NAME bash /tmp/larbs_userp.sh || red Error when running larbs_userp.sh... rm -f /tmp/larbs_userp.sh @@ -262,7 +262,7 @@ rmmod pcspkr echo "blacklist pcspkr" > /etc/modprobe.d/nobeep.conf blue Implementing temporary sudoers file... -curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/sudoers > /etc/sudoers +curl https://raw.githubusercontent.com/LukeSmithxyz/larbs/master/src/sudoers > /etc/sudoers dialog --title "All done!" --msgbox "Congrats! Provided there were no hidden errors, the script completed successfully and all the programs and configuration files should be in place.\n\nTo run the new graphical environment, log out and log back in as your new user, then run the command \"startx\" to start the graphical environment.\n\n-Luke" 12 80 clear diff --git a/sudoers b/src/sudoers similarity index 100% rename from sudoers rename to src/sudoers diff --git a/sudoers_tmp b/src/sudoers_tmp similarity index 100% rename from sudoers_tmp rename to src/sudoers_tmp diff --git a/test.sh b/src/test.sh similarity index 100% rename from test.sh rename to src/test.sh diff --git a/index.html b/www/index.html similarity index 100% rename from index.html rename to www/index.html diff --git a/pix/arch.jpg b/www/pix/arch.jpg similarity index 100% rename from pix/arch.jpg rename to www/pix/arch.jpg diff --git a/pix/arch.png b/www/pix/arch.png similarity index 100% rename from pix/arch.png rename to www/pix/arch.png diff --git a/pix/autism.jpg b/www/pix/autism.jpg similarity index 100% rename from pix/autism.jpg rename to www/pix/autism.jpg diff --git a/pix/big_brane.jpg b/www/pix/big_brane.jpg similarity index 100% rename from pix/big_brane.jpg rename to www/pix/big_brane.jpg diff --git a/pix/brainlet.jpg b/www/pix/brainlet.jpg similarity index 100% rename from pix/brainlet.jpg rename to www/pix/brainlet.jpg diff --git a/pix/faveicon.ico b/www/pix/faveicon.ico similarity index 100% rename from pix/faveicon.ico rename to www/pix/faveicon.ico diff --git a/pix/gnu-linux.jpg b/www/pix/gnu-linux.jpg similarity index 100% rename from pix/gnu-linux.jpg rename to www/pix/gnu-linux.jpg diff --git a/pix/i3.jpg b/www/pix/i3.jpg similarity index 100% rename from pix/i3.jpg rename to www/pix/i3.jpg diff --git a/pix/larbs.jpg b/www/pix/larbs.jpg similarity index 100% rename from pix/larbs.jpg rename to www/pix/larbs.jpg diff --git a/pix/vim.jpg b/www/pix/vim.jpg similarity index 100% rename from pix/vim.jpg rename to www/pix/vim.jpg diff --git a/previews.html b/www/previews.html similarity index 100% rename from previews.html rename to www/previews.html diff --git a/previews/asian.png b/www/previews/asian.png similarity index 100% rename from previews/asian.png rename to www/previews/asian.png diff --git a/previews/asian.png.jpg b/www/previews/asian.png.jpg similarity index 100% rename from previews/asian.png.jpg rename to www/previews/asian.png.jpg diff --git a/previews/bow.png b/www/previews/bow.png similarity index 100% rename from previews/bow.png rename to www/previews/bow.png diff --git a/previews/bow.png.jpg b/www/previews/bow.png.jpg similarity index 100% rename from previews/bow.png.jpg rename to www/previews/bow.png.jpg diff --git a/previews/larbs.png b/www/previews/larbs.png similarity index 100% rename from previews/larbs.png rename to www/previews/larbs.png diff --git a/previews/larbs.png.jpg b/www/previews/larbs.png.jpg similarity index 100% rename from previews/larbs.png.jpg rename to www/previews/larbs.png.jpg diff --git a/previews/varg.png b/www/previews/varg.png similarity index 100% rename from previews/varg.png rename to www/previews/varg.png diff --git a/previews/varg.png.jpg b/www/previews/varg.png.jpg similarity index 100% rename from previews/varg.png.jpg rename to www/previews/varg.png.jpg diff --git a/programs.html b/www/programs.html similarity index 100% rename from programs.html rename to www/programs.html diff --git a/style.css b/www/styles.css similarity index 100% rename from style.css rename to www/styles.css